feat: stream/generate audio mode toggle

Add a user-selectable playback mode stored in user_settings:
- 'stream' (default): /api/audio-stream starts playing within seconds,
  saves to MinIO concurrently — low latency
- 'generate': queue runner task, poll until full audio is ready in
  MinIO, then play via presigned URL — legacy behaviour

UI toggles in two places:
- AudioPlayer idle pill: compact '· Stream / · Generate' inline next
  to voice name and estimated duration
- ListeningMode controls row: pill alongside Auto, Announce, Sleep;
  disabled and grayed out for CF AI voices (batch-only, no streaming)

startPlayback() now branches on audioStore.audioMode for non-CF AI
voices; generate mode uses the same runner task + progress bar flow
as CF AI but without the preview clip.

PocketBase: audio_mode text field added to user_settings on
pb.libnovel.cc (live) and in pb-init-v3.sh (create block +
add_field migration line).

.gitea/workflows/ci.yaml

@@ -63,6 +63,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Check Paraglide codegen is up to date
+        run: npm run paraglide && git diff --exit-code src/lib/paraglide/
+
       - name: Type check
         run: npm run check
 

.gitea/workflows/release.yaml

@@ -62,24 +62,115 @@ jobs:
           path: ui/build
           retention-days: 1
 
-  # ── docker: backend ───────────────────────────────────────────────────────────
-  docker-backend:
-    name: Docker / backend
+  # ── ui: source map upload ─────────────────────────────────────────────────────
+  # Commented out — re-enable when GlitchTip source map uploads are needed again.
+  #
+  # upload-sourcemaps:
+  #   name: Upload source maps
+  #   runs-on: ubuntu-latest
+  #   needs: [check-ui]
+  #   steps:
+  #     - name: Compute release version (strip leading v)
+  #       id: ver
+  #       run: |
+  #         V="${{ gitea.ref_name }}"
+  #         echo "version=${V#v}" >> "$GITHUB_OUTPUT"
+  #
+  #     - name: Download build artifacts
+  #       uses: actions/download-artifact@v3
+  #       with:
+  #         name: ui-build
+  #         path: build
+  #
+  #     - name: Install sentry-cli
+  #       run: npm install -g @sentry/cli
+  #
+  #     - name: Inject debug IDs into build artifacts
+  #       run: sentry-cli sourcemaps inject ./build
+  #       env:
+  #         SENTRY_URL: https://errors.libnovel.cc/
+  #         SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
+  #         SENTRY_ORG: libnovel
+  #         SENTRY_PROJECT: ui
+  #
+  #     - name: Upload injected build (for docker-ui)
+  #       uses: actions/upload-artifact@v3
+  #       with:
+  #         name: ui-build-injected
+  #         path: build
+  #         retention-days: 1
+  #
+  #     - name: Create GlitchTip release
+  #       run: sentry-cli releases new ${{ steps.ver.outputs.version }}
+  #       env:
+  #         SENTRY_URL: https://errors.libnovel.cc/
+  #         SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
+  #         SENTRY_ORG: libnovel
+  #         SENTRY_PROJECT: ui
+  #
+  #     - name: Upload source maps to GlitchTip
+  #       run: sentry-cli sourcemaps upload ./build --release ${{ steps.ver.outputs.version }}
+  #       env:
+  #         SENTRY_URL: https://errors.libnovel.cc/
+  #         SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
+  #         SENTRY_ORG: libnovel
+  #         SENTRY_PROJECT: ui
+  #
+  #     - name: Finalize GlitchTip release
+  #       run: sentry-cli releases finalize ${{ steps.ver.outputs.version }}
+  #       env:
+  #         SENTRY_URL: https://errors.libnovel.cc/
+  #         SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
+  #         SENTRY_ORG: libnovel
+  #         SENTRY_PROJECT: ui
+  #
+  #     - name: Prune old GlitchTip releases (keep latest 10)
+  #       run: |
+  #         set -euo pipefail
+  #         KEEP=10
+  #         OLD=$(curl -sf \
+  #           -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
+  #           "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/releases/?project=$SENTRY_PROJECT&per_page=100" \
+  #           | python3 -c "
+  #         import sys, json
+  #         releases = json.load(sys.stdin)
+  #         for r in releases[$KEEP:]:
+  #             print(r['version'])
+  #         " KEEP=$KEEP)
+  #         for ver in $OLD; do
+  #           echo "Deleting old release: $ver"
+  #           sentry-cli releases delete "$ver" || true
+  #         done
+  #       env:
+  #         SENTRY_URL: https://errors.libnovel.cc
+  #         SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
+  #         SENTRY_ORG: libnovel
+  #         SENTRY_PROJECT: ui
+
+  # ── docker: all images in one job (single login) ──────────────────────────────
+  # backend, runner, ui, and caddy are built sequentially in one job so Docker
+  # Hub only needs to be authenticated once. This also eliminates 3 redundant
+  # checkout + setup-buildx + scheduler round-trips compared to separate jobs.
+  docker:
+    name: Docker
     runs-on: ubuntu-latest
-    needs: [test-backend]
+    needs: [test-backend, check-ui]
     steps:
       - uses: actions/checkout@v4
 
       - uses: docker/setup-buildx-action@v3
 
+      # Single login — credential is written to ~/.docker/config.json and
+      # reused by all subsequent build-push-action steps in this job.
       - name: Log in to Docker Hub
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USER }}
           password: ${{ secrets.DOCKER_TOKEN }}
 
-      - name: Docker meta
-        id: meta
+      # ── backend ──────────────────────────────────────────────────────────────
+      - name: Docker meta / backend
+        id: meta-backend
         uses: docker/metadata-action@v5
         with:
           images: ${{ secrets.DOCKER_USER }}/libnovel-backend
@@ -88,38 +179,23 @@ jobs:
             type=semver,pattern={{major}}.{{minor}}
             type=raw,value=latest
 
-      - name: Build and push
+      - name: Build and push / backend
         uses: docker/build-push-action@v6
         with:
           context: backend
           target: backend
           push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+          tags: ${{ steps.meta-backend.outputs.tags }}
+          labels: ${{ steps.meta-backend.outputs.labels }}
           build-args: |
-            VERSION=${{ steps.meta.outputs.version }}
+            VERSION=${{ steps.meta-backend.outputs.version }}
             COMMIT=${{ gitea.sha }}
           cache-from: type=registry,ref=${{ secrets.DOCKER_USER }}/libnovel-backend:latest
           cache-to: type=inline
 
-  # ── docker: runner ────────────────────────────────────────────────────────────
-  docker-runner:
-    name: Docker / runner
-    runs-on: ubuntu-latest
-    needs: [test-backend]
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKER_USER }}
-          password: ${{ secrets.DOCKER_TOKEN }}
-
-      - name: Docker meta
-        id: meta
+      # ── runner ───────────────────────────────────────────────────────────────
+      - name: Docker meta / runner
+        id: meta-runner
         uses: docker/metadata-action@v5
         with:
           images: ${{ secrets.DOCKER_USER }}/libnovel-runner
@@ -128,115 +204,25 @@ jobs:
             type=semver,pattern={{major}}.{{minor}}
             type=raw,value=latest
 
-      - name: Build and push
+      - name: Build and push / runner
         uses: docker/build-push-action@v6
         with:
           context: backend
           target: runner
           push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+          tags: ${{ steps.meta-runner.outputs.tags }}
+          labels: ${{ steps.meta-runner.outputs.labels }}
           build-args: |
-            VERSION=${{ steps.meta.outputs.version }}
+            VERSION=${{ steps.meta-runner.outputs.version }}
             COMMIT=${{ gitea.sha }}
           cache-from: type=registry,ref=${{ secrets.DOCKER_USER }}/libnovel-runner:latest
           cache-to: type=inline
 
-  # ── ui: source map upload ─────────────────────────────────────────────────────
-  upload-sourcemaps:
-    name: Upload source maps
-    runs-on: ubuntu-latest
-    needs: [check-ui]
-    steps:
-      - name: Compute release version (strip leading v)
-        id: ver
-        run: |
-          V="${{ gitea.ref_name }}"
-          echo "version=${V#v}" >> "$GITHUB_OUTPUT"
-
-      - name: Download build artifacts
+      # ── ui ───────────────────────────────────────────────────────────────────
+      - name: Download ui build artifacts
         uses: actions/download-artifact@v3
         with:
           name: ui-build
-          path: build
-
-      - name: Install sentry-cli
-        run: npm install -g @sentry/cli
-
-      - name: Inject debug IDs into build artifacts
-        run: sentry-cli sourcemaps inject ./build
-        env:
-          SENTRY_URL: https://errors.libnovel.cc/
-          SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
-          SENTRY_ORG: libnovel
-          SENTRY_PROJECT: ui
-
-      - name: Upload injected build (for docker-ui)
-        uses: actions/upload-artifact@v3
-        with:
-          name: ui-build-injected
-          path: build
-          retention-days: 1
-
-      - name: Create GlitchTip release
-        run: sentry-cli releases new ${{ steps.ver.outputs.version }}
-        env:
-          SENTRY_URL: https://errors.libnovel.cc/
-          SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
-          SENTRY_ORG: libnovel
-          SENTRY_PROJECT: ui
-
-      - name: Upload source maps to GlitchTip
-        run: sentry-cli sourcemaps upload ./build --release ${{ steps.ver.outputs.version }}
-        env:
-          SENTRY_URL: https://errors.libnovel.cc/
-          SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
-          SENTRY_ORG: libnovel
-          SENTRY_PROJECT: ui
-
-      - name: Finalize GlitchTip release
-        run: sentry-cli releases finalize ${{ steps.ver.outputs.version }}
-        env:
-          SENTRY_URL: https://errors.libnovel.cc/
-          SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
-          SENTRY_ORG: libnovel
-          SENTRY_PROJECT: ui
-
-      - name: Prune old GlitchTip releases (keep latest 10)
-        run: |
-          set -euo pipefail
-          KEEP=10
-          OLD=$(curl -sf \
-            -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
-            "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/releases/?project=$SENTRY_PROJECT&per_page=100" \
-            | python3 -c "
-          import sys, json
-          releases = json.load(sys.stdin)
-          for r in releases[$KEEP:]:
-              print(r['version'])
-          " KEEP=$KEEP)
-          for ver in $OLD; do
-            echo "Deleting old release: $ver"
-            sentry-cli releases delete "$ver" || true
-          done
-        env:
-          SENTRY_URL: https://errors.libnovel.cc
-          SENTRY_AUTH_TOKEN: ${{ secrets.GLITCHTIP_AUTH_TOKEN }}
-          SENTRY_ORG: libnovel
-          SENTRY_PROJECT: ui
-
-  # ── docker: ui ────────────────────────────────────────────────────────────────
-  docker-ui:
-    name: Docker / ui
-    runs-on: ubuntu-latest
-    needs: [check-ui, upload-sourcemaps]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Download injected build (debug IDs already embedded)
-        uses: actions/download-artifact@v3
-        with:
-          name: ui-build-injected
           path: ui/build
 
       - name: Allow build/ into Docker context (override .dockerignore)
@@ -244,16 +230,8 @@ jobs:
           grep -v '^build$' ui/.dockerignore > ui/.dockerignore.tmp
           mv ui/.dockerignore.tmp ui/.dockerignore
 
-      - uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKER_USER }}
-          password: ${{ secrets.DOCKER_TOKEN }}
-
-      - name: Docker meta
-        id: meta
+      - name: Docker meta / ui
+        id: meta-ui
         uses: docker/metadata-action@v5
         with:
           images: ${{ secrets.DOCKER_USER }}/libnovel-ui
@@ -262,38 +240,24 @@ jobs:
             type=semver,pattern={{major}}.{{minor}}
             type=raw,value=latest
 
-      - name: Build and push
+      - name: Build and push / ui
         uses: docker/build-push-action@v6
         with:
           context: ui
           push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+          tags: ${{ steps.meta-ui.outputs.tags }}
+          labels: ${{ steps.meta-ui.outputs.labels }}
           build-args: |
-            BUILD_VERSION=${{ steps.meta.outputs.version }}
+            BUILD_VERSION=${{ steps.meta-ui.outputs.version }}
             BUILD_COMMIT=${{ gitea.sha }}
             BUILD_TIME=${{ gitea.event.head_commit.timestamp }}
             PREBUILT=1
           cache-from: type=registry,ref=${{ secrets.DOCKER_USER }}/libnovel-ui:latest
           cache-to: type=inline
 
-  # ── docker: caddy ─────────────────────────────────────────────────────────────
-  docker-caddy:
-    name: Docker / caddy
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKER_USER }}
-          password: ${{ secrets.DOCKER_TOKEN }}
-
-      - name: Docker meta
-        id: meta
+      # ── caddy ────────────────────────────────────────────────────────────────
+      - name: Docker meta / caddy
+        id: meta-caddy
         uses: docker/metadata-action@v5
         with:
           images: ${{ secrets.DOCKER_USER }}/libnovel-caddy
@@ -302,13 +266,13 @@ jobs:
             type=semver,pattern={{major}}.{{minor}}
             type=raw,value=latest
 
-      - name: Build and push
+      - name: Build and push / caddy
         uses: docker/build-push-action@v6
         with:
           context: caddy
           push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+          tags: ${{ steps.meta-caddy.outputs.tags }}
+          labels: ${{ steps.meta-caddy.outputs.labels }}
           cache-from: type=registry,ref=${{ secrets.DOCKER_USER }}/libnovel-caddy:latest
           cache-to: type=inline
 
@@ -316,7 +280,7 @@ jobs:
   release:
     name: Gitea Release
     runs-on: ubuntu-latest
-    needs: [docker-backend, docker-runner, docker-ui, docker-caddy, upload-sourcemaps]
+    needs: [docker]
     steps:
       - uses: actions/checkout@v4
         with:

AGENTS.md

@@ -47,11 +47,21 @@ Sub-directories have their own `AGENTS.md` with deeper context (e.g. `ios/AGENTS
   - `release.yaml` — runs on `v*` tags (build Docker images, upload source maps, create Gitea release)
 - Secrets: `DOCKER_USER`, `DOCKER_TOKEN`, `GITEA_TOKEN`, `GLITCHTIP_AUTH_TOKEN`
 
+### Git credentials
+
+Credentials are embedded in the remote URL — no `HOME=/root` or credential helper needed for push:
+
+```
+https://kamil:95782641Apple%24@gitea.kalekber.cc/kamil/libnovel.git
+```
+
+All git commands still use `HOME=/root` prefix for consistency (picks up `/root/.gitconfig` for user name/email), but push auth works without it.
+
 ### Releasing a new version
 
 ```bash
-git tag v2.5.X -m "Short title\n\nOptional longer body"
-git push origin v2.5.X
+HOME=/root git tag v2.6.X -m "Short title"
+HOME=/root git push origin v3-cleanup --tags
 ```
 
 CI will build all Docker images, upload source maps to GlitchTip, and create a Gitea release automatically.
@@ -109,6 +119,7 @@ doppler run --project libnovel --config prd_homelab -- docker compose -f homelab
 
 - Prod runner has `profiles: [runner]` — `docker compose up -d` will NOT accidentally start it
 - When deploying, always sync `docker-compose.yml` to the server before running `up -d`
+- **Caddyfile is NOT in git** — lives at `/opt/libnovel/Caddyfile` on prod server only. Edit directly on the server and restart the `caddy` container.
 
 ---
 
@@ -117,11 +128,43 @@ doppler run --project libnovel --config prd_homelab -- docker compose -f homelab
 | Tool | Purpose |
 |---|---|
 | GlitchTip | Error tracking (UI + backend + runner) |
-| Grafana Faro | RUM / Web Vitals (collector at `faro.libnovel.cc/collect`) |
-| OpenTelemetry | Distributed tracing (OTLP → collector → Tempo) |
-| Grafana | Dashboards at `/admin/grafana` |
+| Grafana Faro | RUM / Web Vitals (collector at `faro.libnovel.cc/collect`) → Alloy (port 12347) |
+| OpenTelemetry | Distributed tracing (OTLP → cloudflared → OTel collector → Tempo) |
+| Grafana | Dashboards at `https://grafana.libnovel.cc` |
 
-Grafana dashboards: `homelab/otel/grafana/provisioning/dashboards/`
+### Grafana dashboards: `homelab/otel/grafana/provisioning/dashboards/`
+
+Key dashboards:
+- `backend.json` — Backend logs (Loki: `{service_name="backend"}`, plain text)
+- `runner.json` — Runner logs (Loki: `{service_name="runner"}`) + Asynq Prometheus metrics
+- `web-vitals.json` — Web Vitals (Loki: `{service_name="unknown_service"} kind=measurement` + pattern parser)
+- `catalogue.json` — Scrape progress (Loki: `{service_name="runner"} | json | body="..."`)
+
+### Data pipeline (2026-04-07 working state)
+
+**Browser → Grafana Faro:**
+Browser sends RUM data → `https://faro.libnovel.cc/collect` → **Alloy** `faro.receiver` (port 12347) → Loki (logs/exceptions) + OTel collector → **Tempo** (traces)
+
+**Backend/Runner → OTel:**
+Backend/Runner Go SDK → `https://otel.libnovel.cc` (cloudflared tunnel) → **OTel collector** (port 4318) → Tempo (traces) + Loki (logs via `otlphttp/loki` exporter)
+Runner also sends to **Alloy** `otelcol.receiver.otlp` (port 4318) → `otelcol.exporter.loki` → Loki
+
+### Loki log format per service
+
+- `service_name="backend"`: Plain text (e.g. `backend: asynq task dispatch enabled`)
+- `service_name="runner"`: JSON with `body`, `attributes{slug,chapters,page}`, `severity`
+- `service_name="unknown_service"`: Faro RUM text format (e.g. `kind=measurement lcp=5428.0 ...`)
+
+### OTel Collector ports (homelab)
+
+- gRPC: `4317` — receives from cloudflared (`otel.libnovel.cc`)
+- HTTP: `4318` — receives from cloudflared + Alloy
+- Metrics: `8888`
+
+### Known issues / pending fixes
+
+- Web Vitals use `service_name="unknown_service"` (Faro SDK doesn't set service.name in browser) — works with `unknown_service` label
+- Runner logs go to both Alloy→Loki AND OTel collector→Loki (dual pipeline — intentional for resilience)
 
 ---
 

backend/cmd/backend/main.go

@@ -179,24 +179,27 @@ func run() error {
 			Commit:       commit,
 		},
 		backend.Dependencies{
-			BookReader:       store,
-			RankingStore:     store,
-			AudioStore:       store,
-			TranslationStore: store,
-			PresignStore:     store,
-			ProgressStore:    store,
-			CoverStore:       store,
-			Producer:         producer,
-			TaskReader:       store,
-			SearchIndex:      searchIndex,
-			Kokoro:           kokoroClient,
-			PocketTTS:        pocketTTSClient,
-			CFAI:             cfaiClient,
-			ImageGen:         imageGenClient,
-			TextGen:          textGenClient,
-			BookWriter:       store,
-			AIJobStore:       store,
-			Log:              log,
+			BookReader:        store,
+			RankingStore:      store,
+			AudioStore:        store,
+			TranslationStore:  store,
+			PresignStore:      store,
+			ProgressStore:     store,
+			CoverStore:        store,
+			ChapterImageStore: store,
+			Producer:          producer,
+			TaskReader:        store,
+			ImportFileStore:   store,
+			SearchIndex:       searchIndex,
+			Kokoro:            kokoroClient,
+			PocketTTS:         pocketTTSClient,
+			CFAI:              cfaiClient,
+			ImageGen:          imageGenClient,
+			TextGen:           textGenClient,
+			BookWriter:        store,
+			AIJobStore:        store,
+			BookAdminStore:    store,
+			Log:               log,
 		},
 	)
 

backend/cmd/runner/main.go

@@ -192,18 +192,22 @@ func run() error {
 
 	deps := runner.Dependencies{
 		Consumer:         consumer,
-		BookWriter:       store,
-		BookReader:       store,
-		AudioStore:       store,
-		CoverStore:       store,
-		TranslationStore: store,
-		SearchIndex:      searchIndex,
-		Novel:            novel,
-		Kokoro:           kokoroClient,
-		PocketTTS:        pocketTTSClient,
-		CFAI:             cfaiClient,
-		LibreTranslate:   ltClient,
-		Log:              log,
+		BookWriter:         store,
+		BookReader:         store,
+		AudioStore:         store,
+		CoverStore:         store,
+		TranslationStore:   store,
+		BookImport:         storage.NewBookImporter(store),
+		ImportChapterStore: store,
+		ChapterIngester:    store,
+		SearchIndex:        searchIndex,
+		Novel:              novel,
+		Kokoro:             kokoroClient,
+		PocketTTS:          pocketTTSClient,
+		CFAI:               cfaiClient,
+		LibreTranslate:     ltClient,
+		Notifier:           store,
+		Log:                log,
 	}
 	r := runner.New(rCfg, deps)
 

backend/go.mod

@@ -3,7 +3,23 @@ module github.com/libnovel/backend
 go 1.26.1
 
 require (
+	github.com/getsentry/sentry-go v0.43.0
+	github.com/hibiken/asynq v0.26.0
+	github.com/hibiken/asynq/x v0.0.0-20260203063626-d704b68a426d
+	github.com/meilisearch/meilisearch-go v0.36.1
 	github.com/minio/minio-go/v7 v7.0.98
+	github.com/pdfcpu/pdfcpu v0.11.1
+	github.com/prometheus/client_golang v1.23.2
+	github.com/redis/go-redis/v9 v9.18.0
+	github.com/yuin/goldmark v1.8.2
+	go.opentelemetry.io/contrib/bridges/otelslog v0.17.0
+	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0
+	go.opentelemetry.io/otel v1.42.0
+	go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp v0.18.0
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.42.0
+	go.opentelemetry.io/otel/log v0.18.0
+	go.opentelemetry.io/otel/sdk v1.42.0
+	go.opentelemetry.io/otel/sdk/log v0.18.0
 	golang.org/x/net v0.51.0
 )
 
@@ -12,55 +28,45 @@ require (
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/cenkalti/backoff/v5 v5.0.3 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
-	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/clipperhouse/uax29/v2 v2.2.0 // indirect
 	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/felixge/httpsnoop v1.0.4 // indirect
-	github.com/getsentry/sentry-go v0.43.0 // indirect
 	github.com/go-ini/ini v1.67.0 // indirect
 	github.com/go-logr/logr v1.4.3 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0 // indirect
-	github.com/hibiken/asynq v0.26.0 // indirect
-	github.com/hibiken/asynq/x v0.0.0-20260203063626-d704b68a426d // indirect
+	github.com/hhrutter/lzw v1.0.0 // indirect
+	github.com/hhrutter/pkcs7 v0.2.0 // indirect
+	github.com/hhrutter/tiff v1.0.2 // indirect
 	github.com/klauspost/compress v1.18.2 // indirect
 	github.com/klauspost/cpuid/v2 v2.2.11 // indirect
 	github.com/klauspost/crc32 v1.3.0 // indirect
-	github.com/meilisearch/meilisearch-go v0.36.1 // indirect
+	github.com/mattn/go-runewidth v0.0.19 // indirect
 	github.com/minio/crc64nvme v1.1.1 // indirect
 	github.com/minio/md5-simd v1.1.2 // indirect
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
 	github.com/philhofer/fwd v1.2.0 // indirect
-	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/prometheus/client_golang v1.23.2 // indirect
+	github.com/pkg/errors v0.9.1 // indirect
 	github.com/prometheus/client_model v0.6.2 // indirect
 	github.com/prometheus/common v0.66.1 // indirect
 	github.com/prometheus/procfs v0.16.1 // indirect
-	github.com/redis/go-redis/v9 v9.18.0 // indirect
 	github.com/robfig/cron/v3 v3.0.1 // indirect
 	github.com/rs/xid v1.6.0 // indirect
 	github.com/spf13/cast v1.10.0 // indirect
 	github.com/tinylib/msgp v1.6.1 // indirect
-	github.com/yuin/goldmark v1.8.2 // indirect
 	go.opentelemetry.io/auto/sdk v1.2.1 // indirect
-	go.opentelemetry.io/contrib/bridges/otelslog v0.17.0 // indirect
-	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 // indirect
-	go.opentelemetry.io/otel v1.42.0 // indirect
-	go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp v0.18.0 // indirect
 	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.42.0 // indirect
-	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.42.0 // indirect
-	go.opentelemetry.io/otel/log v0.18.0 // indirect
 	go.opentelemetry.io/otel/metric v1.42.0 // indirect
-	go.opentelemetry.io/otel/sdk v1.42.0 // indirect
-	go.opentelemetry.io/otel/sdk/log v0.18.0 // indirect
 	go.opentelemetry.io/otel/trace v1.42.0 // indirect
 	go.opentelemetry.io/proto/otlp v1.9.0 // indirect
 	go.uber.org/atomic v1.11.0 // indirect
 	go.yaml.in/yaml/v2 v2.4.2 // indirect
 	go.yaml.in/yaml/v3 v3.0.4 // indirect
 	golang.org/x/crypto v0.48.0 // indirect
+	golang.org/x/image v0.32.0 // indirect
 	golang.org/x/sys v0.41.0 // indirect
 	golang.org/x/text v0.34.0 // indirect
 	golang.org/x/time v0.14.0 // indirect
@@ -68,5 +74,5 @@ require (
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20260209200024-4cfbd4190f57 // indirect
 	google.golang.org/grpc v1.79.2 // indirect
 	google.golang.org/protobuf v1.36.11 // indirect
-	gopkg.in/yaml.v3 v3.0.1 // indirect
+	gopkg.in/yaml.v2 v2.4.0 // indirect
 )

backend/go.sum

@@ -2,10 +2,16 @@ github.com/andybalholm/brotli v1.1.1 h1:PR2pgnyFznKEugtsUo0xLdDop5SKXd5Qf5ysW+7X
 github.com/andybalholm/brotli v1.1.1/go.mod h1:05ib4cKhjx3OQYUY22hTVd34Bc8upXjOLL2rKwwZBoA=
 github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
 github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
+github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
+github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
+github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
+github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
 github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM=
 github.com/cenkalti/backoff/v5 v5.0.3/go.mod h1:rkhZdG3JZukswDf7f0cwqPNk4K0sa+F97BxZthm/crw=
 github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
 github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/clipperhouse/uax29/v2 v2.2.0 h1:ChwIKnQN3kcZteTXMgb1wztSgaU+ZemkgWdohwgs8tY=
+github.com/clipperhouse/uax29/v2 v2.2.0/go.mod h1:EFJ2TJMRUaplDxHKj1qAEhCtQPW2tJSwu5BF98AuoVM=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
@@ -14,8 +20,12 @@ github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkp
 github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
 github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=
 github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U=
+github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
+github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
 github.com/getsentry/sentry-go v0.43.0 h1:XbXLpFicpo8HmBDaInk7dum18G9KSLcjZiyUKS+hLW4=
 github.com/getsentry/sentry-go v0.43.0/go.mod h1:XDotiNZbgf5U8bPDUAfvcFmOnMQQceESxyKaObSssW0=
+github.com/go-errors/errors v1.4.2 h1:J6MZopCL4uSllY1OfXM374weqZFFItUbrImctkmUxIA=
+github.com/go-errors/errors v1.4.2/go.mod h1:sIVyrIiJhuEF+Pj9Ebtd6P/rEYROXFi3BopGUQ5a5Og=
 github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A=
 github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8=
 github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
@@ -25,10 +35,20 @@ github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
 github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
 github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
 github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0 h1:HWRh5R2+9EifMyIHV7ZV+MIZqgz+PMpZ14Jynv3O2Zs=
 github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0/go.mod h1:JfhWUomR1baixubs02l85lZYYOm7LV6om4ceouMv45c=
+github.com/hhrutter/lzw v1.0.0 h1:laL89Llp86W3rRs83LvKbwYRx6INE8gDn0XNb1oXtm0=
+github.com/hhrutter/lzw v1.0.0/go.mod h1:2HC6DJSn/n6iAZfgM3Pg+cP1KxeWc3ezG8bBqW5+WEo=
+github.com/hhrutter/pkcs7 v0.2.0 h1:i4HN2XMbGQpZRnKBLsUwO3dSckzgX142TNqY/KfXg+I=
+github.com/hhrutter/pkcs7 v0.2.0/go.mod h1:aEzKz0+ZAlz7YaEMY47jDHL14hVWD6iXt0AgqgAvWgE=
+github.com/hhrutter/tiff v1.0.2 h1:7H3FQQpKu/i5WaSChoD1nnJbGx4MxU5TlNqqpxw55z8=
+github.com/hhrutter/tiff v1.0.2/go.mod h1:pcOeuK5loFUE7Y/WnzGw20YxUdnqjY1P0Jlcieb/cCw=
 github.com/hibiken/asynq v0.26.0 h1:1Zxr92MlDnb1Zt/QR5g2vSCqUS03i95lUfqx5X7/wrw=
 github.com/hibiken/asynq v0.26.0/go.mod h1:Qk4e57bTnWDoyJ67VkchuV6VzSM9IQW2nPvAGuDyw58=
 github.com/hibiken/asynq/x v0.0.0-20260203063626-d704b68a426d h1:Ld5m8EIK5QVOq/owOexKIbETij3skACg4eU1pArHsrw=
@@ -40,6 +60,14 @@ github.com/klauspost/cpuid/v2 v2.2.11 h1:0OwqZRYI2rFrjS4kvkDnqJkKHdHaRnCm68/DY4O
 github.com/klauspost/cpuid/v2 v2.2.11/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
 github.com/klauspost/crc32 v1.3.0 h1:sSmTt3gUt81RP655XGZPElI0PelVTZ6YwCRnPSupoFM=
 github.com/klauspost/crc32 v1.3.0/go.mod h1:D7kQaZhnkX/Y0tstFGf8VUzv2UofNGqCjnC3zdHB0Hw=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc=
+github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
 github.com/meilisearch/meilisearch-go v0.36.1 h1:mJTCJE5g7tRvaqKco6DfqOuJEjX+rRltDEnkEC02Y0M=
 github.com/meilisearch/meilisearch-go v0.36.1/go.mod h1:hWcR0MuWLSzHfbz9GGzIr3s9rnXLm1jqkmHkJPbUSvM=
 github.com/minio/crc64nvme v1.1.1 h1:8dwx/Pz49suywbO+auHCBpCtlW1OfpcLN7wYgVR6wAI=
@@ -50,42 +78,44 @@ github.com/minio/minio-go/v7 v7.0.98 h1:MeAVKjLVz+XJ28zFcuYyImNSAh8Mq725uNW4beRi
 github.com/minio/minio-go/v7 v7.0.98/go.mod h1:cY0Y+W7yozf0mdIclrttzo1Iiu7mEf9y7nk2uXqMOvM=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
+github.com/pdfcpu/pdfcpu v0.11.1 h1:htHBSkGH5jMKWC6e0sihBFbcKZ8vG1M67c8/dJxhjas=
+github.com/pdfcpu/pdfcpu v0.11.1/go.mod h1:pP3aGga7pRvwFWAm9WwFvo+V68DfANi9kxSQYioNYcw=
 github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
 github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
+github.com/pingcap/errors v0.11.4 h1:lFuQV/oaUMGcD2tqt+01ROSmJs75VG1ToEOkZIZ4nE4=
+github.com/pingcap/errors v0.11.4/go.mod h1:Oi8TUi2kEtXXLMJk9l1cGmz20kV3TaQ0usTwv5KuLY8=
+github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/prometheus/client_golang v1.20.5 h1:cxppBPuYhUnsO6yo/aoRol4L7q7UFfdm+bR9r+8l63Y=
-github.com/prometheus/client_golang v1.20.5/go.mod h1:PIEt8X02hGcP8JWbeHyeZ53Y/jReSnHgO035n//V5WE=
 github.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o=
 github.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg=
-github.com/prometheus/client_model v0.6.1 h1:ZKSh/rekM+n3CeS952MLRAdFwIKqeY8b62p8ais2e9E=
-github.com/prometheus/client_model v0.6.1/go.mod h1:OrxVMOVHjw3lKMa8+x6HeMGkHMQyHDk9E3jmP2AmGiY=
 github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=
 github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE=
-github.com/prometheus/common v0.55.0 h1:KEi6DK7lXW/m7Ig5i47x0vRzuBsHuvJdi5ee6Y3G1dc=
-github.com/prometheus/common v0.55.0/go.mod h1:2SECS4xJG1kd8XF9IcM1gMX6510RAEL65zxzNImwdc8=
 github.com/prometheus/common v0.66.1 h1:h5E0h5/Y8niHc5DlaLlWLArTQI7tMrsfQjHV+d9ZoGs=
 github.com/prometheus/common v0.66.1/go.mod h1:gcaUsgf3KfRSwHY4dIMXLPV0K/Wg1oZ8+SbZk/HH/dA=
-github.com/prometheus/procfs v0.15.1 h1:YagwOFzUgYfKKHX6Dr+sHT7km/hxC76UB0learggepc=
-github.com/prometheus/procfs v0.15.1/go.mod h1:fB45yRUv8NstnjriLhBQLuOUt+WW4BsoGhij/e3PBqk=
 github.com/prometheus/procfs v0.16.1 h1:hZ15bTNuirocR6u0JZ6BAHHmwS1p8B4P6MRqxtzMyRg=
 github.com/prometheus/procfs v0.16.1/go.mod h1:teAbpZRB1iIAJYREa1LsoWUXykVXA1KlTmWl8x/U+Is=
 github.com/redis/go-redis/v9 v9.18.0 h1:pMkxYPkEbMPwRdenAzUNyFNrDgHx9U+DrBabWNfSRQs=
 github.com/redis/go-redis/v9 v9.18.0/go.mod h1:k3ufPphLU5YXwNTUcCRXGxUoF1fqxnhFQmscfkCoDA0=
 github.com/robfig/cron/v3 v3.0.1 h1:WdRxkvbJztn8LMz/QEvLN5sBU+xKpSqwwUO1Pjr4qDs=
 github.com/robfig/cron/v3 v3.0.1/go.mod h1:eQICP3HwyT7UooqI/z+Ov+PtYAWygg1TEWWzGIFLtro=
+github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
+github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
 github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU=
 github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
 github.com/spf13/cast v1.10.0 h1:h2x0u2shc1QuLHfxi+cTJvs30+ZAHOGRic8uyGTDWxY=
 github.com/spf13/cast v1.10.0/go.mod h1:jNfB8QC9IA6ZuY2ZjDp0KtFO2LZZlg4S/7bzP6qqeHo=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/tinylib/msgp v1.6.1 h1:ESRv8eL3u+DNHUoSAAQRE50Hm162zqAnBoGv9PzScPY=
 github.com/tinylib/msgp v1.6.1/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA=
+github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=
 github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=
 github.com/yuin/goldmark v1.8.2 h1:kEGpgqJXdgbkhcOgBxkC0X0PmoPG1ZyoZ117rDVp4zE=
 github.com/yuin/goldmark v1.8.2/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg=
+github.com/zeebo/xxh3 v1.0.2 h1:xZmwmqxHZA8AI603jOQ0tMqmBr9lPeFwGg6d+xy9DC0=
+github.com/zeebo/xxh3 v1.0.2/go.mod h1:5NWz9Sef7zIDm2JHfFlcQvNekmcEl9ekUZQQKCYaDcA=
 go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=
 go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
 go.opentelemetry.io/contrib/bridges/otelslog v0.17.0 h1:NFIS6x7wyObQ7cR84x7bt1sr8nYBx89s3x3GwRjw40k=
@@ -108,18 +138,26 @@ go.opentelemetry.io/otel/sdk v1.42.0 h1:LyC8+jqk6UJwdrI/8VydAq/hvkFKNHZVIWuslJXY
 go.opentelemetry.io/otel/sdk v1.42.0/go.mod h1:rGHCAxd9DAph0joO4W6OPwxjNTYWghRWmkHuGbayMts=
 go.opentelemetry.io/otel/sdk/log v0.18.0 h1:n8OyZr7t7otkeTnPTbDNom6rW16TBYGtvyy2Gk6buQw=
 go.opentelemetry.io/otel/sdk/log v0.18.0/go.mod h1:C0+wxkTwKpOCZLrlJ3pewPiiQwpzycPI/u6W0Z9fuYk=
+go.opentelemetry.io/otel/sdk/log/logtest v0.18.0 h1:l3mYuPsuBx6UKE47BVcPrZoZ0q/KER57vbj2qkgDLXA=
+go.opentelemetry.io/otel/sdk/log/logtest v0.18.0/go.mod h1:7cHtiVJpZebB3wybTa4NG+FUo5NPe3PROz1FqB0+qdw=
+go.opentelemetry.io/otel/sdk/metric v1.42.0 h1:D/1QR46Clz6ajyZ3G8SgNlTJKBdGp84q9RKCAZ3YGuA=
+go.opentelemetry.io/otel/sdk/metric v1.42.0/go.mod h1:Ua6AAlDKdZ7tdvaQKfSmnFTdHx37+J4ba8MwVCYM5hc=
 go.opentelemetry.io/otel/trace v1.42.0 h1:OUCgIPt+mzOnaUTpOQcBiM/PLQ/Op7oq6g4LenLmOYY=
 go.opentelemetry.io/otel/trace v1.42.0/go.mod h1:f3K9S+IFqnumBkKhRJMeaZeNk9epyhnCmQh/EysQCdc=
 go.opentelemetry.io/proto/otlp v1.9.0 h1:l706jCMITVouPOqEnii2fIAuO3IVGBRPV5ICjceRb/A=
 go.opentelemetry.io/proto/otlp v1.9.0/go.mod h1:xE+Cx5E/eEHw+ISFkwPLwCZefwVjY+pqKg1qcK03+/4=
 go.uber.org/atomic v1.11.0 h1:ZvwS0R+56ePWxUNi+Atn9dWONBPp/AUETXlHW0DxSjE=
 go.uber.org/atomic v1.11.0/go.mod h1:LUxbIzbOniOlMKjJjyPfpl4v+PKK2cNJn91OQbhoJI0=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.yaml.in/yaml/v2 v2.4.2 h1:DzmwEr2rDGHl7lsFgAHxmNz/1NlQ7xLIrlN2h5d1eGI=
 go.yaml.in/yaml/v2 v2.4.2/go.mod h1:081UH+NErpNdqlCXm3TtEran0rJZGxAYx9hb/ELlsPU=
 go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
 go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
 golang.org/x/crypto v0.48.0 h1:/VRzVqiRSggnhY7gNRxPauEQ5Drw9haKdM0jqfcCFts=
 golang.org/x/crypto v0.48.0/go.mod h1:r0kV5h3qnFPlQnBSrULhlsRfryS2pmewsg+XfMgkVos=
+golang.org/x/image v0.32.0 h1:6lZQWq75h7L5IWNk0r+SCpUJ6tUVd3v4ZHnbRKLkUDQ=
+golang.org/x/image v0.32.0/go.mod h1:/R37rrQmKXtO6tYXAjtDLwQgFLHmhW+V6ayXlxzP2Pc=
 golang.org/x/net v0.51.0 h1:94R/GTO7mt3/4wIKpcR5gkGmRLOuE/2hNGeWq/GBIFo=
 golang.org/x/net v0.51.0/go.mod h1:aamm+2QF5ogm02fjy5Bb7CQ0WMt1/WVM7FtyaTLlA9Y=
 golang.org/x/sys v0.41.0 h1:Ivj+2Cp/ylzLiEU89QhWblYnOE9zerudt9Ftecq2C6k=
@@ -128,6 +166,8 @@ golang.org/x/text v0.34.0 h1:oL/Qq0Kdaqxa1KbNeMKwQq0reLCCaFtqu2eNuSeNHbk=
 golang.org/x/text v0.34.0/go.mod h1:homfLqTYRFyVYemLBFl5GgL/DWEiH5wcsQ5gSh1yziA=
 golang.org/x/time v0.14.0 h1:MRx4UaLrDotUKUdCIqzPC48t1Y9hANFKIRpNx+Te8PI=
 golang.org/x/time v0.14.0/go.mod h1:eL/Oa2bBBK0TkX57Fyni+NgnyQQN4LitPmob2Hjnqw4=
+gonum.org/v1/gonum v0.16.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfk=
+gonum.org/v1/gonum v0.16.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E=
 google.golang.org/genproto/googleapis/api v0.0.0-20260209200024-4cfbd4190f57 h1:JLQynH/LBHfCTSbDWl+py8C+Rg/k1OVH3xfcaiANuF0=
 google.golang.org/genproto/googleapis/api v0.0.0-20260209200024-4cfbd4190f57/go.mod h1:kSJwQxqmFXeo79zOmbrALdflXQeAYcUbgS7PbpMknCY=
 google.golang.org/genproto/googleapis/rpc v0.0.0-20260209200024-4cfbd4190f57 h1:mWPCjDEyshlQYzBpMNHaEof6UX1PmHcaUODUywQ0uac=
@@ -136,8 +176,10 @@ google.golang.org/grpc v1.79.2 h1:fRMD94s2tITpyJGtBBn7MkMseNpOZU8ZxgC3MMBaXRU=
 google.golang.org/grpc v1.79.2/go.mod h1:KmT0Kjez+0dde/v2j9vzwoAScgEPx/Bw1CYChhHLrHQ=
 google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
 google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
+gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

backend/internal/asynqqueue/consumer.go

@@ -40,6 +40,10 @@ func (c *Consumer) FinishTranslationTask(ctx context.Context, id string, result
 	return c.pb.FinishTranslationTask(ctx, id, result)
 }
 
+func (c *Consumer) FinishImportTask(ctx context.Context, id string, result domain.ImportResult) error {
+	return c.pb.FinishImportTask(ctx, id, result)
+}
+
 func (c *Consumer) FailTask(ctx context.Context, id, errMsg string) error {
 	return c.pb.FailTask(ctx, id, errMsg)
 }
@@ -60,6 +64,12 @@ func (c *Consumer) ClaimNextTranslationTask(ctx context.Context, workerID string
 	return c.pb.ClaimNextTranslationTask(ctx, workerID)
 }
 
+// ClaimNextImportTask delegates to PocketBase because import tasks
+// are stored in PocketBase (not Redis/Asynq) and must still be polled directly.
+func (c *Consumer) ClaimNextImportTask(ctx context.Context, workerID string) (domain.ImportTask, bool, error) {
+	return c.pb.ClaimNextImportTask(ctx, workerID)
+}
+
 func (c *Consumer) HeartbeatTask(ctx context.Context, id string) error {
 	return c.pb.HeartbeatTask(ctx, id)
 }

backend/internal/asynqqueue/producer.go

@@ -7,6 +7,7 @@ import (
 	"log/slog"
 
 	"github.com/hibiken/asynq"
+	"github.com/libnovel/backend/internal/domain"
 	"github.com/libnovel/backend/internal/taskqueue"
 )
 
@@ -87,6 +88,30 @@ func (p *Producer) CreateTranslationTask(ctx context.Context, slug string, chapt
 	return p.pb.CreateTranslationTask(ctx, slug, chapter, lang)
 }
 
+// CreateImportTask creates a PocketBase record then enqueues an Asynq job for PDF/EPUB import.
+func (p *Producer) CreateImportTask(ctx context.Context, task domain.ImportTask) (string, error) {
+	id, err := p.pb.CreateImportTask(ctx, task)
+	if err != nil {
+		return "", err
+	}
+
+	payload := ImportPayload{
+		PBTaskID:    id,
+		Slug:        task.Slug,
+		Title:       task.Title,
+		FileType:    task.FileType,
+		ObjectKey:   task.ObjectKey,
+		ChaptersKey: task.ChaptersKey,
+	}
+	if err := p.enqueue(ctx, TypeImportBook, payload); err != nil {
+		// Non-fatal: PB record exists; runner will pick it up on next poll.
+		p.log.Warn("asynq enqueue import failed (task still in PB, runner will poll)",
+			"task_id", id, "err", err)
+		return id, nil
+	}
+	return id, nil
+}
+
 // CancelTask delegates to PocketBase; Asynq jobs may already be running and
 // cannot be reliably cancelled, so we only update the audit record.
 func (p *Producer) CancelTask(ctx context.Context, id string) error {

backend/internal/asynqqueue/tasks.go

@@ -23,6 +23,7 @@ const (
 	TypeAudioGenerate   = "audio:generate"
 	TypeScrapeBook      = "scrape:book"
 	TypeScrapeCatalogue = "scrape:catalogue"
+	TypeImportBook      = "import:book"
 )
 
 // AudioPayload is the Asynq job payload for audio generation tasks.
@@ -44,3 +45,13 @@ type ScrapePayload struct {
 	FromChapter int    `json:"from_chapter"` // 0 unless Kind=="book_range"
 	ToChapter   int    `json:"to_chapter"`   // 0 unless Kind=="book_range"
 }
+
+// ImportPayload is the Asynq job payload for PDF/EPUB import tasks.
+type ImportPayload struct {
+	PBTaskID    string `json:"pb_task_id"`
+	Slug        string `json:"slug"`
+	Title       string `json:"title"`
+	FileType    string `json:"file_type"`    // "pdf" or "epub"
+	ObjectKey   string `json:"object_key"`   // MinIO path to uploaded file
+	ChaptersKey string `json:"chapters_key"` // MinIO path to pre-parsed chapters JSON
+}

backend/internal/backend/handlers.go

@@ -9,6 +9,7 @@ package backend
 //   handleGetRanking, handleGetCover
 //   handleBookPreview, handleChapterText, handleChapterTextPreview, handleChapterMarkdown, handleReindex
 //   handleAudioGenerate, handleAudioStatus, handleAudioProxy, handleAudioStream
+//   handleTTSAnnounce
 //   handleVoices
 //   handlePresignChapter, handlePresignAudio, handlePresignVoiceSample
 //   handlePresignAvatarUpload, handlePresignAvatar
@@ -904,7 +905,119 @@ func (s *Server) handleAudioStream(w http.ResponseWriter, r *http.Request) {
 	// on its next poll as soon as the MinIO object is present.
 }
 
-// handleAudioPreview handles GET /api/audio-preview/{slug}/{n}.
+// handleTTSAnnounce handles GET /api/tts-announce.
+//
+// Streams a short TTS clip for arbitrary text — used by the UI to announce
+// the upcoming chapter number/title through the real <audio> element instead
+// of the Web Speech API (which is silently muted on mobile after the audio
+// session ends).
+//
+// Query params:
+//   - text  — the text to synthesize (required, max 300 chars)
+//   - voice — voice ID (defaults to server default)
+//   - format — "mp3" or "wav" (default "mp3")
+//
+// No MinIO caching — announcement clips are tiny and ephemeral.
+func (s *Server) handleTTSAnnounce(w http.ResponseWriter, r *http.Request) {
+	text := r.URL.Query().Get("text")
+	if text == "" {
+		jsonError(w, http.StatusBadRequest, "text is required")
+		return
+	}
+	if len(text) > 300 {
+		text = text[:300]
+	}
+
+	voice := r.URL.Query().Get("voice")
+	if voice == "" {
+		voice = s.cfg.DefaultVoice
+	}
+
+	format := r.URL.Query().Get("format")
+	if format != "wav" {
+		format = "mp3"
+	}
+
+	contentType := "audio/mpeg"
+	if format == "wav" {
+		contentType = "audio/wav"
+	}
+
+	var (
+		audioStream io.ReadCloser
+		err         error
+	)
+
+	if format == "wav" {
+		if cfai.IsCFAIVoice(voice) {
+			if s.deps.CFAI == nil {
+				jsonError(w, http.StatusServiceUnavailable, "cloudflare AI TTS not configured")
+				return
+			}
+			audioStream, err = s.deps.CFAI.StreamAudioWAV(r.Context(), text, voice)
+		} else if pockettts.IsPocketTTSVoice(voice) {
+			if s.deps.PocketTTS == nil {
+				jsonError(w, http.StatusServiceUnavailable, "pocket-tts not configured")
+				return
+			}
+			audioStream, err = s.deps.PocketTTS.StreamAudioWAV(r.Context(), text, voice)
+		} else {
+			if s.deps.Kokoro == nil {
+				jsonError(w, http.StatusServiceUnavailable, "kokoro not configured")
+				return
+			}
+			audioStream, err = s.deps.Kokoro.StreamAudioWAV(r.Context(), text, voice)
+		}
+	} else {
+		if cfai.IsCFAIVoice(voice) {
+			if s.deps.CFAI == nil {
+				jsonError(w, http.StatusServiceUnavailable, "cloudflare AI TTS not configured")
+				return
+			}
+			audioStream, err = s.deps.CFAI.StreamAudioMP3(r.Context(), text, voice)
+		} else if pockettts.IsPocketTTSVoice(voice) {
+			if s.deps.PocketTTS == nil {
+				jsonError(w, http.StatusServiceUnavailable, "pocket-tts not configured")
+				return
+			}
+			audioStream, err = s.deps.PocketTTS.StreamAudioMP3(r.Context(), text, voice)
+		} else {
+			if s.deps.Kokoro == nil {
+				jsonError(w, http.StatusServiceUnavailable, "kokoro not configured")
+				return
+			}
+			audioStream, err = s.deps.Kokoro.StreamAudioMP3(r.Context(), text, voice)
+		}
+	}
+	if err != nil {
+		s.deps.Log.Error("handleTTSAnnounce: TTS stream failed", "voice", voice, "err", err)
+		jsonError(w, http.StatusInternalServerError, "tts stream failed")
+		return
+	}
+	defer audioStream.Close()
+
+	w.Header().Set("Content-Type", contentType)
+	w.Header().Set("Cache-Control", "no-store")
+	w.Header().Set("X-Accel-Buffering", "no")
+	w.WriteHeader(http.StatusOK)
+
+	flusher, canFlush := w.(http.Flusher)
+	buf := make([]byte, 32*1024)
+	for {
+		nr, readErr := audioStream.Read(buf)
+		if nr > 0 {
+			if _, writeErr := w.Write(buf[:nr]); writeErr != nil {
+				return
+			}
+			if canFlush {
+				flusher.Flush()
+			}
+		}
+		if readErr != nil {
+			break
+		}
+	}
+}
 //
 // CF AI voices are batch-only and can take 1-2+ minutes to generate a full
 // chapter. This endpoint generates only the FIRST chunk of text (~1 800 chars,

backend/internal/backend/handlers_books_admin.go

@@ -0,0 +1,117 @@
+package backend
+
+import (
+	"errors"
+	"net/http"
+
+	"github.com/libnovel/backend/internal/storage"
+)
+
+// handleAdminArchiveBook handles PATCH /api/admin/books/{slug}/archive.
+// Soft-deletes a book by setting archived=true in PocketBase and updating the
+// Meilisearch document so it is excluded from all public search results.
+// The book data is preserved and can be restored with the unarchive endpoint.
+func (s *Server) handleAdminArchiveBook(w http.ResponseWriter, r *http.Request) {
+	slug := r.PathValue("slug")
+	if slug == "" {
+		jsonError(w, http.StatusBadRequest, "missing slug")
+		return
+	}
+	if s.deps.BookAdminStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "book admin store not configured")
+		return
+	}
+
+	if err := s.deps.BookAdminStore.ArchiveBook(r.Context(), slug); err != nil {
+		if errors.Is(err, storage.ErrNotFound) {
+			jsonError(w, http.StatusNotFound, "book not found")
+			return
+		}
+		s.deps.Log.Error("archive book failed", "slug", slug, "err", err)
+		jsonError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+
+	// Update the Meilisearch document so the archived flag takes effect
+	// immediately in search/catalogue results.
+	if meta, ok, err := s.deps.BookReader.ReadMetadata(r.Context(), slug); err == nil && ok {
+		if upsertErr := s.deps.SearchIndex.UpsertBook(r.Context(), meta); upsertErr != nil {
+			s.deps.Log.Warn("archive book: meili upsert failed", "slug", slug, "err", upsertErr)
+		}
+	}
+
+	s.deps.Log.Info("book archived", "slug", slug)
+	writeJSON(w, http.StatusOK, map[string]string{"slug": slug, "status": "archived"})
+}
+
+// handleAdminUnarchiveBook handles PATCH /api/admin/books/{slug}/unarchive.
+// Restores a previously archived book by clearing the archived flag, making it
+// publicly visible in search and catalogue results again.
+func (s *Server) handleAdminUnarchiveBook(w http.ResponseWriter, r *http.Request) {
+	slug := r.PathValue("slug")
+	if slug == "" {
+		jsonError(w, http.StatusBadRequest, "missing slug")
+		return
+	}
+	if s.deps.BookAdminStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "book admin store not configured")
+		return
+	}
+
+	if err := s.deps.BookAdminStore.UnarchiveBook(r.Context(), slug); err != nil {
+		if errors.Is(err, storage.ErrNotFound) {
+			jsonError(w, http.StatusNotFound, "book not found")
+			return
+		}
+		s.deps.Log.Error("unarchive book failed", "slug", slug, "err", err)
+		jsonError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+
+	// Sync the updated archived=false state back to Meilisearch.
+	if meta, ok, err := s.deps.BookReader.ReadMetadata(r.Context(), slug); err == nil && ok {
+		if upsertErr := s.deps.SearchIndex.UpsertBook(r.Context(), meta); upsertErr != nil {
+			s.deps.Log.Warn("unarchive book: meili upsert failed", "slug", slug, "err", upsertErr)
+		}
+	}
+
+	s.deps.Log.Info("book unarchived", "slug", slug)
+	writeJSON(w, http.StatusOK, map[string]string{"slug": slug, "status": "active"})
+}
+
+// handleAdminDeleteBook handles DELETE /api/admin/books/{slug}.
+// Permanently removes all data for a book:
+//   - PocketBase books record and all chapters_idx records
+//   - All MinIO chapter markdown objects and the cover image
+//   - Meilisearch document
+//
+// This operation is irreversible. Use the archive endpoint for soft-deletion.
+func (s *Server) handleAdminDeleteBook(w http.ResponseWriter, r *http.Request) {
+	slug := r.PathValue("slug")
+	if slug == "" {
+		jsonError(w, http.StatusBadRequest, "missing slug")
+		return
+	}
+	if s.deps.BookAdminStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "book admin store not configured")
+		return
+	}
+
+	if err := s.deps.BookAdminStore.DeleteBook(r.Context(), slug); err != nil {
+		if errors.Is(err, storage.ErrNotFound) {
+			jsonError(w, http.StatusNotFound, "book not found")
+			return
+		}
+		s.deps.Log.Error("delete book failed", "slug", slug, "err", err)
+		jsonError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+
+	// Remove from Meilisearch — best-effort (log on failure, don't fail request).
+	if err := s.deps.SearchIndex.DeleteBook(r.Context(), slug); err != nil {
+		s.deps.Log.Warn("delete book: meili delete failed", "slug", slug, "err", err)
+	}
+
+	s.deps.Log.Info("book deleted", "slug", slug)
+	writeJSON(w, http.StatusOK, map[string]string{"slug": slug, "status": "deleted"})
+}

backend/internal/backend/handlers_image.go

@@ -1,14 +1,18 @@
 package backend
 
 import (
+	"context"
 	"encoding/base64"
 	"encoding/json"
 	"fmt"
 	"io"
 	"net/http"
+	"strconv"
 	"strings"
+	"time"
 
 	"github.com/libnovel/backend/internal/cfai"
+	"github.com/libnovel/backend/internal/domain"
 )
 
 // handleAdminImageGenModels handles GET /api/admin/image-gen/models.
@@ -288,3 +292,354 @@ func sniffImageContentType(data []byte) string {
 	}
 	return "image/png"
 }
+
+// saveChapterImageRequest is the JSON body for POST /api/admin/image-gen/save-chapter-image.
+type saveChapterImageRequest struct {
+	// Slug is the book slug.
+	Slug string `json:"slug"`
+	// Chapter is the 1-based chapter number.
+	Chapter int `json:"chapter"`
+	// ImageB64 is the base64-encoded image bytes (PNG or JPEG).
+	ImageB64 string `json:"image_b64"`
+}
+
+// handleAdminImageGenSaveChapterImage handles POST /api/admin/image-gen/save-chapter-image.
+//
+// Accepts a pre-generated image as base64 and stores it as the chapter illustration
+// in MinIO, replacing the existing one if present. Does not call Cloudflare AI.
+func (s *Server) handleAdminImageGenSaveChapterImage(w http.ResponseWriter, r *http.Request) {
+	if s.deps.ChapterImageStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "chapter image store not configured")
+		return
+	}
+
+	var req saveChapterImageRequest
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		jsonError(w, http.StatusBadRequest, "parse body: "+err.Error())
+		return
+	}
+	if req.Slug == "" {
+		jsonError(w, http.StatusBadRequest, "slug is required")
+		return
+	}
+	if req.Chapter <= 0 {
+		jsonError(w, http.StatusBadRequest, "chapter must be > 0")
+		return
+	}
+	if req.ImageB64 == "" {
+		jsonError(w, http.StatusBadRequest, "image_b64 is required")
+		return
+	}
+
+	imgData, err := base64.StdEncoding.DecodeString(req.ImageB64)
+	if err != nil {
+		imgData, err = base64.RawStdEncoding.DecodeString(req.ImageB64)
+		if err != nil {
+			jsonError(w, http.StatusBadRequest, "decode image_b64: "+err.Error())
+			return
+		}
+	}
+
+	contentType := sniffImageContentType(imgData)
+	if err := s.deps.ChapterImageStore.PutChapterImage(r.Context(), req.Slug, req.Chapter, imgData, contentType); err != nil {
+		s.deps.Log.Error("admin: save-chapter-image failed", "slug", req.Slug, "chapter", req.Chapter, "err", err)
+		jsonError(w, http.StatusInternalServerError, "save chapter image: "+err.Error())
+		return
+	}
+
+	s.deps.Log.Info("admin: chapter image saved", "slug", req.Slug, "chapter", req.Chapter, "bytes", len(imgData))
+	writeJSON(w, 0, map[string]any{
+		"saved":     true,
+		"image_url": fmt.Sprintf("/api/chapter-image/novelfire.net/%s/%d", req.Slug, req.Chapter),
+		"bytes":     len(imgData),
+	})
+}
+
+// handleHeadChapterImage handles HEAD /api/chapter-image/{domain}/{slug}/{n}.
+//
+// Returns 200 when an image exists for this chapter, 404 otherwise.
+// Used by the SSR loader to check existence without downloading the full image.
+func (s *Server) handleHeadChapterImage(w http.ResponseWriter, r *http.Request) {
+	if s.deps.ChapterImageStore == nil {
+		w.WriteHeader(http.StatusNotFound)
+		return
+	}
+
+	slug := r.PathValue("slug")
+	nStr := r.PathValue("n")
+	n, err := strconv.Atoi(nStr)
+	if err != nil || n <= 0 {
+		w.WriteHeader(http.StatusBadRequest)
+		return
+	}
+
+	if s.deps.ChapterImageStore.ChapterImageExists(r.Context(), slug, n) {
+		w.WriteHeader(http.StatusOK)
+	} else {
+		w.WriteHeader(http.StatusNotFound)
+	}
+}
+
+// handleGetChapterImage handles GET /api/chapter-image/{domain}/{slug}/{n}.
+//
+// Serves the stored chapter illustration directly from MinIO.
+// Returns 404 when no image has been saved for this chapter.
+func (s *Server) handleGetChapterImage(w http.ResponseWriter, r *http.Request) {
+	if s.deps.ChapterImageStore == nil {
+		http.NotFound(w, r)
+		return
+	}
+
+	slug := r.PathValue("slug")
+	nStr := r.PathValue("n")
+	n, err := strconv.Atoi(nStr)
+	if err != nil || n <= 0 {
+		jsonError(w, http.StatusBadRequest, "invalid chapter number")
+		return
+	}
+
+	data, contentType, ok, err := s.deps.ChapterImageStore.GetChapterImage(r.Context(), slug, n)
+	if err != nil {
+		s.deps.Log.Error("chapter-image: get failed", "slug", slug, "n", n, "err", err)
+		jsonError(w, http.StatusInternalServerError, "could not retrieve chapter image")
+		return
+	}
+	if !ok {
+		http.NotFound(w, r)
+		return
+	}
+
+	w.Header().Set("Content-Type", contentType)
+	w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
+	w.Header().Set("Content-Length", fmt.Sprintf("%d", len(data)))
+	w.WriteHeader(http.StatusOK)
+	_, _ = w.Write(data)
+}
+
+// handleAdminImageGenAsync handles POST /api/admin/image-gen/async.
+//
+// Fire-and-forget variant: validates the request, creates an ai_job record of
+// kind "image-gen", spawns a background goroutine, and returns HTTP 202 with
+// {job_id} immediately. The goroutine calls Cloudflare AI, stores the result
+// as base64 in the job payload, and marks the job done/failed when finished.
+//
+// The admin can then review the result via the ai-jobs page and approve
+// (save as cover) or reject (discard) the image.
+func (s *Server) handleAdminImageGenAsync(w http.ResponseWriter, r *http.Request) {
+	if s.deps.ImageGen == nil {
+		jsonError(w, http.StatusServiceUnavailable, "image generation not configured (CFAI_ACCOUNT_ID/CFAI_API_TOKEN missing)")
+		return
+	}
+	if s.deps.AIJobStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "ai job store not configured")
+		return
+	}
+
+	var req imageGenRequest
+	var refImageData []byte
+
+	ct := r.Header.Get("Content-Type")
+	if strings.HasPrefix(ct, "multipart/form-data") {
+		if err := r.ParseMultipartForm(32 << 20); err != nil {
+			jsonError(w, http.StatusBadRequest, "parse multipart: "+err.Error())
+			return
+		}
+		if jsonPart := r.FormValue("json"); jsonPart != "" {
+			if err := json.Unmarshal([]byte(jsonPart), &req); err != nil {
+				jsonError(w, http.StatusBadRequest, "parse json field: "+err.Error())
+				return
+			}
+		}
+		if f, _, err := r.FormFile("reference"); err == nil {
+			defer f.Close()
+			refImageData, _ = io.ReadAll(f)
+		}
+	} else {
+		if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+			jsonError(w, http.StatusBadRequest, "parse body: "+err.Error())
+			return
+		}
+		if req.ReferenceImageB64 != "" {
+			var decErr error
+			refImageData, decErr = base64.StdEncoding.DecodeString(req.ReferenceImageB64)
+			if decErr != nil {
+				refImageData, decErr = base64.RawStdEncoding.DecodeString(req.ReferenceImageB64)
+				if decErr != nil {
+					jsonError(w, http.StatusBadRequest, "decode reference_image_b64: "+decErr.Error())
+					return
+				}
+			}
+		}
+	}
+
+	if strings.TrimSpace(req.Prompt) == "" {
+		jsonError(w, http.StatusBadRequest, "prompt is required")
+		return
+	}
+	if req.Type != "cover" && req.Type != "chapter" {
+		jsonError(w, http.StatusBadRequest, `type must be "cover" or "chapter"`)
+		return
+	}
+	if req.Slug == "" {
+		jsonError(w, http.StatusBadRequest, "slug is required")
+		return
+	}
+	if req.Type == "chapter" && req.Chapter <= 0 {
+		jsonError(w, http.StatusBadRequest, "chapter must be > 0 when type is chapter")
+		return
+	}
+
+	// Resolve model.
+	model := cfai.ImageModel(req.Model)
+	if model == "" {
+		if req.Type == "cover" {
+			model = cfai.DefaultImageModel
+		} else {
+			model = cfai.ImageModelFlux2Klein4B
+		}
+	}
+
+	// Encode request params as job payload so the UI can reconstruct context.
+	type jobParams struct {
+		Prompt    string `json:"prompt"`
+		Type      string `json:"type"`
+		Chapter   int    `json:"chapter,omitempty"`
+		NumSteps  int    `json:"num_steps,omitempty"`
+		Width     int    `json:"width,omitempty"`
+		Height    int    `json:"height,omitempty"`
+		Guidance  float64 `json:"guidance,omitempty"`
+		Strength  float64 `json:"strength,omitempty"`
+		HasRef    bool   `json:"has_ref,omitempty"`
+	}
+	paramsJSON, _ := json.Marshal(jobParams{
+		Prompt:   req.Prompt,
+		Type:     req.Type,
+		Chapter:  req.Chapter,
+		NumSteps: req.NumSteps,
+		Width:    req.Width,
+		Height:   req.Height,
+		Guidance: req.Guidance,
+		Strength: req.Strength,
+		HasRef:   len(refImageData) > 0,
+	})
+
+	jobID, createErr := s.deps.AIJobStore.CreateAIJob(r.Context(), domain.AIJob{
+		Kind:    "image-gen",
+		Slug:    req.Slug,
+		Status:  domain.TaskStatusPending,
+		Model:   string(model),
+		Payload: string(paramsJSON),
+		Started: time.Now(),
+	})
+	if createErr != nil {
+		jsonError(w, http.StatusInternalServerError, "create ai job: "+createErr.Error())
+		return
+	}
+
+	jobCtx, jobCancel := context.WithCancel(context.Background())
+	registerCancelJob(jobID, jobCancel)
+
+	// Mark running before returning.
+	_ = s.deps.AIJobStore.UpdateAIJob(r.Context(), jobID, map[string]any{
+		"status": string(domain.TaskStatusRunning),
+	})
+
+	s.deps.Log.Info("admin: image-gen async started",
+		"job_id", jobID, "slug", req.Slug, "type", req.Type, "model", model)
+
+	// Capture locals for the goroutine.
+	store := s.deps.AIJobStore
+	imageGen := s.deps.ImageGen
+	coverStore := s.deps.CoverStore
+	logger := s.deps.Log
+	capturedReq := req
+	capturedModel := model
+	capturedRefImage := refImageData
+
+	go func() {
+		defer deregisterCancelJob(jobID)
+		defer jobCancel()
+
+		if jobCtx.Err() != nil {
+			_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+				"status":   string(domain.TaskStatusCancelled),
+				"finished": time.Now().Format(time.RFC3339),
+			})
+			return
+		}
+
+		imgReq := cfai.ImageRequest{
+			Prompt:   capturedReq.Prompt,
+			Model:    capturedModel,
+			NumSteps: capturedReq.NumSteps,
+			Width:    capturedReq.Width,
+			Height:   capturedReq.Height,
+			Guidance: capturedReq.Guidance,
+			Strength: capturedReq.Strength,
+		}
+
+		var imgData []byte
+		var genErr error
+		if len(capturedRefImage) > 0 {
+			imgData, genErr = imageGen.GenerateImageFromReference(jobCtx, imgReq, capturedRefImage)
+		} else {
+			imgData, genErr = imageGen.GenerateImage(jobCtx, imgReq)
+		}
+
+		if genErr != nil {
+			logger.Error("admin: image-gen async failed", "job_id", jobID, "err", genErr)
+			_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+				"status":        string(domain.TaskStatusFailed),
+				"error_message": genErr.Error(),
+				"finished":      time.Now().Format(time.RFC3339),
+			})
+			return
+		}
+
+		contentType := sniffImageContentType(imgData)
+		b64 := base64.StdEncoding.EncodeToString(imgData)
+
+		// Build result payload: include the original params + the generated image.
+		type resultPayload struct {
+			Prompt      string  `json:"prompt"`
+			Type        string  `json:"type"`
+			Chapter     int     `json:"chapter,omitempty"`
+			ContentType string  `json:"content_type"`
+			ImageB64    string  `json:"image_b64"`
+			Bytes       int     `json:"bytes"`
+			NumSteps    int     `json:"num_steps,omitempty"`
+			Width       int     `json:"width,omitempty"`
+			Height      int     `json:"height,omitempty"`
+			Guidance    float64 `json:"guidance,omitempty"`
+		}
+		resultJSON, _ := json.Marshal(resultPayload{
+			Prompt:      capturedReq.Prompt,
+			Type:        capturedReq.Type,
+			Chapter:     capturedReq.Chapter,
+			ContentType: contentType,
+			ImageB64:    b64,
+			Bytes:       len(imgData),
+			NumSteps:    capturedReq.NumSteps,
+			Width:       capturedReq.Width,
+			Height:      capturedReq.Height,
+			Guidance:    capturedReq.Guidance,
+		})
+
+		_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+			"status":     string(domain.TaskStatusDone),
+			"items_done": 1,
+			"items_total": 1,
+			"payload":    string(resultJSON),
+			"finished":   time.Now().Format(time.RFC3339),
+		})
+
+		logger.Info("admin: image-gen async done",
+			"job_id", jobID, "slug", capturedReq.Slug,
+			"bytes", len(imgData), "content_type", contentType)
+
+		// Suppress unused variable warning for coverStore when SaveToCover is false.
+		_ = coverStore
+	}()
+
+	writeJSON(w, http.StatusAccepted, map[string]any{"job_id": jobID})
+}

backend/internal/backend/handlers_import.go

@@ -0,0 +1,234 @@
+package backend
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"github.com/libnovel/backend/internal/domain"
+	"github.com/libnovel/backend/internal/storage"
+)
+
+type importRequest struct {
+	Title       string   `json:"title"`
+	Author      string   `json:"author"`
+	CoverURL    string   `json:"cover_url"`
+	Genres      []string `json:"genres"`
+	Summary     string   `json:"summary"`
+	BookStatus  string   `json:"book_status"` // "ongoing" | "completed" | "hiatus"
+	FileName    string   `json:"file_name"`
+	FileType    string   `json:"file_type"`   // "pdf" or "epub"
+	ObjectKey   string   `json:"object_key"`  // MinIO path to uploaded file
+}
+
+type importResponse struct {
+	TaskID   string         `json:"task_id"`
+	Slug     string         `json:"slug"`
+	Preview  *importPreview `json:"preview,omitempty"`
+}
+
+type importPreview struct {
+	Chapters   int      `json:"chapters"`
+	FirstLines []string `json:"first_lines"`
+}
+
+func (s *Server) handleAdminImport(w http.ResponseWriter, r *http.Request) {
+	if s.deps.Producer == nil {
+		jsonError(w, http.StatusServiceUnavailable, "task queue not configured")
+		return
+	}
+
+	ct := r.Header.Get("Content-Type")
+	var req importRequest
+	var objectKey string
+	var chaptersKey string
+	var chapterCount int
+
+	if strings.HasPrefix(ct, "multipart/form-data") {
+		if err := r.ParseMultipartForm(32 << 20); err != nil {
+			jsonError(w, http.StatusBadRequest, "parse multipart: "+err.Error())
+			return
+		}
+		req.Title = r.FormValue("title")
+		req.Author = r.FormValue("author")
+		req.CoverURL = r.FormValue("cover_url")
+		req.Summary = r.FormValue("summary")
+		req.BookStatus = r.FormValue("book_status")
+		if g := r.FormValue("genres"); g != "" {
+			for _, s := range strings.Split(g, ",") {
+				if s = strings.TrimSpace(s); s != "" {
+					req.Genres = append(req.Genres, s)
+				}
+			}
+		}
+		req.FileName = r.FormValue("file_name")
+		req.FileType = r.FormValue("file_type")
+		analyzeOnly := r.FormValue("analyze") == "true"
+
+		file, header, err := r.FormFile("file")
+		if err != nil {
+			jsonError(w, http.StatusBadRequest, "parse file: "+err.Error())
+			return
+		}
+		defer file.Close()
+
+		if req.FileName == "" {
+			req.FileName = header.Filename
+		}
+		if req.FileType == "" {
+			req.FileType = strings.TrimPrefix(filepath.Ext(header.Filename), ".")
+		}
+
+		data, err := io.ReadAll(file)
+		if err != nil {
+			jsonError(w, http.StatusBadRequest, "read file: "+err.Error())
+			return
+		}
+
+		// Analyze only - just count chapters
+		if analyzeOnly {
+			preview := analyzeImportFile(data, req.FileType)
+			writeJSON(w, 0, importResponse{
+				Preview: preview,
+			})
+			return
+		}
+
+		// Parse PDF/EPUB on the backend (with timeout) and store chapters as JSON.
+		// The runner only needs to ingest pre-parsed chapters — no PDF parsing on runner.
+		parseCtx, parseCancel := context.WithTimeout(r.Context(), 3*time.Minute)
+		defer parseCancel()
+		chapters, parseErr := storage.ParseImportFile(parseCtx, data, req.FileType)
+		if parseErr != nil || len(chapters) == 0 {
+			jsonError(w, http.StatusUnprocessableEntity, "could not parse file: "+func() string {
+				if parseErr != nil { return parseErr.Error() }
+				return "no chapters found"
+			}())
+			return
+		}
+
+		// Store raw file in MinIO (for reference/re-import).
+		objectKey = fmt.Sprintf("imports/%d_%s", time.Now().Unix(), header.Filename)
+		if s.deps.ImportFileStore == nil {
+			jsonError(w, http.StatusInternalServerError, "storage not available")
+			return
+		}
+		if err := s.deps.ImportFileStore.PutImportFile(r.Context(), objectKey, data); err != nil {
+			jsonError(w, http.StatusInternalServerError, "upload file: "+err.Error())
+			return
+		}
+
+		// Store pre-parsed chapters JSON in MinIO so runner can ingest without re-parsing.
+		chaptersJSON, _ := json.Marshal(chapters)
+		chaptersKey = fmt.Sprintf("imports/%d_%s_chapters.json", time.Now().Unix(), strings.TrimSuffix(header.Filename, filepath.Ext(header.Filename)))
+		if err := s.deps.ImportFileStore.PutImportChapters(r.Context(), chaptersKey, chaptersJSON); err != nil {
+			jsonError(w, http.StatusInternalServerError, "store chapters: "+err.Error())
+			return
+		}
+		chapterCount = len(chapters)
+	} else {
+		if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+			jsonError(w, http.StatusBadRequest, "parse body: "+err.Error())
+			return
+		}
+		objectKey = req.ObjectKey
+	}
+
+	if req.Title == "" {
+		jsonError(w, http.StatusBadRequest, "title is required")
+		return
+	}
+	if req.FileType != "pdf" && req.FileType != "epub" {
+		jsonError(w, http.StatusBadRequest, "file_type must be 'pdf' or 'epub'")
+		return
+	}
+
+	slug := strings.ToLower(strings.ReplaceAll(req.Title, " ", "-"))
+	slug = strings.Map(func(r rune) rune {
+		if (r >= 'a' && r <= 'z') || (r >= '0' && r <= '9') || r == '-' {
+			return r
+		}
+		return -1
+	}, slug)
+
+	taskID, err := s.deps.Producer.CreateImportTask(r.Context(), domain.ImportTask{
+		Slug:            slug,
+		Title:           req.Title,
+		Author:          req.Author,
+		CoverURL:        req.CoverURL,
+		Genres:          req.Genres,
+		Summary:         req.Summary,
+		BookStatus:      req.BookStatus,
+		FileType:        req.FileType,
+		ObjectKey:       objectKey,
+		ChaptersKey:     chaptersKey,
+		ChaptersTotal:   chapterCount,
+		InitiatorUserID: "",
+	})
+	if err != nil {
+		jsonError(w, http.StatusInternalServerError, "create import task: "+err.Error())
+		return
+	}
+
+	writeJSON(w, 0, importResponse{
+		TaskID:   taskID,
+		Slug:     slug,
+		Preview: &importPreview{Chapters: chapterCount},
+	})
+}
+
+// analyzeImportFile parses the file to count chapters and extract preview lines.
+func analyzeImportFile(data []byte, fileType string) *importPreview {
+	count, firstLines, err := storage.AnalyzeFile(data, fileType)
+	if err != nil || count == 0 {
+		// Fall back to rough size estimate so the UI still shows something
+		count = estimateChapters(data, fileType)
+	}
+	return &importPreview{
+		Chapters:   count,
+		FirstLines: firstLines,
+	}
+}
+
+func estimateChapters(data []byte, fileType string) int {
+	// Rough estimate: ~100KB per chapter for PDF, ~50KB for EPUB
+	size := len(data)
+	if fileType == "pdf" {
+		return size / 100000
+	}
+	return size / 50000
+}
+
+func (s *Server) handleAdminImportStatus(w http.ResponseWriter, r *http.Request) {
+	taskID := r.PathValue("id")
+	if taskID == "" {
+		jsonError(w, http.StatusBadRequest, "task id required")
+		return
+	}
+
+	task, ok, err := s.deps.TaskReader.GetImportTask(r.Context(), taskID)
+	if err != nil {
+		jsonError(w, http.StatusInternalServerError, "get task: "+err.Error())
+		return
+	}
+	if !ok {
+		jsonError(w, http.StatusNotFound, "task not found")
+		return
+	}
+
+	writeJSON(w, 0, task)
+}
+
+func (s *Server) handleAdminImportList(w http.ResponseWriter, r *http.Request) {
+	tasks, err := s.deps.TaskReader.ListImportTasks(r.Context())
+	if err != nil {
+		jsonError(w, http.StatusInternalServerError, "list tasks: "+err.Error())
+		return
+	}
+	writeJSON(w, 0, map[string]any{"tasks": tasks})
+}

backend/internal/backend/handlers_notifications.go

@@ -0,0 +1,126 @@
+package backend
+
+import (
+	"encoding/json"
+	"net/http"
+
+	"github.com/libnovel/backend/internal/storage"
+)
+
+// handleDismissNotification handles DELETE /api/notifications/{id}.
+func (s *Server) handleDismissNotification(w http.ResponseWriter, r *http.Request) {
+	id := r.PathValue("id")
+	if id == "" {
+		jsonError(w, http.StatusBadRequest, "notification id required")
+		return
+	}
+	store, ok := s.deps.Producer.(*storage.Store)
+	if !ok {
+		jsonError(w, http.StatusInternalServerError, "storage not available")
+		return
+	}
+	if err := store.DeleteNotification(r.Context(), id); err != nil {
+		jsonError(w, http.StatusInternalServerError, "dismiss notification: "+err.Error())
+		return
+	}
+	writeJSON(w, 0, map[string]any{"success": true})
+}
+
+// handleClearAllNotifications handles DELETE /api/notifications?user_id=...
+func (s *Server) handleClearAllNotifications(w http.ResponseWriter, r *http.Request) {
+	userID := r.URL.Query().Get("user_id")
+	if userID == "" {
+		jsonError(w, http.StatusBadRequest, "user_id required")
+		return
+	}
+	store, ok := s.deps.Producer.(*storage.Store)
+	if !ok {
+		jsonError(w, http.StatusInternalServerError, "storage not available")
+		return
+	}
+	if err := store.ClearAllNotifications(r.Context(), userID); err != nil {
+		jsonError(w, http.StatusInternalServerError, "clear notifications: "+err.Error())
+		return
+	}
+	writeJSON(w, 0, map[string]any{"success": true})
+}
+
+// handleMarkAllNotificationsRead handles PATCH /api/notifications?user_id=...
+func (s *Server) handleMarkAllNotificationsRead(w http.ResponseWriter, r *http.Request) {
+	userID := r.URL.Query().Get("user_id")
+	if userID == "" {
+		jsonError(w, http.StatusBadRequest, "user_id required")
+		return
+	}
+	store, ok := s.deps.Producer.(*storage.Store)
+	if !ok {
+		jsonError(w, http.StatusInternalServerError, "storage not available")
+		return
+	}
+	if err := store.MarkAllNotificationsRead(r.Context(), userID); err != nil {
+		jsonError(w, http.StatusInternalServerError, "mark all read: "+err.Error())
+		return
+	}
+	writeJSON(w, 0, map[string]any{"success": true})
+}
+
+type notification struct {
+	ID      string `json:"id"`
+	UserID  string `json:"user_id"`
+	Title   string `json:"title"`
+	Message string `json:"message"`
+	Link    string `json:"link"`
+	Read    bool   `json:"read"`
+}
+
+func (s *Server) handleListNotifications(w http.ResponseWriter, r *http.Request) {
+	userID := r.URL.Query().Get("user_id")
+	if userID == "" {
+		jsonError(w, http.StatusBadRequest, "user_id required")
+		return
+	}
+
+	store, ok := s.deps.Producer.(*storage.Store)
+	if !ok {
+		jsonError(w, http.StatusInternalServerError, "storage not available")
+		return
+	}
+
+	items, err := store.ListNotifications(r.Context(), userID, 50)
+	if err != nil {
+		jsonError(w, http.StatusInternalServerError, "list notifications: "+err.Error())
+		return
+	}
+
+	// Parse each item as notification
+	notifications := make([]notification, 0, len(items))
+	for _, item := range items {
+		b, _ := json.Marshal(item)
+		var n notification
+		json.Unmarshal(b, &n)
+		notifications = append(notifications, n)
+	}
+
+	writeJSON(w, 0, map[string]any{"notifications": notifications})
+}
+
+func (s *Server) handleMarkNotificationRead(w http.ResponseWriter, r *http.Request) {
+	id := r.PathValue("id")
+	if id == "" {
+		jsonError(w, http.StatusBadRequest, "notification id required")
+		return
+	}
+
+	store, ok := s.deps.Producer.(*storage.Store)
+	if !ok {
+		jsonError(w, http.StatusInternalServerError, "storage not available")
+		return
+	}
+
+	if err := store.MarkNotificationRead(r.Context(), id); err != nil {
+		jsonError(w, http.StatusInternalServerError, "mark read: "+err.Error())
+		return
+	}
+
+	writeJSON(w, 0, map[string]any{"success": true})
+}

backend/internal/backend/handlers_split.go

@@ -0,0 +1,141 @@
+package backend
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/libnovel/backend/internal/bookstore"
+	"github.com/libnovel/backend/internal/domain"
+)
+
+// handleAdminSplitChapters handles POST /api/admin/books/{slug}/split-chapters.
+//
+// Request body (JSON):
+//
+//	{ "text": "<full text with --- dividers and optional ## Title lines>" }
+//
+// The text is split on lines containing only "---". Each segment may start with
+// a "## Title" line which becomes the chapter title; remaining lines are the
+// chapter content. Sequential chapter numbers 1..N are assigned.
+//
+// All existing chapters for the book are replaced: WriteChapter is called for
+// each new chapter (upsert by number), so chapters beyond N are not deleted —
+// use the dedup endpoint afterwards if needed.
+func (s *Server) handleAdminSplitChapters(w http.ResponseWriter, r *http.Request) {
+	if s.deps.BookWriter == nil {
+		jsonError(w, http.StatusServiceUnavailable, "book writer not configured")
+		return
+	}
+
+	slug := r.PathValue("slug")
+	if slug == "" {
+		jsonError(w, http.StatusBadRequest, "slug is required")
+		return
+	}
+
+	var req struct {
+		Text string `json:"text"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		jsonError(w, http.StatusBadRequest, "parse body: "+err.Error())
+		return
+	}
+	if strings.TrimSpace(req.Text) == "" {
+		jsonError(w, http.StatusBadRequest, "text is required")
+		return
+	}
+
+	chapters := splitChapterText(req.Text)
+	if len(chapters) == 0 {
+		jsonError(w, http.StatusUnprocessableEntity, "no chapters produced from text")
+		return
+	}
+
+	for _, ch := range chapters {
+		var mdContent string
+		if ch.Title != "" && ch.Title != fmt.Sprintf("Chapter %d", ch.Number) {
+			mdContent = fmt.Sprintf("# %s\n\n%s", ch.Title, ch.Content)
+		} else {
+			mdContent = fmt.Sprintf("# Chapter %d\n\n%s", ch.Number, ch.Content)
+		}
+		domainCh := domain.Chapter{
+			Ref:  domain.ChapterRef{Number: ch.Number, Title: ch.Title},
+			Text: mdContent,
+		}
+		if err := s.deps.BookWriter.WriteChapter(r.Context(), slug, domainCh); err != nil {
+			jsonError(w, http.StatusInternalServerError, fmt.Sprintf("write chapter %d: %s", ch.Number, err.Error()))
+			return
+		}
+	}
+
+	writeJSON(w, 0, map[string]any{
+		"chapters": len(chapters),
+		"slug":     slug,
+	})
+}
+
+// splitChapterText splits text on "---" divider lines into bookstore.Chapter
+// slices. Each segment may optionally start with a "## Title" header line.
+func splitChapterText(text string) []bookstore.Chapter {
+	lines := strings.Split(text, "\n")
+
+	// Collect raw segments split on "---" dividers.
+	var segments [][]string
+	cur := []string{}
+	for _, line := range lines {
+		if strings.TrimSpace(line) == "---" {
+			segments = append(segments, cur)
+			cur = []string{}
+		} else {
+			cur = append(cur, line)
+		}
+	}
+	segments = append(segments, cur) // last segment
+
+	var chapters []bookstore.Chapter
+	chNum := 0
+	for _, seg := range segments {
+		// Trim leading/trailing blank lines from the segment.
+		start, end := 0, len(seg)
+		for start < end && strings.TrimSpace(seg[start]) == "" {
+			start++
+		}
+		for end > start && strings.TrimSpace(seg[end-1]) == "" {
+			end--
+		}
+		seg = seg[start:end]
+		if len(seg) == 0 {
+			continue
+		}
+
+		// Check for a "## Title" header on the first line.
+		title := ""
+		contentStart := 0
+		if strings.HasPrefix(strings.TrimSpace(seg[0]), "## ") {
+			title = strings.TrimSpace(strings.TrimPrefix(strings.TrimSpace(seg[0]), "## "))
+			contentStart = 1
+			// Skip blank lines after the title.
+			for contentStart < len(seg) && strings.TrimSpace(seg[contentStart]) == "" {
+				contentStart++
+			}
+		}
+
+		content := strings.TrimSpace(strings.Join(seg[contentStart:], "\n"))
+		if content == "" {
+			continue
+		}
+
+		chNum++
+		if title == "" {
+			title = fmt.Sprintf("Chapter %d", chNum)
+		}
+		chapters = append(chapters, bookstore.Chapter{
+			Number:  chNum,
+			Title:   title,
+			Content: content,
+		})
+	}
+	return chapters
+}

backend/internal/backend/handlers_textgen.go

@@ -801,3 +801,161 @@ func (s *Server) handleAdminTextGenApplyDescription(w http.ResponseWriter, r *ht
 	s.deps.Log.Info("admin: book description applied", "slug", req.Slug)
 	writeJSON(w, 0, map[string]any{"updated": true})
 }
+
+// handleAdminTextGenDescriptionAsync handles POST /api/admin/text-gen/description/async.
+//
+// Fire-and-forget variant: validates inputs, creates an ai_job record of kind
+// "description", spawns a background goroutine that calls the LLM, stores the
+// old/new description in the job payload, and marks the job done/failed.
+// Returns HTTP 202 with {job_id} immediately.
+func (s *Server) handleAdminTextGenDescriptionAsync(w http.ResponseWriter, r *http.Request) {
+	if s.deps.TextGen == nil {
+		jsonError(w, http.StatusServiceUnavailable, "text generation not configured (CFAI_ACCOUNT_ID/CFAI_API_TOKEN missing)")
+		return
+	}
+	if s.deps.AIJobStore == nil {
+		jsonError(w, http.StatusServiceUnavailable, "ai job store not configured")
+		return
+	}
+
+	var req textGenDescriptionRequest
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		jsonError(w, http.StatusBadRequest, "parse body: "+err.Error())
+		return
+	}
+	if strings.TrimSpace(req.Slug) == "" {
+		jsonError(w, http.StatusBadRequest, "slug is required")
+		return
+	}
+
+	// Load current metadata eagerly so we can fail fast if the book is missing.
+	meta, ok, err := s.deps.BookReader.ReadMetadata(r.Context(), req.Slug)
+	if err != nil {
+		jsonError(w, http.StatusInternalServerError, "read metadata: "+err.Error())
+		return
+	}
+	if !ok {
+		jsonError(w, http.StatusNotFound, fmt.Sprintf("book %q not found", req.Slug))
+		return
+	}
+
+	model := cfai.TextModel(req.Model)
+	if model == "" {
+		model = cfai.DefaultTextModel
+	}
+
+	instructions := strings.TrimSpace(req.Instructions)
+	if instructions == "" {
+		instructions = "Write a compelling 2–4 sentence description. Keep it spoiler-free and engaging."
+	}
+
+	// Encode the initial params (without result) as the starting payload.
+	type initPayload struct {
+		Instructions   string `json:"instructions"`
+		OldDescription string `json:"old_description"`
+	}
+	initJSON, _ := json.Marshal(initPayload{
+		Instructions:   instructions,
+		OldDescription: meta.Summary,
+	})
+
+	jobID, createErr := s.deps.AIJobStore.CreateAIJob(r.Context(), domain.AIJob{
+		Kind:    "description",
+		Slug:    req.Slug,
+		Status:  domain.TaskStatusPending,
+		Model:   string(model),
+		Payload: string(initJSON),
+		Started: time.Now(),
+	})
+	if createErr != nil {
+		jsonError(w, http.StatusInternalServerError, "create ai job: "+createErr.Error())
+		return
+	}
+
+	jobCtx, jobCancel := context.WithCancel(context.Background())
+	registerCancelJob(jobID, jobCancel)
+
+	_ = s.deps.AIJobStore.UpdateAIJob(r.Context(), jobID, map[string]any{
+		"status": string(domain.TaskStatusRunning),
+	})
+
+	s.deps.Log.Info("admin: text-gen description async started",
+		"job_id", jobID, "slug", req.Slug, "model", model)
+
+	// Capture locals.
+	store := s.deps.AIJobStore
+	textGen := s.deps.TextGen
+	logger := s.deps.Log
+	capturedMeta := meta
+	capturedModel := model
+	capturedInstructions := instructions
+	capturedMaxTokens := req.MaxTokens
+
+	go func() {
+		defer deregisterCancelJob(jobID)
+		defer jobCancel()
+
+		if jobCtx.Err() != nil {
+			_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+				"status":   string(domain.TaskStatusCancelled),
+				"finished": time.Now().Format(time.RFC3339),
+			})
+			return
+		}
+
+		systemPrompt := `You are a book description writer for a web novel platform. ` +
+			`Given a book's title, author, genres, and current description, write an improved ` +
+			`description that accurately captures the story. ` +
+			`Respond with ONLY the new description text — no title, no labels, no markdown, no quotes.`
+
+		userPrompt := fmt.Sprintf(
+			"Title: %s\nAuthor: %s\nGenres: %s\nStatus: %s\n\nCurrent description:\n%s\n\nInstructions: %s",
+			capturedMeta.Title,
+			capturedMeta.Author,
+			strings.Join(capturedMeta.Genres, ", "),
+			capturedMeta.Status,
+			capturedMeta.Summary,
+			capturedInstructions,
+		)
+
+		newDesc, genErr := textGen.Generate(jobCtx, cfai.TextRequest{
+			Model: capturedModel,
+			Messages: []cfai.TextMessage{
+				{Role: "system", Content: systemPrompt},
+				{Role: "user", Content: userPrompt},
+			},
+			MaxTokens: capturedMaxTokens,
+		})
+		if genErr != nil {
+			logger.Error("admin: text-gen description async failed", "job_id", jobID, "err", genErr)
+			_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+				"status":        string(domain.TaskStatusFailed),
+				"error_message": genErr.Error(),
+				"finished":      time.Now().Format(time.RFC3339),
+			})
+			return
+		}
+
+		type resultPayload struct {
+			Instructions   string `json:"instructions"`
+			OldDescription string `json:"old_description"`
+			NewDescription string `json:"new_description"`
+		}
+		resultJSON, _ := json.Marshal(resultPayload{
+			Instructions:   capturedInstructions,
+			OldDescription: capturedMeta.Summary,
+			NewDescription: strings.TrimSpace(newDesc),
+		})
+
+		_ = store.UpdateAIJob(context.Background(), jobID, map[string]any{
+			"status":      string(domain.TaskStatusDone),
+			"items_done":  1,
+			"items_total": 1,
+			"payload":     string(resultJSON),
+			"finished":    time.Now().Format(time.RFC3339),
+		})
+		logger.Info("admin: text-gen description async done", "job_id", jobID, "slug", capturedMeta.Slug)
+	}()
+
+	writeJSON(w, http.StatusAccepted, map[string]any{"job_id": jobID})
+}

backend/internal/backend/server.go

@@ -57,6 +57,9 @@ type Dependencies struct {
 	// CoverStore reads and writes book cover images from MinIO.
 	// If nil, the cover endpoint falls back to a CDN redirect.
 	CoverStore bookstore.CoverStore
+	// ChapterImageStore reads and writes per-chapter illustration images from MinIO.
+	// If nil, chapter image endpoints return 404/503.
+	ChapterImageStore bookstore.ChapterImageStore
 	// Producer creates scrape/audio tasks in PocketBase.
 	Producer taskqueue.Producer
 	// TaskReader reads scrape/audio task records from PocketBase.
@@ -82,9 +85,15 @@ type Dependencies struct {
 	// BookWriter writes book metadata and chapter refs to PocketBase.
 	// Used by admin text-gen apply endpoints.
 	BookWriter bookstore.BookWriter
+	// ImportFileStore uploads raw PDF/EPUB files to MinIO for the runner to process.
+	// Always wired to the concrete *storage.Store (not the Asynq wrapper).
+	ImportFileStore bookstore.ImportFileStore
 	// AIJobStore tracks long-running AI generation jobs in PocketBase.
 	// If nil, job persistence is disabled (jobs still run but are not recorded).
 	AIJobStore bookstore.AIJobStore
+	// BookAdminStore provides admin-only operations: archive, unarchive, hard-delete.
+	// If nil, the admin book management endpoints return 503.
+	BookAdminStore bookstore.BookAdminStore
 	// Log is the structured logger.
 	Log *slog.Logger
 }
@@ -180,6 +189,8 @@ func (s *Server) ListenAndServe(ctx context.Context) error {
 	// Streaming audio: serves from MinIO if cached, else streams live TTS
 	// while simultaneously uploading to MinIO for future requests.
 	mux.HandleFunc("GET /api/audio-stream/{slug}/{n}", s.handleAudioStream)
+	// TTS for arbitrary short text (chapter announcements) — no MinIO caching.
+	mux.HandleFunc("GET /api/tts-announce", s.handleTTSAnnounce)
 	// CF AI preview: generates only the first ~1 800-char chunk so the client
 	// can start playing immediately while the full audio is generated by the runner.
 	mux.HandleFunc("GET /api/audio-preview/{slug}/{n}", s.handleAudioPreview)
@@ -201,7 +212,13 @@ func (s *Server) ListenAndServe(ctx context.Context) error {
 	// Admin image generation endpoints
 	mux.HandleFunc("GET /api/admin/image-gen/models", s.handleAdminImageGenModels)
 	mux.HandleFunc("POST /api/admin/image-gen", s.handleAdminImageGen)
+	mux.HandleFunc("POST /api/admin/image-gen/async", s.handleAdminImageGenAsync)
 	mux.HandleFunc("POST /api/admin/image-gen/save-cover", s.handleAdminImageGenSaveCover)
+	mux.HandleFunc("POST /api/admin/image-gen/save-chapter-image", s.handleAdminImageGenSaveChapterImage)
+
+	// Chapter image serving
+	mux.HandleFunc("GET /api/chapter-image/{domain}/{slug}/{n}", s.handleGetChapterImage)
+	mux.HandleFunc("HEAD /api/chapter-image/{domain}/{slug}/{n}", s.handleHeadChapterImage)
 
 	// Admin text generation endpoints (chapter names + book description)
 	mux.HandleFunc("GET /api/admin/text-gen/models", s.handleAdminTextGenModels)
@@ -209,6 +226,7 @@ func (s *Server) ListenAndServe(ctx context.Context) error {
 	mux.HandleFunc("POST /api/admin/text-gen/chapter-names/async", s.handleAdminTextGenChapterNamesAsync)
 	mux.HandleFunc("POST /api/admin/text-gen/chapter-names/apply", s.handleAdminTextGenApplyChapterNames)
 	mux.HandleFunc("POST /api/admin/text-gen/description", s.handleAdminTextGenDescription)
+	mux.HandleFunc("POST /api/admin/text-gen/description/async", s.handleAdminTextGenDescriptionAsync)
 	mux.HandleFunc("POST /api/admin/text-gen/description/apply", s.handleAdminTextGenApplyDescription)
 
 	// Admin catalogue enrichment endpoints
@@ -232,6 +250,26 @@ func (s *Server) ListenAndServe(ctx context.Context) error {
 	// Admin data repair endpoints
 	mux.HandleFunc("POST /api/admin/dedup-chapters/{slug}", s.handleDedupChapters)
 
+	// Admin book management (soft-delete / hard-delete)
+	mux.HandleFunc("PATCH /api/admin/books/{slug}/archive", s.handleAdminArchiveBook)
+	mux.HandleFunc("PATCH /api/admin/books/{slug}/unarchive", s.handleAdminUnarchiveBook)
+	mux.HandleFunc("DELETE /api/admin/books/{slug}", s.handleAdminDeleteBook)
+
+	// Admin chapter split (imported books)
+	mux.HandleFunc("POST /api/admin/books/{slug}/split-chapters", s.handleAdminSplitChapters)
+
+	// Import (PDF/EPUB)
+	mux.HandleFunc("POST /api/admin/import", s.handleAdminImport)
+	mux.HandleFunc("GET /api/admin/import", s.handleAdminImportList)
+	mux.HandleFunc("GET /api/admin/import/{id}", s.handleAdminImportStatus)
+
+	// Notifications
+	mux.HandleFunc("GET /api/notifications", s.handleListNotifications)
+	mux.HandleFunc("PATCH /api/notifications", s.handleMarkAllNotificationsRead)
+	mux.HandleFunc("PATCH /api/notifications/{id}", s.handleMarkNotificationRead)
+	mux.HandleFunc("DELETE /api/notifications", s.handleClearAllNotifications)
+	mux.HandleFunc("DELETE /api/notifications/{id}", s.handleDismissNotification)
+
 	// Voices list
 	mux.HandleFunc("GET /api/voices", s.handleVoices)
 

backend/internal/bookstore/bookstore.go

@@ -171,6 +171,20 @@ type AIJobStore interface {
 	ListAIJobs(ctx context.Context) ([]domain.AIJob, error)
 }
 
+// ChapterImageStore covers per-chapter illustration images stored in MinIO.
+// The backend admin writes them; the backend serves them.
+type ChapterImageStore interface {
+	// PutChapterImage stores a raw image for chapter n of slug in MinIO.
+	PutChapterImage(ctx context.Context, slug string, n int, data []byte, contentType string) error
+
+	// GetChapterImage retrieves the image for chapter n of slug.
+	// Returns (nil, "", false, nil) when no image exists.
+	GetChapterImage(ctx context.Context, slug string, n int) ([]byte, string, bool, error)
+
+	// ChapterImageExists returns true when an image is stored for slug/n.
+	ChapterImageExists(ctx context.Context, slug string, n int) bool
+}
+
 // TranslationStore covers machine-translated chapter storage in MinIO.
 // The runner writes translations; the backend reads them.
 type TranslationStore interface {
@@ -186,3 +200,50 @@ type TranslationStore interface {
 	// GetTranslation retrieves translated markdown from MinIO.
 	GetTranslation(ctx context.Context, key string) (string, error)
 }
+
+// Chapter represents a single chapter extracted from PDF/EPUB.
+type Chapter struct {
+	Number   int    // 1-based chapter number
+	Title    string // chapter title (may be empty)
+	Content  string // plain text content
+}
+
+// BookImporter handles PDF/EPUB file parsing and chapter extraction.
+// Used by the runner to import books from uploaded files.
+type BookImporter interface {
+	// Import extracts chapters from a PDF or EPUB file stored in MinIO.
+	// Returns the extracted chapters or an error.
+	Import(ctx context.Context, objectKey, fileType string) ([]Chapter, error)
+}
+
+// BookAdminStore covers admin-only operations for managing books in the catalogue.
+// All methods require admin authorisation at the HTTP handler level.
+type BookAdminStore interface {
+	// ArchiveBook sets archived=true on a book record, hiding it from all
+	// public search and catalogue responses. Returns ErrNotFound when the
+	// slug does not exist.
+	ArchiveBook(ctx context.Context, slug string) error
+
+	// UnarchiveBook clears archived on a book record, making it publicly
+	// visible again. Returns ErrNotFound when the slug does not exist.
+	UnarchiveBook(ctx context.Context, slug string) error
+
+	// DeleteBook permanently removes all data for a book:
+	//   - PocketBase books record
+	//   - All PocketBase chapters_idx records
+	//   - All MinIO chapter markdown objects ({slug}/chapter-*.md)
+	//   - MinIO cover image (covers/{slug}.jpg)
+	// The caller is responsible for also deleting the Meilisearch document.
+	DeleteBook(ctx context.Context, slug string) error
+}
+
+// ImportFileStore uploads raw import files to object storage.
+// Kept separate from BookImporter so the HTTP handler can upload the file
+// without a concrete type assertion, regardless of which Producer is wired.
+type ImportFileStore interface {
+	PutImportFile(ctx context.Context, objectKey string, data []byte) error
+	// PutImportChapters stores the pre-parsed chapters JSON under the given key.
+	PutImportChapters(ctx context.Context, key string, data []byte) error
+	// GetImportChapters retrieves the pre-parsed chapters JSON.
+	GetImportChapters(ctx context.Context, key string) ([]byte, error)
+}

backend/internal/cfai/image.go

@@ -4,17 +4,26 @@
 //
 //	POST https://api.cloudflare.com/client/v4/accounts/{accountID}/ai/run/{model}
 //	Authorization: Bearer {apiToken}
-//	Content-Type:  application/json
 //
-// Text-only request (all models):
+// FLUX.2 models (flux-2-dev, flux-2-klein-4b, flux-2-klein-9b):
 //
-//	{ "prompt": "...", "num_steps": 20 }
+//	Content-Type: multipart/form-data
+//	Fields: prompt, num_steps, width, height, guidance, image_b64 (optional)
+//	Response: { "image": "<base64 JPEG>" }
 //
-// Reference-image request:
-//   - FLUX models: { "prompt": "...", "image_b64": "<base64>" }
-//   - SD img2img:  { "prompt": "...", "image": [r,g,b,a,...], "strength": 0.75 }
+// Other models (flux-1-schnell, SDXL, SD 1.5):
 //
-// All models return raw PNG bytes on success (Content-Type: image/png).
+//	Content-Type: application/json
+//	Body: { "prompt": "...", "num_steps": 20 }
+//	Response: { "image": "<base64>" } or raw bytes depending on model
+//
+// Reference-image request (FLUX.2):
+//
+//	Same multipart form; include image_b64 field with base64-encoded reference.
+//
+// Reference-image request (SD img2img):
+//
+//	JSON body: { "prompt": "...", "image": [r,g,b,a,...], "strength": 0.75 }
 //
 // Recommended models for LibNovel:
 //   - Book covers (no reference): flux-2-dev, flux-2-klein-9b, lucid-origin
@@ -35,7 +44,9 @@ import (
 	"image/png"
 	_ "image/png" // register PNG decoder
 	"io"
+	"mime/multipart"
 	"net/http"
+	"strings"
 	"time"
 )
 
@@ -173,23 +184,43 @@ func NewImageGen(accountID, apiToken string) ImageGenClient {
 	}
 }
 
+// requiresMultipart reports whether the model requires a multipart/form-data
+// request body instead of JSON. FLUX.2 models on Cloudflare Workers AI changed
+// their API to require multipart and return {"image":"<base64>"} instead of
+// raw image bytes.
+func requiresMultipart(model ImageModel) bool {
+	switch model {
+	case ImageModelFlux2Dev, ImageModelFlux2Klein4B, ImageModelFlux2Klein9B:
+		return true
+	default:
+		return false
+	}
+}
+
 // GenerateImage generates an image from text only.
 func (c *imageGenHTTPClient) GenerateImage(ctx context.Context, req ImageRequest) ([]byte, error) {
 	req = applyImageDefaults(req)
-	body := map[string]any{
-		"prompt":    req.Prompt,
-		"num_steps": req.NumSteps,
+
+	// FLUX.2 multipart models use "steps"; JSON models use "num_steps".
+	stepsKey := "num_steps"
+	if requiresMultipart(req.Model) {
+		stepsKey = "steps"
+	}
+
+	fields := map[string]any{
+		"prompt": req.Prompt,
+		stepsKey: req.NumSteps,
 	}
 	if req.Width > 0 {
-		body["width"] = req.Width
+		fields["width"] = req.Width
 	}
 	if req.Height > 0 {
-		body["height"] = req.Height
+		fields["height"] = req.Height
 	}
 	if req.Guidance > 0 {
-		body["guidance"] = req.Guidance
+		fields["guidance"] = req.Guidance
 	}
-	return c.callImageAPI(ctx, req.Model, body)
+	return c.callImageAPI(ctx, req.Model, fields, nil)
 }
 
 // refImageMaxDim is the maximum dimension (width or height) for reference images
@@ -205,10 +236,37 @@ func (c *imageGenHTTPClient) GenerateImageFromReference(ctx context.Context, req
 	req = applyImageDefaults(req)
 
 	// Shrink the reference image if it exceeds the safe payload size.
-	// This avoids CF's 4 MB JSON body limit and reduces latency.
 	refImage = resizeRefImage(refImage, refImageMaxDim)
 
-	var body map[string]any
+	// FLUX.2 multipart models use "steps"; JSON models use "num_steps".
+	stepsKey := "num_steps"
+	if requiresMultipart(req.Model) {
+		stepsKey = "steps"
+	}
+
+	fields := map[string]any{
+		"prompt": req.Prompt,
+		stepsKey: req.NumSteps,
+	}
+	if req.Width > 0 {
+		fields["width"] = req.Width
+	}
+	if req.Height > 0 {
+		fields["height"] = req.Height
+	}
+	if req.Guidance > 0 {
+		fields["guidance"] = req.Guidance
+	}
+
+	if requiresMultipart(req.Model) {
+		// FLUX.2: reference image sent as base64 form field "image_b64".
+		fields["image_b64"] = base64.StdEncoding.EncodeToString(refImage)
+		if req.Strength > 0 {
+			fields["strength"] = req.Strength
+		}
+		return c.callImageAPI(ctx, req.Model, fields, nil)
+	}
+
 	if req.Model == ImageModelSD15Img2Img {
 		pixels, err := decodeImageToRGBA(refImage)
 		if err != nil {
@@ -218,33 +276,17 @@ func (c *imageGenHTTPClient) GenerateImageFromReference(ctx context.Context, req
 		if strength <= 0 {
 			strength = 0.75
 		}
-		body = map[string]any{
-			"prompt":    req.Prompt,
-			"image":     pixels,
-			"strength":  strength,
-			"num_steps": req.NumSteps,
-		}
-	} else {
-		b64 := base64.StdEncoding.EncodeToString(refImage)
-		body = map[string]any{
-			"prompt":    req.Prompt,
-			"image_b64": b64,
-			"num_steps": req.NumSteps,
-		}
-		if req.Strength > 0 {
-			body["strength"] = req.Strength
-		}
+		fields["image"] = pixels
+		fields["strength"] = strength
+		return c.callImageAPI(ctx, req.Model, fields, nil)
 	}
-	if req.Width > 0 {
-		body["width"] = req.Width
+
+	// Other FLUX models: image_b64 JSON field.
+	fields["image_b64"] = base64.StdEncoding.EncodeToString(refImage)
+	if req.Strength > 0 {
+		fields["strength"] = req.Strength
 	}
-	if req.Height > 0 {
-		body["height"] = req.Height
-	}
-	if req.Guidance > 0 {
-		body["guidance"] = req.Guidance
-	}
-	return c.callImageAPI(ctx, req.Model, body)
+	return c.callImageAPI(ctx, req.Model, fields, nil)
 }
 
 // Models returns all supported image model metadata.
@@ -252,19 +294,56 @@ func (c *imageGenHTTPClient) Models() []ImageModelInfo {
 	return AllImageModels()
 }
 
-func (c *imageGenHTTPClient) callImageAPI(ctx context.Context, model ImageModel, body map[string]any) ([]byte, error) {
-	encoded, err := json.Marshal(body)
-	if err != nil {
-		return nil, fmt.Errorf("cfai/image: marshal: %w", err)
-	}
-	url := fmt.Sprintf("https://api.cloudflare.com/client/v4/accounts/%s/ai/run/%s",
+func (c *imageGenHTTPClient) callImageAPI(ctx context.Context, model ImageModel, fields map[string]any, _ []byte) ([]byte, error) {
+	cfURL := fmt.Sprintf("https://api.cloudflare.com/client/v4/accounts/%s/ai/run/%s",
 		c.accountID, string(model))
-	req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewReader(encoded))
+
+	var (
+		bodyReader  io.Reader
+		contentType string
+	)
+
+	if requiresMultipart(model) {
+		// Build a multipart/form-data body from the fields map.
+		// All values are serialised to their string representation.
+		var buf bytes.Buffer
+		mw := multipart.NewWriter(&buf)
+		for k, v := range fields {
+			var strVal string
+			switch tv := v.(type) {
+			case string:
+				strVal = tv
+			default:
+				encoded, merr := json.Marshal(tv)
+				if merr != nil {
+					return nil, fmt.Errorf("cfai/image: marshal field %q: %w", k, merr)
+				}
+				strVal = strings.Trim(string(encoded), `"`)
+			}
+			if werr := mw.WriteField(k, strVal); werr != nil {
+				return nil, fmt.Errorf("cfai/image: write field %q: %w", k, werr)
+			}
+		}
+		if cerr := mw.Close(); cerr != nil {
+			return nil, fmt.Errorf("cfai/image: close multipart writer: %w", cerr)
+		}
+		bodyReader = &buf
+		contentType = mw.FormDataContentType()
+	} else {
+		encoded, merr := json.Marshal(fields)
+		if merr != nil {
+			return nil, fmt.Errorf("cfai/image: marshal: %w", merr)
+		}
+		bodyReader = bytes.NewReader(encoded)
+		contentType = "application/json"
+	}
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodPost, cfURL, bodyReader)
 	if err != nil {
 		return nil, fmt.Errorf("cfai/image: build request: %w", err)
 	}
 	req.Header.Set("Authorization", "Bearer "+c.apiToken)
-	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("Content-Type", contentType)
 
 	resp, err := c.http.Do(req)
 	if err != nil {
@@ -272,20 +351,38 @@ func (c *imageGenHTTPClient) callImageAPI(ctx context.Context, model ImageModel,
 	}
 	defer resp.Body.Close()
 
+	respBody, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return nil, fmt.Errorf("cfai/image: read response: %w", err)
+	}
+
 	if resp.StatusCode != http.StatusOK {
-		errBody, _ := io.ReadAll(resp.Body)
-		msg := string(errBody)
+		msg := string(respBody)
 		if len(msg) > 300 {
 			msg = msg[:300]
 		}
 		return nil, fmt.Errorf("cfai/image: model %s returned %d: %s", model, resp.StatusCode, msg)
 	}
 
-	data, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return nil, fmt.Errorf("cfai/image: read response: %w", err)
+	// Try to parse as {"image": "<base64>"} first (FLUX.2 and newer models).
+	// Fall back to treating the body as raw image bytes for legacy models.
+	var jsonResp struct {
+		Image string `json:"image"`
 	}
-	return data, nil
+	if jerr := json.Unmarshal(respBody, &jsonResp); jerr == nil && jsonResp.Image != "" {
+		imgBytes, decErr := base64.StdEncoding.DecodeString(jsonResp.Image)
+		if decErr != nil {
+			// Try raw (no padding) base64
+			imgBytes, decErr = base64.RawStdEncoding.DecodeString(jsonResp.Image)
+			if decErr != nil {
+				return nil, fmt.Errorf("cfai/image: decode base64 response: %w", decErr)
+			}
+		}
+		return imgBytes, nil
+	}
+
+	// Legacy: model returned raw image bytes directly.
+	return respBody, nil
 }
 
 func applyImageDefaults(req ImageRequest) ImageRequest {

backend/internal/domain/domain.go

@@ -24,6 +24,9 @@ type BookMeta struct {
 	// updated in PocketBase. Populated on read; not sent on write (PocketBase
 	// manages its own updated field).
 	MetaUpdated int64 `json:"meta_updated,omitempty"`
+	// Archived is true when the book has been soft-deleted by an admin.
+	// Archived books are excluded from all public search and catalogue responses.
+	Archived bool `json:"archived,omitempty"`
 }
 
 // CatalogueEntry is a lightweight book reference returned by catalogue pages.
@@ -170,6 +173,37 @@ type TranslationResult struct {
 	ErrorMessage string `json:"error_message,omitempty"`
 }
 
+// ImportTask represents a PDF/EPUB import job stored in PocketBase.
+type ImportTask struct {
+	ID               string     `json:"id"`
+	Slug             string     `json:"slug"` // derived from filename
+	Title            string     `json:"title"`
+	FileName         string     `json:"file_name"`
+	FileType         string     `json:"file_type"` // "pdf" or "epub"
+	ObjectKey        string     `json:"object_key,omitempty"` // MinIO path to uploaded file
+	ChaptersKey      string     `json:"chapters_key,omitempty"` // MinIO path to pre-parsed chapters JSON
+	Author           string     `json:"author,omitempty"`
+	CoverURL         string     `json:"cover_url,omitempty"`
+	Genres           []string   `json:"genres,omitempty"`
+	Summary          string     `json:"summary,omitempty"`
+	BookStatus       string     `json:"book_status,omitempty"` // "ongoing" | "completed" | "hiatus"
+	WorkerID         string     `json:"worker_id,omitempty"`
+	InitiatorUserID  string     `json:"initiator_user_id,omitempty"` // PocketBase user ID who submitted the import
+	Status           TaskStatus `json:"status"`
+	ChaptersDone     int        `json:"chapters_done"`
+	ChaptersTotal    int        `json:"chapters_total"`
+	ErrorMessage     string     `json:"error_message,omitempty"`
+	Started          time.Time  `json:"started"`
+	Finished         time.Time  `json:"finished,omitempty"`
+}
+
+// ImportResult is the outcome reported by the runner after finishing an ImportTask.
+type ImportResult struct {
+	Slug             string `json:"slug,omitempty"`
+	ChaptersImported int    `json:"chapters_imported"`
+	ErrorMessage     string `json:"error_message,omitempty"`
+}
+
 // AIJob represents an AI generation task tracked in PocketBase (ai_jobs collection).
 type AIJob struct {
 	ID string `json:"id"`

backend/internal/meili/client.go

@@ -32,11 +32,15 @@ type Client interface {
 	// BookExists reports whether a book with the given slug is already in the
 	// index. Used by the catalogue refresh to skip re-indexing known books.
 	BookExists(ctx context.Context, slug string) bool
+	// DeleteBook removes a book document from the search index by slug.
+	DeleteBook(ctx context.Context, slug string) error
 	// Search returns up to limit books matching query.
+	// Archived books are always excluded.
 	Search(ctx context.Context, query string, limit int) ([]domain.BookMeta, error)
 	// Catalogue queries books with optional filters, sort, and pagination.
 	// Returns books, the total hit count for pagination, and a FacetResult
 	// with available genre and status values from the index.
+	// Archived books are always excluded.
 	Catalogue(ctx context.Context, q CatalogueQuery) ([]domain.BookMeta, int64, FacetResult, error)
 }
 
@@ -99,7 +103,7 @@ func Configure(host, apiKey string) error {
 		return fmt.Errorf("meili: update searchable attributes: %w", err)
 	}
 
-	filterable := []interface{}{"status", "genres"}
+	filterable := []interface{}{"status", "genres", "archived"}
 	if _, err := idx.UpdateFilterableAttributes(&filterable); err != nil {
 		return fmt.Errorf("meili: update filterable attributes: %w", err)
 	}
@@ -128,6 +132,9 @@ type bookDoc struct {
 	// MetaUpdated is the Unix timestamp (seconds) of the last PocketBase update.
 	// Used for sort=update ("recently updated" ordering).
 	MetaUpdated int64 `json:"meta_updated"`
+	// Archived is true when the book has been soft-deleted by an admin.
+	// Used as a filter to exclude archived books from all search results.
+	Archived bool `json:"archived"`
 }
 
 func toDoc(b domain.BookMeta) bookDoc {
@@ -144,6 +151,7 @@ func toDoc(b domain.BookMeta) bookDoc {
 		Rank:          b.Ranking,
 		Rating:        b.Rating,
 		MetaUpdated:   b.MetaUpdated,
+		Archived:      b.Archived,
 	}
 }
 
@@ -161,6 +169,7 @@ func fromDoc(d bookDoc) domain.BookMeta {
 		Ranking:       d.Rank,
 		Rating:        d.Rating,
 		MetaUpdated:   d.MetaUpdated,
+		Archived:      d.Archived,
 	}
 }
 
@@ -184,13 +193,24 @@ func (c *MeiliClient) BookExists(_ context.Context, slug string) bool {
 	return err == nil && doc.Slug != ""
 }
 
+// DeleteBook removes a book document from the index by slug.
+// The operation is fire-and-forget (Meilisearch processes tasks asynchronously).
+func (c *MeiliClient) DeleteBook(_ context.Context, slug string) error {
+	if _, err := c.idx.DeleteDocument(slug, nil); err != nil {
+		return fmt.Errorf("meili: delete book %q: %w", slug, err)
+	}
+	return nil
+}
+
 // Search returns books matching query, up to limit results.
+// Archived books are always excluded.
 func (c *MeiliClient) Search(_ context.Context, query string, limit int) ([]domain.BookMeta, error) {
 	if limit <= 0 {
 		limit = 20
 	}
 	res, err := c.idx.Search(query, &meilisearch.SearchRequest{
-		Limit: int64(limit),
+		Limit:  int64(limit),
+		Filter: "archived = false",
 	})
 	if err != nil {
 		return nil, fmt.Errorf("meili: search %q: %w", query, err)
@@ -231,17 +251,15 @@ func (c *MeiliClient) Catalogue(_ context.Context, q CatalogueQuery) ([]domain.B
 		Facets: []string{"genres", "status"},
 	}
 
-	// Build filter
-	var filters []string
+	// Build filter — always exclude archived books
+	filters := []string{"archived = false"}
 	if q.Genre != "" && q.Genre != "all" {
 		filters = append(filters, fmt.Sprintf("genres = %q", q.Genre))
 	}
 	if q.Status != "" && q.Status != "all" {
 		filters = append(filters, fmt.Sprintf("status = %q", q.Status))
 	}
-	if len(filters) > 0 {
-		req.Filter = strings.Join(filters, " AND ")
-	}
+	req.Filter = strings.Join(filters, " AND ")
 
 	// Map UI sort tokens to Meilisearch sort expressions.
 	switch q.Sort {
@@ -318,7 +336,8 @@ func sortStrings(s []string) {
 type NoopClient struct{}
 
 func (NoopClient) UpsertBook(_ context.Context, _ domain.BookMeta) error { return nil }
-func (NoopClient) BookExists(_ context.Context, _ string) bool           { return false }
+func (NoopClient) BookExists(_ context.Context, _ string) bool            { return false }
+func (NoopClient) DeleteBook(_ context.Context, _ string) error           { return nil }
 func (NoopClient) Search(_ context.Context, _ string, _ int) ([]domain.BookMeta, error) {
 	return nil, nil
 }

backend/internal/runner/asynq_runner.go

@@ -54,6 +54,7 @@ func (r *Runner) runAsynq(ctx context.Context) error {
 	mux.HandleFunc(asynqqueue.TypeAudioGenerate, r.handleAudioTask)
 	mux.HandleFunc(asynqqueue.TypeScrapeBook, r.handleScrapeTask)
 	mux.HandleFunc(asynqqueue.TypeScrapeCatalogue, r.handleScrapeTask)
+	mux.HandleFunc(asynqqueue.TypeImportBook, r.handleImportTask)
 
 	// Register Asynq queue metrics with the default Prometheus registry so
 	// the /metrics endpoint (metrics.go) can expose them.
@@ -191,6 +192,25 @@ func (r *Runner) handleAudioTask(ctx context.Context, t *asynq.Task) error {
 	return nil
 }
 
+// handleImportTask is the Asynq handler for TypeImportBook (PDF/EPUB import).
+func (r *Runner) handleImportTask(ctx context.Context, t *asynq.Task) error {
+	var p asynqqueue.ImportPayload
+	if err := json.Unmarshal(t.Payload(), &p); err != nil {
+		return fmt.Errorf("unmarshal import payload: %w", err)
+	}
+	task := domain.ImportTask{
+		ID:          p.PBTaskID,
+		Slug:        p.Slug,
+		Title:       p.Title,
+		FileType:    p.FileType,
+		ChaptersKey: p.ChaptersKey,
+	}
+	r.tasksRunning.Add(1)
+	defer r.tasksRunning.Add(-1)
+	r.runImportTask(ctx, task, p.ObjectKey)
+	return nil
+}
+
 // pollTranslationTasks claims all available translation tasks from PocketBase
 // and dispatches them to goroutines. Translation tasks don't go through Redis/Asynq
 // because they're stored in PocketBase, so we need this separate poll loop.

backend/internal/runner/helpers.go

@@ -19,3 +19,53 @@ func stripMarkdown(src string) string {
 	src = regexp.MustCompile(`\n{3,}`).ReplaceAllString(src, "\n\n")
 	return strings.TrimSpace(src)
 }
+
+// chunkText splits text into chunks of at most maxChars characters, breaking
+// at sentence boundaries (". ", "! ", "? ", "\n") so that the TTS service
+// receives natural prose fragments rather than mid-sentence cuts.
+//
+// If a single sentence exceeds maxChars it is included as its own chunk —
+// never silently truncated.
+func chunkText(text string, maxChars int) []string {
+	if len(text) <= maxChars {
+		return []string{text}
+	}
+
+	// Sentence-boundary delimiters — we split AFTER these sequences.
+	// Order matters: longer sequences first.
+	delimiters := []string{".\n", "!\n", "?\n", ". ", "! ", "? ", "\n\n", "\n"}
+
+	var chunks []string
+	remaining := text
+
+	for len(remaining) > 0 {
+		if len(remaining) <= maxChars {
+			chunks = append(chunks, strings.TrimSpace(remaining))
+			break
+		}
+
+		// Find the last sentence boundary within the maxChars window.
+		window := remaining[:maxChars]
+		cutAt := -1
+		for _, delim := range delimiters {
+			idx := strings.LastIndex(window, delim)
+			if idx > 0 && idx+len(delim) > cutAt {
+				cutAt = idx + len(delim)
+			}
+		}
+
+		if cutAt <= 0 {
+			// No boundary found — hard-break at maxChars to avoid infinite loop.
+			cutAt = maxChars
+		}
+
+		chunk := strings.TrimSpace(remaining[:cutAt])
+		if chunk != "" {
+			chunks = append(chunks, chunk)
+		}
+		remaining = strings.TrimSpace(remaining[cutAt:])
+	}
+
+	return chunks
+}
+

backend/internal/runner/runner.go

@@ -15,6 +15,7 @@ package runner
 
 import (
 	"context"
+	"encoding/json"
 	"fmt"
 	"log/slog"
 	"os"
@@ -39,6 +40,21 @@ import (
 	"github.com/prometheus/client_golang/prometheus"
 )
 
+// Notifier creates notifications for users.
+type Notifier interface {
+	CreateNotification(ctx context.Context, userID, title, message, link string) error
+}
+
+// ChapterIngester persists imported chapters for a book.
+type ChapterIngester interface {
+	IngestChapters(ctx context.Context, slug string, chapters []bookstore.Chapter) error
+}
+
+// ImportChapterStore retrieves pre-parsed chapter JSON blobs from object storage.
+type ImportChapterStore interface {
+	GetImportChapters(ctx context.Context, key string) ([]byte, error)
+}
+
 // Config tunes the runner behaviour.
 type Config struct {
 	// WorkerID uniquely identifies this runner instance in PocketBase records.
@@ -103,6 +119,17 @@ type Dependencies struct {
 	TranslationStore bookstore.TranslationStore
 	// CoverStore stores book cover images in MinIO.
 	CoverStore bookstore.CoverStore
+	// BookImport handles PDF/EPUB file parsing and chapter extraction.
+	// Kept for backward compatibility when ChaptersKey is not set.
+	BookImport bookstore.BookImporter
+	// ImportChapterStore retrieves pre-parsed chapter JSON blobs from MinIO.
+	// When set and the task has a ChaptersKey, the runner reads from here
+	// instead of calling BookImport.Import() (the new preferred path).
+	ImportChapterStore ImportChapterStore
+	// ChapterIngester persists extracted chapters into MinIO/PocketBase.
+	ChapterIngester ChapterIngester
+	// Notifier creates notifications for users.
+	Notifier Notifier
 	// SearchIndex indexes books in Meilisearch after scraping.
 	// If nil a no-op is used.
 	SearchIndex meili.Client
@@ -225,6 +252,7 @@ func (r *Runner) runPoll(ctx context.Context) error {
 	scrapeSem := make(chan struct{}, r.cfg.MaxConcurrentScrape)
 	audioSem := make(chan struct{}, r.cfg.MaxConcurrentAudio)
 	translationSem := make(chan struct{}, r.cfg.MaxConcurrentTranslation)
+	importSem := make(chan struct{}, 1) // Limit concurrent imports
 	var wg sync.WaitGroup
 
 	tick := time.NewTicker(r.cfg.PollInterval)
@@ -244,7 +272,7 @@ func (r *Runner) runPoll(ctx context.Context) error {
 
 	// Run one poll immediately on startup, then on each tick.
 	for {
-		r.poll(ctx, scrapeSem, audioSem, translationSem, &wg)
+		r.poll(ctx, scrapeSem, audioSem, translationSem, importSem, &wg)
 
 		select {
 		case <-ctx.Done():
@@ -269,7 +297,7 @@ func (r *Runner) runPoll(ctx context.Context) error {
 }
 
 // poll claims all available pending tasks and dispatches them to goroutines.
-func (r *Runner) poll(ctx context.Context, scrapeSem, audioSem, translationSem chan struct{}, wg *sync.WaitGroup) {
+func (r *Runner) poll(ctx context.Context, scrapeSem, audioSem, translationSem, importSem chan struct{}, wg *sync.WaitGroup) {
 	// ── Heartbeat file ────────────────────────────────────────────────────
 	// Touch /tmp/runner.alive so the Docker health check can confirm the
 	// runner is actively polling. Failure is non-fatal — just log it.
@@ -385,6 +413,39 @@ translationLoop:
 			r.runTranslationTask(ctx, t)
 		}(task)
 	}
+
+	// ── Import tasks ─────────────────────────────────────────────────────
+importLoop:
+	for {
+		if ctx.Err() != nil {
+			return
+		}
+		select {
+		case importSem <- struct{}{}:
+			// Slot acquired — proceed to claim a task.
+		default:
+			// All slots busy; leave remaining pending tasks for next tick.
+			break importLoop
+		}
+		task, ok, err := r.deps.Consumer.ClaimNextImportTask(ctx, r.cfg.WorkerID)
+		if err != nil {
+			<-importSem
+			r.deps.Log.Error("runner: ClaimNextImportTask failed", "err", err)
+			break
+		}
+		if !ok {
+			<-importSem
+			break
+		}
+		r.tasksRunning.Add(1)
+		wg.Add(1)
+		go func(t domain.ImportTask) {
+			defer wg.Done()
+			defer func() { <-importSem }()
+			defer r.tasksRunning.Add(-1)
+			r.runImportTask(ctx, t, t.ObjectKey)
+		}(task)
+	}
 }
 
 // newOrchestrator builds an orchestrator with the Meilisearch post-hook wired in.
@@ -451,9 +512,21 @@ func (r *Runner) runScrapeTask(ctx context.Context, task domain.ScrapeTask) {
 	if result.ErrorMessage != "" {
 		r.tasksFailed.Add(1)
 		span.SetStatus(codes.Error, result.ErrorMessage)
+		if r.deps.Notifier != nil {
+			_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+				"Scrape Failed",
+				fmt.Sprintf("Scrape task (%s) failed: %s", task.Kind, result.ErrorMessage),
+				"/admin/tasks")
+		}
 	} else {
 		r.tasksCompleted.Add(1)
 		span.SetStatus(codes.Ok, "")
+		if r.deps.Notifier != nil {
+			_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+				"Scrape Complete",
+				fmt.Sprintf("Scraped %d chapters, skipped %d (%s)", result.ChaptersScraped, result.ChaptersSkipped, task.Kind),
+				"/admin/tasks")
+		}
 	}
 
 	log.Info("runner: scrape task finished",
@@ -533,6 +606,12 @@ func (r *Runner) runAudioTask(ctx context.Context, task domain.AudioTask) {
 		if err := r.deps.Consumer.FinishAudioTask(ctx, task.ID, result); err != nil {
 			log.Error("runner: FinishAudioTask failed", "err", err)
 		}
+		if r.deps.Notifier != nil {
+			_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+				"Audio Failed",
+				fmt.Sprintf("Ch.%d of %s (%s): %s", task.Chapter, task.Slug, task.Voice, msg),
+				fmt.Sprintf("/books/%s", task.Slug))
+		}
 	}
 
 	raw, err := r.deps.BookReader.ReadChapter(ctx, task.Slug, task.Chapter)
@@ -577,7 +656,7 @@ func (r *Runner) runAudioTask(ctx context.Context, task domain.AudioTask) {
 			return
 		}
 		var genErr error
-		audioData, genErr = r.deps.Kokoro.GenerateAudio(ctx, text, task.Voice)
+		audioData, genErr = kokoroGenerateChunked(ctx, r.deps.Kokoro, text, task.Voice, log)
 		if genErr != nil {
 			fail(fmt.Sprintf("kokoro generate: %v", genErr))
 			return
@@ -597,5 +676,173 @@ func (r *Runner) runAudioTask(ctx context.Context, task domain.AudioTask) {
 	if err := r.deps.Consumer.FinishAudioTask(ctx, task.ID, result); err != nil {
 		log.Error("runner: FinishAudioTask failed", "err", err)
 	}
+	if r.deps.Notifier != nil {
+		_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+			"Audio Ready",
+			fmt.Sprintf("Ch.%d of %s (%s) is ready", task.Chapter, task.Slug, task.Voice),
+			fmt.Sprintf("/books/%s", task.Slug))
+	}
 	log.Info("runner: audio task finished", "key", key)
 }
+
+// kokoroGenerateChunked splits text into ~1 000-character sentence-boundary
+// chunks, calls Kokoro.GenerateAudio for each, and concatenates the raw MP3
+// bytes. This avoids EOF / timeout failures that occur when the Kokoro
+// FastAPI server receives very large inputs (e.g. a full imported PDF chapter).
+//
+// Concatenating raw MP3 frames is valid — MP3 is a frame-based format and
+// standard players handle multi-segment files correctly.
+func kokoroGenerateChunked(ctx context.Context, k kokoro.Client, text, voice string, log *slog.Logger) ([]byte, error) {
+	const chunkSize = 1000
+
+	chunks := chunkText(text, chunkSize)
+	log.Info("runner: kokoro chunked generation", "chunks", len(chunks), "total_chars", len(text))
+
+	var combined []byte
+	for i, chunk := range chunks {
+		data, err := k.GenerateAudio(ctx, chunk, voice)
+		if err != nil {
+			return nil, fmt.Errorf("chunk %d/%d: %w", i+1, len(chunks), err)
+		}
+		combined = append(combined, data...)
+		log.Info("runner: kokoro chunk done", "chunk", i+1, "of", len(chunks), "bytes", len(data))
+	}
+	return combined, nil
+}
+
+// runImportTask executes one PDF/EPUB import task.
+// Preferred path: when task.ChaptersKey is set, it reads pre-parsed chapters
+// JSON from MinIO (written by the backend at upload time) and ingests them.
+// Fallback path: when ChaptersKey is empty, calls BookImport.Import() to
+// parse the raw file on the runner (legacy behaviour, not used for new tasks).
+func (r *Runner) runImportTask(ctx context.Context, task domain.ImportTask, objectKey string) {
+	ctx, span := otel.Tracer("runner").Start(ctx, "runner.import_task")
+	defer span.End()
+	span.SetAttributes(
+		attribute.String("task.id", task.ID),
+		attribute.String("book.slug", task.Slug),
+		attribute.String("file.type", task.FileType),
+		attribute.String("chapters_key", task.ChaptersKey),
+	)
+
+	log := r.deps.Log.With("task_id", task.ID, "slug", task.Slug, "file_type", task.FileType)
+	log.Info("runner: import task starting", "chapters_key", task.ChaptersKey)
+
+	hbCtx, hbCancel := context.WithCancel(ctx)
+	defer hbCancel()
+	go func() {
+		tick := time.NewTicker(r.cfg.HeartbeatInterval)
+		defer tick.Stop()
+		for {
+			select {
+			case <-hbCtx.Done():
+				return
+			case <-tick.C:
+				if err := r.deps.Consumer.HeartbeatTask(ctx, task.ID); err != nil {
+					log.Warn("runner: heartbeat failed", "err", err)
+				}
+			}
+		}
+	}()
+
+	fail := func(msg string) {
+		log.Error("runner: import task failed", "reason", msg)
+		r.tasksFailed.Add(1)
+		span.SetStatus(codes.Error, msg)
+		result := domain.ImportResult{ErrorMessage: msg}
+		if err := r.deps.Consumer.FinishImportTask(ctx, task.ID, result); err != nil {
+			log.Error("runner: FinishImportTask failed", "err", err)
+		}
+	}
+
+	var chapters []bookstore.Chapter
+
+	if task.ChaptersKey != "" && r.deps.ImportChapterStore != nil {
+		// New path: read pre-parsed chapters JSON uploaded by the backend.
+		raw, err := r.deps.ImportChapterStore.GetImportChapters(ctx, task.ChaptersKey)
+		if err != nil {
+			fail(fmt.Sprintf("get chapters JSON: %v", err))
+			return
+		}
+		if err := json.Unmarshal(raw, &chapters); err != nil {
+			fail(fmt.Sprintf("unmarshal chapters JSON: %v", err))
+			return
+		}
+		log.Info("runner: loaded pre-parsed chapters", "count", len(chapters))
+	} else {
+		// Legacy path: parse the raw file on the runner.
+		if r.deps.BookImport == nil {
+			fail("book import not configured (BookImport dependency missing)")
+			return
+		}
+		var err error
+		chapters, err = r.deps.BookImport.Import(ctx, objectKey, task.FileType)
+		if err != nil {
+			fail(fmt.Sprintf("import file: %v", err))
+			return
+		}
+		log.Info("runner: parsed chapters from file (legacy path)", "count", len(chapters))
+	}
+
+	if len(chapters) == 0 {
+		fail("no chapters extracted from file")
+		return
+	}
+
+	// Persist chapters via ChapterIngester.
+	if r.deps.ChapterIngester == nil {
+		fail("chapter ingester not configured")
+		return
+	}
+	if err := r.deps.ChapterIngester.IngestChapters(ctx, task.Slug, chapters); err != nil {
+		fail(fmt.Sprintf("store chapters: %v", err))
+		return
+	}
+
+	// Write book metadata so the book appears in PocketBase catalogue.
+	if r.deps.BookWriter != nil {
+		meta := domain.BookMeta{
+			Slug:          task.Slug,
+			Title:         task.Title,
+			Author:        task.Author,
+			Cover:         task.CoverURL,
+			Status:        task.BookStatus,
+			Genres:        task.Genres,
+			Summary:       task.Summary,
+			TotalChapters: len(chapters),
+		}
+		if meta.Status == "" {
+			meta.Status = "completed"
+		}
+		if err := r.deps.BookWriter.WriteMetadata(ctx, meta); err != nil {
+			log.Warn("runner: import task WriteMetadata failed (non-fatal)", "err", err)
+		} else {
+			// Index in Meilisearch so the book is searchable.
+			if err := r.deps.SearchIndex.UpsertBook(ctx, meta); err != nil {
+				log.Warn("runner: import task meilisearch upsert failed (non-fatal)", "err", err)
+			}
+		}
+	}
+
+	r.tasksCompleted.Add(1)
+	span.SetStatus(codes.Ok, "")
+	result := domain.ImportResult{
+		Slug:             task.Slug,
+		ChaptersImported: len(chapters),
+	}
+	if err := r.deps.Consumer.FinishImportTask(ctx, task.ID, result); err != nil {
+		log.Error("runner: FinishImportTask failed", "err", err)
+	}
+
+	// Notify the user who initiated the import.
+	if r.deps.Notifier != nil {
+		msg := fmt.Sprintf("Import completed: %d chapters from %s", len(chapters), task.Title)
+		targetUser := task.InitiatorUserID
+		if targetUser == "" {
+			targetUser = "admin"
+		}
+		_ = r.deps.Notifier.CreateNotification(ctx, targetUser, "Import Complete", msg, "/admin/import")
+	}
+
+	log.Info("runner: import task finished", "chapters", len(chapters))
+}

backend/internal/runner/runner_test.go

@@ -54,6 +54,10 @@ func (s *stubConsumer) ClaimNextTranslationTask(_ context.Context, _ string) (do
 	return domain.TranslationTask{}, false, nil
 }
 
+func (s *stubConsumer) ClaimNextImportTask(_ context.Context, _ string) (domain.ImportTask, bool, error) {
+	return domain.ImportTask{}, false, nil
+}
+
 func (s *stubConsumer) FinishScrapeTask(_ context.Context, id string, _ domain.ScrapeResult) error {
 	s.finished = append(s.finished, id)
 	return nil
@@ -69,6 +73,11 @@ func (s *stubConsumer) FinishTranslationTask(_ context.Context, id string, _ dom
 	return nil
 }
 
+func (s *stubConsumer) FinishImportTask(_ context.Context, id string, _ domain.ImportResult) error {
+	s.finished = append(s.finished, id)
+	return nil
+}
+
 func (s *stubConsumer) FailTask(_ context.Context, id, _ string) error {
 	s.failCalled = append(s.failCalled, id)
 	return nil

backend/internal/runner/translation.go

@@ -53,6 +53,12 @@ func (r *Runner) runTranslationTask(ctx context.Context, task domain.Translation
 		if err := r.deps.Consumer.FinishTranslationTask(ctx, task.ID, result); err != nil {
 			log.Error("runner: FinishTranslationTask failed", "err", err)
 		}
+		if r.deps.Notifier != nil {
+			_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+				"Translation Failed",
+				fmt.Sprintf("Ch.%d of %s (%s): %s", task.Chapter, task.Slug, task.Lang, msg),
+				fmt.Sprintf("/books/%s", task.Slug))
+		}
 	}
 
 	// Guard: LibreTranslate must be configured.
@@ -93,5 +99,11 @@ func (r *Runner) runTranslationTask(ctx context.Context, task domain.Translation
 	if err := r.deps.Consumer.FinishTranslationTask(ctx, task.ID, result); err != nil {
 		log.Error("runner: FinishTranslationTask failed", "err", err)
 	}
+	if r.deps.Notifier != nil {
+		_ = r.deps.Notifier.CreateNotification(ctx, "admin",
+			"Translation Ready",
+			fmt.Sprintf("Ch.%d of %s translated to %s", task.Chapter, task.Slug, task.Lang),
+			fmt.Sprintf("/books/%s", task.Slug))
+	}
 	log.Info("runner: translation task finished", "key", key)
 }

backend/internal/storage/import.go

@@ -0,0 +1,857 @@
+package storage
+
+import (
+	"archive/zip"
+	"bytes"
+	"context"
+	"fmt"
+	"io"
+	"os"
+	"sort"
+	"strconv"
+	"strings"
+
+	"github.com/libnovel/backend/internal/bookstore"
+	"github.com/libnovel/backend/internal/domain"
+	minio "github.com/minio/minio-go/v7"
+	"github.com/pdfcpu/pdfcpu/pkg/api"
+	"github.com/pdfcpu/pdfcpu/pkg/pdfcpu/model"
+	"golang.org/x/net/html"
+)
+
+type importer struct {
+	mc *minioClient
+}
+
+// NewBookImporter creates a BookImporter that reads files from MinIO.
+func NewBookImporter(s *Store) bookstore.BookImporter {
+	return &importer{mc: s.mc}
+}
+
+func (i *importer) Import(ctx context.Context, objectKey, fileType string) ([]bookstore.Chapter, error) {
+	if fileType != "pdf" && fileType != "epub" {
+		return nil, fmt.Errorf("unsupported file type: %s", fileType)
+	}
+
+	obj, err := i.mc.client.GetObject(ctx, "imports", objectKey, minio.GetObjectOptions{})
+	if err != nil {
+		return nil, fmt.Errorf("get object from minio: %w", err)
+	}
+	defer obj.Close()
+
+	data, err := io.ReadAll(obj)
+	if err != nil {
+		return nil, fmt.Errorf("read object: %w", err)
+	}
+
+	if fileType == "pdf" {
+		return parsePDF(data)
+	}
+	return parseEPUB(data)
+}
+
+// AnalyzeFile parses the given PDF or EPUB data and returns the detected
+// chapter count and up to 3 preview lines (first non-empty line of each of
+// the first 3 chapters). It is used by the analyze-only endpoint so users
+// can preview chapter count before committing the import.
+// Note: uses parsePDF which is backed by pdfcpu ExtractContent — fast, no hang risk.
+func AnalyzeFile(data []byte, fileType string) (chapterCount int, firstLines []string, err error) {
+	var chapters []bookstore.Chapter
+	switch fileType {
+	case "pdf":
+		chapters, err = parsePDF(data)
+	case "epub":
+		chapters, err = parseEPUB(data)
+	default:
+		return 0, nil, fmt.Errorf("unsupported file type: %s", fileType)
+	}
+	if err != nil {
+		return 0, nil, err
+	}
+	chapterCount = len(chapters)
+	for i, ch := range chapters {
+		if i >= 3 {
+			break
+		}
+		line := strings.TrimSpace(ch.Content)
+		if nl := strings.Index(line, "\n"); nl > 0 {
+			line = line[:nl]
+		}
+		if len(line) > 120 {
+			line = line[:120] + "…"
+		}
+		firstLines = append(firstLines, line)
+	}
+	return chapterCount, firstLines, nil
+}
+
+
+
+// decryptPDF strips encryption from a PDF using an empty user password.
+// Returns the decrypted bytes, or an error if decryption is not possible.
+// This handles the common case of "owner-only" encrypted PDFs (copy/print
+// restrictions) which use an empty user password and open normally in readers.
+func decryptPDF(data []byte) ([]byte, error) {
+	conf := model.NewDefaultConfiguration()
+	conf.UserPW = ""
+	conf.OwnerPW = ""
+
+	var out bytes.Buffer
+	err := api.Decrypt(bytes.NewReader(data), &out, conf)
+	if err != nil {
+		return nil, err
+	}
+	return out.Bytes(), nil
+}
+
+// ParseImportFile parses a PDF or EPUB and returns chapters.
+// Unlike AnalyzeFile it respects ctx cancellation so callers can apply a timeout.
+// For PDFs it first attempts to strip encryption with an empty password.
+func ParseImportFile(ctx context.Context, data []byte, fileType string) ([]bookstore.Chapter, error) {
+	type result struct {
+		chapters []bookstore.Chapter
+		err      error
+	}
+	ch := make(chan result, 1)
+	go func() {
+		var chapters []bookstore.Chapter
+		var err error
+		switch fileType {
+		case "pdf":
+			chapters, err = parsePDF(data)
+		case "epub":
+			chapters, err = parseEPUB(data)
+		default:
+			err = fmt.Errorf("unsupported file type: %s", fileType)
+		}
+		ch <- result{chapters, err}
+	}()
+	select {
+	case <-ctx.Done():
+		return nil, fmt.Errorf("parse timed out: %w", ctx.Err())
+	case r := <-ch:
+		return r.chapters, r.err
+	}
+}
+
+// pdfSkipBookmarks lists bookmark titles that are front/back matter, not story chapters.
+// These are skipped when building the chapter list.
+var pdfSkipBookmarks = map[string]bool{
+	"cover": true, "insert": true, "title page": true, "copyright": true,
+	"appendix": true, "color insert": true, "color illustrations": true,
+}
+
+// parsePDF extracts text from PDF bytes and returns it as a single chapter.
+//
+// The full readable text is returned as one chapter so the admin can manually
+// split it into chapters via the UI using --- markers.
+//
+// Strategy:
+//  1. Decrypt owner-protected PDFs (empty user password).
+//  2. Extract raw content streams for every page using pdfcpu ExtractContent.
+//  3. Concatenate text from all pages in order, skipping front matter
+//     (cover, title page, copyright — typically the first 10 pages).
+func parsePDF(data []byte) ([]bookstore.Chapter, error) {
+	// Decrypt owner-protected PDFs (empty user password).
+	decrypted, err := decryptPDF(data)
+	if err == nil {
+		data = decrypted
+	}
+
+	conf := model.NewDefaultConfiguration()
+	conf.UserPW = ""
+	conf.OwnerPW = ""
+
+	// Extract all page content streams to a temp directory.
+	tmpDir, err := os.MkdirTemp("", "pdf-extract-*")
+	if err != nil {
+		return nil, fmt.Errorf("create temp dir: %w", err)
+	}
+	defer os.RemoveAll(tmpDir)
+
+	if err := api.ExtractContent(bytes.NewReader(data), tmpDir, "out", nil, conf); err != nil {
+		return nil, fmt.Errorf("extract PDF content: %w", err)
+	}
+
+	entries, err := os.ReadDir(tmpDir)
+	if err != nil || len(entries) == 0 {
+		return nil, fmt.Errorf("PDF has no content pages")
+	}
+
+	// Parse page number from filename and build ordered text map.
+	pageTexts := make(map[int]string, len(entries))
+	maxPage := 0
+	for _, e := range entries {
+		pageNum := pageNumFromFilename(e.Name())
+		if pageNum <= 0 {
+			continue
+		}
+		raw, readErr := os.ReadFile(tmpDir + "/" + e.Name())
+		if readErr != nil {
+			continue
+		}
+		pageTexts[pageNum] = fixWin1252(extractTextFromContentStream(raw))
+		if pageNum > maxPage {
+			maxPage = pageNum
+		}
+	}
+
+	// Determine front-matter cutoff using bookmarks if available,
+	// otherwise skip the first 10 pages (cover/title/copyright).
+	bodyStart := 1
+	bookmarks, bmErr := api.Bookmarks(bytes.NewReader(data), conf)
+	if bmErr == nil {
+		for _, bm := range bookmarks {
+			title := strings.ToLower(strings.TrimSpace(bm.Title))
+			if !pdfSkipBookmarks[title] && bm.PageFrom > 0 {
+				// First non-front-matter bookmark — body starts here.
+				bodyStart = bm.PageFrom
+				break
+			}
+		}
+	} else if maxPage > 10 {
+		bodyStart = 11
+	}
+
+	// Concatenate all body pages.
+	var sb strings.Builder
+	for p := bodyStart; p <= maxPage; p++ {
+		t := strings.TrimSpace(pageTexts[p])
+		if t == "" {
+			continue
+		}
+		sb.WriteString(t)
+		sb.WriteString("\n\n")
+	}
+
+	text := strings.TrimSpace(sb.String())
+	if text == "" {
+		return nil, fmt.Errorf("could not extract any text from PDF")
+	}
+
+	return []bookstore.Chapter{{
+		Number:  1,
+		Title:   "Full Text",
+		Content: text,
+	}}, nil
+}
+
+// pageNumFromFilename extracts the page number from a pdfcpu content-stream
+// filename like "out_Content_page_42.txt". Returns 0 if not parseable.
+func pageNumFromFilename(name string) int {
+	// Strip directory prefix and extension.
+	base := name
+	if idx := strings.LastIndex(base, "/"); idx >= 0 {
+		base = base[idx+1:]
+	}
+	if idx := strings.LastIndex(base, "."); idx >= 0 {
+		base = base[:idx]
+	}
+	// Find last "_" and parse the number after it.
+	if idx := strings.LastIndex(base, "_"); idx >= 0 {
+		n, err := strconv.Atoi(base[idx+1:])
+		if err == nil && n > 0 {
+			return n
+		}
+	}
+	return 0
+}
+
+// win1252ToUnicode maps the Windows-1252 control range 0x80–0x9F to the
+// Unicode characters they actually represent in that encoding.
+// Standard Latin-1 maps these bytes to control characters; Win-1252 maps
+// them to typographic symbols that appear in publisher PDFs.
+var win1252ToUnicode = map[byte]rune{
+	0x80: '\u20AC', // €
+	0x82: '\u201A', // ‚
+	0x83: '\u0192', // ƒ
+	0x84: '\u201E', // „
+	0x85: '\u2026', // …
+	0x86: '\u2020', // †
+	0x87: '\u2021', // ‡
+	0x88: '\u02C6', // ˆ
+	0x89: '\u2030', // ‰
+	0x8A: '\u0160', // Š
+	0x8B: '\u2039', // ‹
+	0x8C: '\u0152', // Œ
+	0x8E: '\u017D', // Ž
+	0x91: '\u2018', // ' (left single quotation mark)
+	0x92: '\u2019', // ' (right single quotation mark / apostrophe)
+	0x93: '\u201C', // " (left double quotation mark)
+	0x94: '\u201D', // " (right double quotation mark)
+	0x95: '\u2022', // • (bullet)
+	0x96: '\u2013', // – (en dash)
+	0x97: '\u2014', // — (em dash)
+	0x98: '\u02DC', // ˜
+	0x99: '\u2122', // ™
+	0x9A: '\u0161', // š
+	0x9B: '\u203A', // ›
+	0x9C: '\u0153', // œ
+	0x9E: '\u017E', // ž
+	0x9F: '\u0178', // Ÿ
+}
+
+// fixWin1252 replaces Windows-1252 specific bytes (0x80–0x9F) in a string
+// that was decoded as raw Latin-1 bytes with their proper Unicode equivalents.
+func fixWin1252(s string) string {
+	// Fast path: if no bytes in 0x80–0x9F range, return unchanged.
+	needsFix := false
+	for i := 0; i < len(s); i++ {
+		b := s[i]
+		if b >= 0x80 && b <= 0x9F {
+			needsFix = true
+			break
+		}
+	}
+	if !needsFix {
+		return s
+	}
+	var sb strings.Builder
+	sb.Grow(len(s))
+	for i := 0; i < len(s); i++ {
+		b := s[i]
+		if b >= 0x80 && b <= 0x9F {
+			if r, ok := win1252ToUnicode[b]; ok {
+				sb.WriteRune(r)
+				continue
+			}
+		}
+		sb.WriteByte(b)
+	}
+	return sb.String()
+}
+
+// extractTextFromContentStream parses a raw PDF content stream and extracts
+// readable text from Tj and TJ operators.
+//
+// TJ arrays may contain a mix of literal strings (parenthesised) and hex glyph
+// arrays. Only the literal strings are decoded — hex arrays require per-font
+// ToUnicode CMaps and are skipped. Kerning adjustment numbers inside TJ arrays
+// are also ignored (they're just spacing hints).
+//
+// Line breaks are inserted on ET / Td / TD / T* operators.
+func extractTextFromContentStream(stream []byte) string {
+	s := string(stream)
+	var sb strings.Builder
+	i := 0
+	n := len(s)
+	for i < n {
+		// TJ array: [ ... ]TJ — collect all literal strings, skip hex & numbers.
+		if s[i] == '[' {
+			j := i + 1
+			for j < n && s[j] != ']' {
+				if s[j] == '(' {
+					// Literal string inside TJ array.
+					k := j + 1
+					depth := 1
+					for k < n && depth > 0 {
+						if s[k] == '\\' {
+							k += 2
+							continue
+						}
+						if s[k] == '(' {
+							depth++
+						} else if s[k] == ')' {
+							depth--
+						}
+						k++
+					}
+					lit := pdfUnescapeString(s[j+1 : k-1])
+					if hasPrintableASCII(lit) {
+						sb.WriteString(lit)
+					}
+					j = k
+					continue
+				}
+				j++
+			}
+			// Check if this is a TJ operator (skip whitespace after ']').
+			end := j + 1
+			for end < n && (s[end] == ' ' || s[end] == '\t' || s[end] == '\r' || s[end] == '\n') {
+				end++
+			}
+			if end+2 <= n && s[end:end+2] == "TJ" && (end+2 == n || !isAlphaNum(s[end+2])) {
+				i = end + 2
+				continue
+			}
+			i = j + 1
+			continue
+		}
+		// Single string: (string) Tj
+		if s[i] == '(' {
+			j := i + 1
+			depth := 1
+			for j < n && depth > 0 {
+				if s[j] == '\\' {
+					j += 2
+					continue
+				}
+				if s[j] == '(' {
+					depth++
+				} else if s[j] == ')' {
+					depth--
+				}
+				j++
+			}
+			lit := pdfUnescapeString(s[i+1 : j-1])
+			if hasPrintableASCII(lit) {
+				// Check for Tj operator.
+				end := j
+				for end < n && (s[end] == ' ' || s[end] == '\t') {
+					end++
+				}
+				if end+2 <= n && s[end:end+2] == "Tj" && (end+2 == n || !isAlphaNum(s[end+2])) {
+					sb.WriteString(lit)
+					i = end + 2
+					continue
+				}
+			}
+			i = j
+			continue
+		}
+		// Detect end of text object (ET) — add a newline.
+		if i+2 <= n && s[i:i+2] == "ET" && (i+2 == n || !isAlphaNum(s[i+2])) {
+			sb.WriteByte('\n')
+			i += 2
+			continue
+		}
+		// Detect Td / TD / T* — newline within text block.
+		if i+2 <= n && (s[i:i+2] == "Td" || s[i:i+2] == "TD" || s[i:i+2] == "T*") &&
+			(i+2 == n || !isAlphaNum(s[i+2])) {
+			sb.WriteByte('\n')
+			i += 2
+			continue
+		}
+		i++
+	}
+	return sb.String()
+}
+
+func isAlphaNum(b byte) bool {
+	return (b >= 'a' && b <= 'z') || (b >= 'A' && b <= 'Z') || (b >= '0' && b <= '9') || b == '_'
+}
+
+func hasPrintableASCII(s string) bool {
+	for _, c := range s {
+		if c >= 0x20 && c < 0x7F {
+			return true
+		}
+	}
+	return false
+}
+
+// pdfUnescapeString handles PDF string escape sequences.
+func pdfUnescapeString(s string) string {
+	if !strings.ContainsRune(s, '\\') {
+		return s
+	}
+	var sb strings.Builder
+	i := 0
+	for i < len(s) {
+		if s[i] == '\\' && i+1 < len(s) {
+			switch s[i+1] {
+			case 'n':
+				sb.WriteByte('\n')
+			case 'r':
+				sb.WriteByte('\r')
+			case 't':
+				sb.WriteByte('\t')
+			case '(', ')', '\\':
+				sb.WriteByte(s[i+1])
+			default:
+				// Octal escape \ddd
+				if s[i+1] >= '0' && s[i+1] <= '7' {
+					end := i + 2
+					for end < i+5 && end < len(s) && s[end] >= '0' && s[end] <= '7' {
+						end++
+					}
+					val, _ := strconv.ParseInt(s[i+1:end], 8, 16)
+					sb.WriteByte(byte(val))
+					i = end
+					continue
+				}
+				sb.WriteByte(s[i+1])
+			}
+			i += 2
+		} else {
+			sb.WriteByte(s[i])
+			i++
+		}
+	}
+	return sb.String()
+}
+
+// ── EPUB parsing ──────────────────────────────────────────────────────────────
+
+func parseEPUB(data []byte) ([]bookstore.Chapter, error) {
+	zr, err := zip.NewReader(bytes.NewReader(data), int64(len(data)))
+	if err != nil {
+		return nil, fmt.Errorf("open EPUB zip: %w", err)
+	}
+
+	// 1. Read META-INF/container.xml → find rootfile (content.opf path).
+	opfPath, err := epubRootfilePath(zr)
+	if err != nil {
+		return nil, fmt.Errorf("epub container: %w", err)
+	}
+
+	// 2. Parse content.opf → spine order of chapter files.
+	spineFiles, titleMap, err := epubSpine(zr, opfPath)
+	if err != nil {
+		return nil, fmt.Errorf("epub spine: %w", err)
+	}
+
+	if len(spineFiles) == 0 {
+		return nil, fmt.Errorf("EPUB spine is empty")
+	}
+
+	// Base directory of the OPF file for resolving relative hrefs.
+	opfDir := ""
+	if idx := strings.LastIndex(opfPath, "/"); idx >= 0 {
+		opfDir = opfPath[:idx+1]
+	}
+
+	var chapters []bookstore.Chapter
+	chNum := 0
+	for i, href := range spineFiles {
+		fullPath := opfDir + href
+		content, err := epubFileContent(zr, fullPath)
+		if err != nil {
+			continue
+		}
+		text := htmlToText(content)
+		if strings.TrimSpace(text) == "" {
+			continue
+		}
+		chNum++
+		title := titleMap[href]
+		if title == "" {
+			title = fmt.Sprintf("Chapter %d", chNum)
+		}
+		_ = i // spine index unused for numbering
+		chapters = append(chapters, bookstore.Chapter{
+			Number:  chNum,
+			Title:   title,
+			Content: text,
+		})
+	}
+
+	if len(chapters) == 0 {
+		return nil, fmt.Errorf("no readable chapters found in EPUB")
+	}
+	return chapters, nil
+}
+
+// epubRootfilePath parses META-INF/container.xml and returns the full-path
+// of the OPF package document.
+func epubRootfilePath(zr *zip.Reader) (string, error) {
+	f := zipFile(zr, "META-INF/container.xml")
+	if f == nil {
+		return "", fmt.Errorf("META-INF/container.xml not found")
+	}
+	rc, err := f.Open()
+	if err != nil {
+		return "", err
+	}
+	defer rc.Close()
+
+	doc, err := html.Parse(rc)
+	if err != nil {
+		return "", err
+	}
+
+	var path string
+	var walk func(*html.Node)
+	walk = func(n *html.Node) {
+		if n.Type == html.ElementNode && strings.EqualFold(n.Data, "rootfile") {
+			for _, a := range n.Attr {
+				if strings.EqualFold(a.Key, "full-path") {
+					path = a.Val
+					return
+				}
+			}
+		}
+		for c := n.FirstChild; c != nil; c = c.NextSibling {
+			walk(c)
+		}
+	}
+	walk(doc)
+
+	if path == "" {
+		return "", fmt.Errorf("rootfile full-path not found in container.xml")
+	}
+	return path, nil
+}
+
+// epubSpine parses the OPF document and returns the spine item hrefs in order,
+// plus a map from href → nav title (if available from NCX/NAV).
+func epubSpine(zr *zip.Reader, opfPath string) ([]string, map[string]string, error) {
+	f := zipFile(zr, opfPath)
+	if f == nil {
+		return nil, nil, fmt.Errorf("OPF file %q not found in EPUB", opfPath)
+	}
+	rc, err := f.Open()
+	if err != nil {
+		return nil, nil, err
+	}
+	defer rc.Close()
+
+	opfData, err := io.ReadAll(rc)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	// Build id→href map from <manifest>.
+	idToHref := make(map[string]string)
+	// Also keep a href→navTitle map (populated from NCX later).
+	hrefTitle := make(map[string]string)
+
+	// Parse OPF XML with html.Parse (handles malformed XML too).
+	doc, _ := html.Parse(bytes.NewReader(opfData))
+
+	var manifestItems []struct{ id, href, mediaType string }
+	var spineIdrefs []string
+	var ncxID string
+
+	var walk func(*html.Node)
+	walk = func(n *html.Node) {
+		if n.Type == html.ElementNode {
+			tag := strings.ToLower(n.Data)
+			switch tag {
+			case "item":
+				var id, href, mt string
+				for _, a := range n.Attr {
+					switch strings.ToLower(a.Key) {
+					case "id":
+						id = a.Val
+					case "href":
+						href = a.Val
+					case "media-type":
+						mt = a.Val
+					}
+				}
+				if id != "" && href != "" {
+					manifestItems = append(manifestItems, struct{ id, href, mediaType string }{id, href, mt})
+					idToHref[id] = href
+				}
+			case "itemref":
+				for _, a := range n.Attr {
+					if strings.ToLower(a.Key) == "idref" {
+						spineIdrefs = append(spineIdrefs, a.Val)
+					}
+				}
+			case "spine":
+				for _, a := range n.Attr {
+					if strings.ToLower(a.Key) == "toc" {
+						ncxID = a.Val
+					}
+				}
+			}
+		}
+		for c := n.FirstChild; c != nil; c = c.NextSibling {
+			walk(c)
+		}
+	}
+	walk(doc)
+
+	// Build ordered spine href list.
+	var spineHrefs []string
+	for _, idref := range spineIdrefs {
+		if href, ok := idToHref[idref]; ok {
+			spineHrefs = append(spineHrefs, href)
+		}
+	}
+
+	// If no explicit spine, fall back to all XHTML items in manifest order.
+	if len(spineHrefs) == 0 {
+		sort.Slice(manifestItems, func(i, j int) bool {
+			return manifestItems[i].href < manifestItems[j].href
+		})
+		for _, it := range manifestItems {
+			mt := strings.ToLower(it.mediaType)
+			if strings.Contains(mt, "html") || strings.HasSuffix(strings.ToLower(it.href), ".html") || strings.HasSuffix(strings.ToLower(it.href), ".xhtml") {
+				spineHrefs = append(spineHrefs, it.href)
+			}
+		}
+	}
+
+	// Try to get chapter titles from NCX (toc.ncx).
+	opfDir := ""
+	if idx := strings.LastIndex(opfPath, "/"); idx >= 0 {
+		opfDir = opfPath[:idx+1]
+	}
+	if ncxHref, ok := idToHref[ncxID]; ok {
+		ncxPath := opfDir + ncxHref
+		if ncxFile := zipFile(zr, ncxPath); ncxFile != nil {
+			if ncxRC, err := ncxFile.Open(); err == nil {
+				defer ncxRC.Close()
+				parseNCXTitles(ncxRC, hrefTitle)
+			}
+		}
+	}
+
+	return spineHrefs, hrefTitle, nil
+}
+
+// parseNCXTitles extracts navPoint label→src mappings from a toc.ncx.
+func parseNCXTitles(r io.Reader, out map[string]string) {
+	doc, err := html.Parse(r)
+	if err != nil {
+		return
+	}
+
+	// Collect navPoints: each has a <navLabel><text>…</text></navLabel> and
+	// a <content src="…"/> child.
+	var walk func(*html.Node)
+	walk = func(n *html.Node) {
+		if n.Type == html.ElementNode && strings.EqualFold(n.Data, "navpoint") {
+			var label, src string
+			var inner func(*html.Node)
+			inner = func(c *html.Node) {
+				if c.Type == html.ElementNode {
+					if strings.EqualFold(c.Data, "text") && label == "" {
+						if c.FirstChild != nil && c.FirstChild.Type == html.TextNode {
+							label = strings.TrimSpace(c.FirstChild.Data)
+						}
+					}
+					if strings.EqualFold(c.Data, "content") {
+						for _, a := range c.Attr {
+							if strings.EqualFold(a.Key, "src") {
+								// Strip fragment identifier (#...).
+								src = strings.SplitN(a.Val, "#", 2)[0]
+							}
+						}
+					}
+				}
+				for child := c.FirstChild; child != nil; child = child.NextSibling {
+					inner(child)
+				}
+			}
+			inner(n)
+			if label != "" && src != "" {
+				out[src] = label
+			}
+		}
+		for c := n.FirstChild; c != nil; c = c.NextSibling {
+			walk(c)
+		}
+	}
+	walk(doc)
+}
+
+// epubFileContent returns the raw bytes of a file inside the EPUB zip.
+func epubFileContent(zr *zip.Reader, path string) ([]byte, error) {
+	f := zipFile(zr, path)
+	if f == nil {
+		return nil, fmt.Errorf("file %q not in EPUB", path)
+	}
+	rc, err := f.Open()
+	if err != nil {
+		return nil, err
+	}
+	defer rc.Close()
+	return io.ReadAll(rc)
+}
+
+// zipFile finds a file by name (case-insensitive) in a zip.Reader.
+func zipFile(zr *zip.Reader, name string) *zip.File {
+	nameLower := strings.ToLower(name)
+	for _, f := range zr.File {
+		if strings.ToLower(f.Name) == nameLower {
+			return f
+		}
+	}
+	return nil
+}
+
+// htmlToText converts HTML/XHTML content to plain text suitable for storage.
+func htmlToText(data []byte) string {
+	doc, err := html.Parse(bytes.NewReader(data))
+	if err != nil {
+		return string(data)
+	}
+
+	var sb strings.Builder
+	var walk func(*html.Node)
+	walk = func(n *html.Node) {
+		if n.Type == html.TextNode {
+			text := strings.TrimSpace(n.Data)
+			if text != "" {
+				sb.WriteString(text)
+				sb.WriteByte(' ')
+			}
+		}
+		if n.Type == html.ElementNode {
+			switch strings.ToLower(n.Data) {
+			case "p", "div", "br", "h1", "h2", "h3", "h4", "h5", "h6", "li", "tr":
+				// Block-level: ensure newline before content.
+				if sb.Len() > 0 {
+					s := sb.String()
+					if s[len(s)-1] != '\n' {
+						sb.WriteByte('\n')
+					}
+				}
+			case "script", "style", "head":
+				// Skip entirely.
+				return
+			}
+		}
+		for c := n.FirstChild; c != nil; c = c.NextSibling {
+			walk(c)
+		}
+		if n.Type == html.ElementNode {
+			switch strings.ToLower(n.Data) {
+			case "p", "div", "h1", "h2", "h3", "h4", "h5", "h6", "li", "tr":
+				sb.WriteByte('\n')
+			}
+		}
+	}
+	walk(doc)
+
+	// Collapse multiple blank lines.
+	lines := strings.Split(sb.String(), "\n")
+	var out []string
+	blanks := 0
+	for _, l := range lines {
+		l = strings.TrimSpace(l)
+		if l == "" {
+			blanks++
+			if blanks <= 1 {
+				out = append(out, "")
+			}
+		} else {
+			blanks = 0
+			out = append(out, l)
+		}
+	}
+	return strings.TrimSpace(strings.Join(out, "\n"))
+}
+
+// ── Chapter ingestion ─────────────────────────────────────────────────────────
+
+// IngestChapters stores extracted chapters for a book.
+// Each chapter is written as a markdown file in the chapters MinIO bucket
+// and its index record is upserted in PocketBase via WriteChapter.
+func (s *Store) IngestChapters(ctx context.Context, slug string, chapters []bookstore.Chapter) error {
+	for _, ch := range chapters {
+		var mdContent string
+		if ch.Title != "" && ch.Title != fmt.Sprintf("Chapter %d", ch.Number) {
+			mdContent = fmt.Sprintf("# %s\n\n%s", ch.Title, ch.Content)
+		} else {
+			mdContent = fmt.Sprintf("# Chapter %d\n\n%s", ch.Number, ch.Content)
+		}
+		domainCh := domain.Chapter{
+			Ref:  domain.ChapterRef{Number: ch.Number, Title: ch.Title},
+			Text: mdContent,
+		}
+		if err := s.WriteChapter(ctx, slug, domainCh); err != nil {
+			return fmt.Errorf("ingest chapter %d: %w", ch.Number, err)
+		}
+	}
+	return nil
+}
+
+// GetImportObjectKey returns the MinIO object key for an uploaded import file.
+func GetImportObjectKey(filename string) string {
+	return fmt.Sprintf("imports/%s", filename)
+}

backend/internal/storage/minio.go

@@ -134,6 +134,12 @@ func CoverObjectKey(slug string) string {
 	return fmt.Sprintf("covers/%s.jpg", slug)
 }
 
+// ChapterImageObjectKey returns the MinIO object key for a chapter illustration.
+// Format: chapter-images/{slug}/{n:06d}.jpg
+func ChapterImageObjectKey(slug string, n int) string {
+	return fmt.Sprintf("chapter-images/%s/%06d.jpg", slug, n)
+}
+
 // TranslationObjectKey returns the MinIO object key for a translated chapter.
 // Format: {lang}/{slug}/{n:06d}.md
 func TranslationObjectKey(lang, slug string, n int) string {
@@ -265,3 +271,28 @@ func coverContentType(data []byte) string {
 	}
 	return "image/jpeg"
 }
+
+// ── Chapter image operations ───────────────────────────────────────────────────
+
+// putChapterImage stores a chapter illustration in the browse bucket.
+func (m *minioClient) putChapterImage(ctx context.Context, key, contentType string, data []byte) error {
+	return m.putObject(ctx, m.bucketBrowse, key, contentType, data)
+}
+
+// getChapterImage retrieves a chapter illustration. Returns (nil, false, nil)
+// when the object does not exist.
+func (m *minioClient) getChapterImage(ctx context.Context, key string) ([]byte, bool, error) {
+	if !m.objectExists(ctx, m.bucketBrowse, key) {
+		return nil, false, nil
+	}
+	data, err := m.getObject(ctx, m.bucketBrowse, key)
+	if err != nil {
+		return nil, false, err
+	}
+	return data, true, nil
+}
+
+// chapterImageExists returns true when the chapter image object exists.
+func (m *minioClient) chapterImageExists(ctx context.Context, key string) bool {
+	return m.objectExists(ctx, m.bucketBrowse, key)
+}

backend/internal/storage/store.go

@@ -54,6 +54,8 @@ var _ bookstore.ProgressStore = (*Store)(nil)
 var _ bookstore.CoverStore = (*Store)(nil)
 var _ bookstore.TranslationStore = (*Store)(nil)
 var _ bookstore.AIJobStore = (*Store)(nil)
+var _ bookstore.ChapterImageStore = (*Store)(nil)
+var _ bookstore.BookAdminStore = (*Store)(nil)
 var _ taskqueue.Producer = (*Store)(nil)
 var _ taskqueue.Consumer = (*Store)(nil)
 var _ taskqueue.Reader = (*Store)(nil)
@@ -225,6 +227,7 @@ type pbBook struct {
 	Ranking       int      `json:"ranking"`
 	Rating        float64  `json:"rating"`
 	Updated       string   `json:"updated"`
+	Archived      bool     `json:"archived"`
 }
 
 func (b pbBook) toDomain() domain.BookMeta {
@@ -245,6 +248,7 @@ func (b pbBook) toDomain() domain.BookMeta {
 		Ranking:       b.Ranking,
 		Rating:        b.Rating,
 		MetaUpdated:   metaUpdated,
+		Archived:      b.Archived,
 	}
 }
 
@@ -274,7 +278,7 @@ func (s *Store) ReadMetadata(ctx context.Context, slug string) (domain.BookMeta,
 }
 
 func (s *Store) ListBooks(ctx context.Context) ([]domain.BookMeta, error) {
-	items, err := s.pb.listAll(ctx, "books", "", "title")
+	items, err := s.pb.listAll(ctx, "books", "archived=false", "title")
 	if err != nil {
 		return nil, err
 	}
@@ -375,6 +379,84 @@ func (s *Store) ReindexChapters(ctx context.Context, slug string) (int, error) {
 	return count, nil
 }
 
+// ── BookAdminStore ────────────────────────────────────────────────────────────
+
+// ArchiveBook sets archived=true on the book record for slug.
+func (s *Store) ArchiveBook(ctx context.Context, slug string) error {
+	book, err := s.getBookBySlug(ctx, slug)
+	if err == ErrNotFound {
+		return ErrNotFound
+	}
+	if err != nil {
+		return fmt.Errorf("ArchiveBook: %w", err)
+	}
+	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/books/records/%s", book.ID),
+		map[string]any{"archived": true})
+}
+
+// UnarchiveBook clears archived on the book record for slug.
+func (s *Store) UnarchiveBook(ctx context.Context, slug string) error {
+	book, err := s.getBookBySlug(ctx, slug)
+	if err == ErrNotFound {
+		return ErrNotFound
+	}
+	if err != nil {
+		return fmt.Errorf("UnarchiveBook: %w", err)
+	}
+	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/books/records/%s", book.ID),
+		map[string]any{"archived": false})
+}
+
+// DeleteBook permanently removes all data for a book:
+//   - PocketBase books record
+//   - All PocketBase chapters_idx records for the slug
+//   - All MinIO chapter markdown objects ({slug}/chapter-*.md)
+//   - MinIO cover image (covers/{slug}.jpg)
+func (s *Store) DeleteBook(ctx context.Context, slug string) error {
+	// 1. Fetch the book record to get its PocketBase ID.
+	book, err := s.getBookBySlug(ctx, slug)
+	if err == ErrNotFound {
+		return ErrNotFound
+	}
+	if err != nil {
+		return fmt.Errorf("DeleteBook: fetch: %w", err)
+	}
+
+	// 2. Delete all chapters_idx records.
+	filter := fmt.Sprintf(`slug=%q`, slug)
+	items, err := s.pb.listAll(ctx, "chapters_idx", filter, "")
+	if err != nil && err != ErrNotFound {
+		return fmt.Errorf("DeleteBook: list chapters_idx: %w", err)
+	}
+	for _, raw := range items {
+		var rec struct {
+			ID string `json:"id"`
+		}
+		if json.Unmarshal(raw, &rec) == nil && rec.ID != "" {
+			if delErr := s.pb.delete(ctx, fmt.Sprintf("/api/collections/chapters_idx/records/%s", rec.ID)); delErr != nil {
+				s.log.Warn("DeleteBook: delete chapters_idx record failed", "slug", slug, "id", rec.ID, "err", delErr)
+			}
+		}
+	}
+
+	// 3. Delete MinIO chapter objects.
+	if err := s.mc.deleteObjects(ctx, s.mc.bucketChapters, slug+"/"); err != nil {
+		s.log.Warn("DeleteBook: delete chapter objects failed", "slug", slug, "err", err)
+	}
+
+	// 4. Delete MinIO cover image.
+	if err := s.mc.deleteObjects(ctx, s.mc.bucketBrowse, CoverObjectKey(slug)); err != nil {
+		s.log.Warn("DeleteBook: delete cover failed", "slug", slug, "err", err)
+	}
+
+	// 5. Delete the PocketBase books record.
+	if err := s.pb.delete(ctx, fmt.Sprintf("/api/collections/books/records/%s", book.ID)); err != nil {
+		return fmt.Errorf("DeleteBook: delete books record: %w", err)
+	}
+
+	return nil
+}
+
 // ── RankingStore ──────────────────────────────────────────────────────────────
 
 func (s *Store) WriteRankingItem(ctx context.Context, item domain.RankingItem) error {
@@ -646,6 +728,118 @@ func (s *Store) CreateTranslationTask(ctx context.Context, slug string, chapter
 	return rec.ID, nil
 }
 
+func (s *Store) CreateImportTask(ctx context.Context, task domain.ImportTask) (string, error) {
+	payload := map[string]any{
+		"slug":              task.Slug,
+		"title":             task.Title,
+		"file_name":         task.Slug + "." + task.FileType,
+		"file_type":         task.FileType,
+		"object_key":        task.ObjectKey,
+		"chapters_key":      task.ChaptersKey,
+		"author":            task.Author,
+		"cover_url":         task.CoverURL,
+		"summary":           task.Summary,
+		"book_status":       task.BookStatus,
+		"status":            string(domain.TaskStatusPending),
+		"chapters_done":     0,
+		"chapters_total":    task.ChaptersTotal,
+		"started":           time.Now().UTC().Format(time.RFC3339),
+		"initiator_user_id": task.InitiatorUserID,
+	}
+	if len(task.Genres) > 0 {
+		payload["genres"] = strings.Join(task.Genres, ",")
+	}
+	var rec struct {
+		ID string `json:"id"`
+	}
+	if err := s.pb.post(ctx, "/api/collections/import_tasks/records", payload, &rec); err != nil {
+		return "", err
+	}
+	return rec.ID, nil
+}
+
+// CreateNotification creates a notification record in PocketBase.
+func (s *Store) CreateNotification(ctx context.Context, userID, title, message, link string) error {
+	payload := map[string]any{
+		"user_id":  userID,
+		"title":     title,
+		"message":  message,
+		"link":     link,
+		"read":     false,
+		"created":  time.Now().UTC().Format(time.RFC3339),
+	}
+	return s.pb.post(ctx, "/api/collections/notifications/records", payload, nil)
+}
+
+// ListNotifications returns notifications for a user.
+func (s *Store) ListNotifications(ctx context.Context, userID string, limit int) ([]map[string]any, error) {
+	filter := fmt.Sprintf("user_id='%s'", userID)
+	items, err := s.pb.listAll(ctx, "notifications", filter, "-created")
+	if err != nil {
+		return nil, err
+	}
+	// Parse each json.RawMessage into a map
+	results := make([]map[string]any, 0, len(items))
+	for _, raw := range items {
+		var m map[string]any
+		if json.Unmarshal(raw, &m) == nil {
+			results = append(results, m)
+		}
+	}
+	if limit > 0 && len(results) > limit {
+		results = results[:limit]
+	}
+	return results, nil
+}
+
+// MarkNotificationRead marks a notification as read.
+func (s *Store) MarkNotificationRead(ctx context.Context, id string) error {
+	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/notifications/records/%s", id),
+		map[string]any{"read": true})
+}
+
+// DeleteNotification deletes a single notification by ID.
+func (s *Store) DeleteNotification(ctx context.Context, id string) error {
+	return s.pb.delete(ctx, fmt.Sprintf("/api/collections/notifications/records/%s", id))
+}
+
+// ClearAllNotifications deletes all notifications for a user.
+func (s *Store) ClearAllNotifications(ctx context.Context, userID string) error {
+	filter := fmt.Sprintf("user_id='%s'", userID)
+	items, err := s.pb.listAll(ctx, "notifications", filter, "")
+	if err != nil {
+		return fmt.Errorf("ClearAllNotifications list: %w", err)
+	}
+	for _, raw := range items {
+		var rec struct {
+			ID string `json:"id"`
+		}
+		if json.Unmarshal(raw, &rec) == nil && rec.ID != "" {
+			_ = s.pb.delete(ctx, fmt.Sprintf("/api/collections/notifications/records/%s", rec.ID))
+		}
+	}
+	return nil
+}
+
+// MarkAllNotificationsRead marks all notifications for a user as read.
+func (s *Store) MarkAllNotificationsRead(ctx context.Context, userID string) error {
+	filter := fmt.Sprintf("user_id='%s'&&read=false", userID)
+	items, err := s.pb.listAll(ctx, "notifications", filter, "")
+	if err != nil {
+		return fmt.Errorf("MarkAllNotificationsRead list: %w", err)
+	}
+	for _, raw := range items {
+		var rec struct {
+			ID string `json:"id"`
+		}
+		if json.Unmarshal(raw, &rec) == nil && rec.ID != "" {
+			_ = s.pb.patch(ctx, fmt.Sprintf("/api/collections/notifications/records/%s", rec.ID),
+				map[string]any{"read": true})
+		}
+	}
+	return nil
+}
+
 func (s *Store) CancelTask(ctx context.Context, id string) error {
 	// Try scraping_tasks first, then audio_jobs, then translation_jobs.
 	if err := s.pb.patch(ctx, fmt.Sprintf("/api/collections/scraping_tasks/records/%s", id),
@@ -720,6 +914,18 @@ func (s *Store) ClaimNextTranslationTask(ctx context.Context, workerID string) (
 	return task, err == nil, err
 }
 
+func (s *Store) ClaimNextImportTask(ctx context.Context, workerID string) (domain.ImportTask, bool, error) {
+	raw, err := s.pb.claimRecord(ctx, "import_tasks", workerID, nil)
+	if err != nil {
+		return domain.ImportTask{}, false, err
+	}
+	if raw == nil {
+		return domain.ImportTask{}, false, nil
+	}
+	task, err := parseImportTask(raw)
+	return task, err == nil, err
+}
+
 func (s *Store) FinishScrapeTask(ctx context.Context, id string, result domain.ScrapeResult) error {
 	status := string(domain.TaskStatusDone)
 	if result.ErrorMessage != "" {
@@ -760,6 +966,20 @@ func (s *Store) FinishTranslationTask(ctx context.Context, id string, result dom
 	})
 }
 
+func (s *Store) FinishImportTask(ctx context.Context, id string, result domain.ImportResult) error {
+	status := string(domain.TaskStatusDone)
+	if result.ErrorMessage != "" {
+		status = string(domain.TaskStatusFailed)
+	}
+	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/import_tasks/records/%s", id), map[string]any{
+		"status":           status,
+		"chapters_done":    result.ChaptersImported,
+		"chapters_total":   result.ChaptersImported,
+		"error_message":    result.ErrorMessage,
+		"finished":         time.Now().UTC().Format(time.RFC3339),
+	})
+}
+
 func (s *Store) FailTask(ctx context.Context, id, errMsg string) error {
 	payload := map[string]any{
 		"status":        string(domain.TaskStatusFailed),
@@ -776,7 +996,7 @@ func (s *Store) FailTask(ctx context.Context, id, errMsg string) error {
 }
 
 // HeartbeatTask updates the heartbeat_at field on a running task.
-// Tries scraping_tasks first, then audio_jobs, then translation_jobs.
+// Tries scraping_tasks, audio_jobs, translation_jobs, then import_tasks.
 func (s *Store) HeartbeatTask(ctx context.Context, id string) error {
 	payload := map[string]any{
 		"heartbeat_at": time.Now().UTC().Format(time.RFC3339),
@@ -787,7 +1007,10 @@ func (s *Store) HeartbeatTask(ctx context.Context, id string) error {
 	if err := s.pb.patch(ctx, fmt.Sprintf("/api/collections/audio_jobs/records/%s", id), payload); err == nil {
 		return nil
 	}
-	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/translation_jobs/records/%s", id), payload)
+	if err := s.pb.patch(ctx, fmt.Sprintf("/api/collections/translation_jobs/records/%s", id), payload); err == nil {
+		return nil
+	}
+	return s.pb.patch(ctx, fmt.Sprintf("/api/collections/import_tasks/records/%s", id), payload)
 }
 
 // ReapStaleTasks finds all running tasks whose heartbeat_at is either missing
@@ -805,7 +1028,7 @@ func (s *Store) ReapStaleTasks(ctx context.Context, staleAfter time.Duration) (i
 	}
 
 	total := 0
-	for _, collection := range []string{"scraping_tasks", "audio_jobs", "translation_jobs"} {
+	for _, collection := range []string{"scraping_tasks", "audio_jobs", "translation_jobs", "import_tasks"} {
 		items, err := s.pb.listAll(ctx, collection, filter, "")
 		if err != nil {
 			return total, fmt.Errorf("ReapStaleTasks list %s: %w", collection, err)
@@ -898,8 +1121,7 @@ func (s *Store) ListTranslationTasks(ctx context.Context) ([]domain.TranslationT
 }
 
 func (s *Store) GetTranslationTask(ctx context.Context, cacheKey string) (domain.TranslationTask, bool, error) {
-	filter := fmt.Sprintf(`cache_key='%s'`, cacheKey)
-	items, err := s.pb.listAll(ctx, "translation_jobs", filter, "-started")
+	items, err := s.pb.listAll(ctx, "translation_jobs", fmt.Sprintf("cache_key=%q", cacheKey), "-started")
 	if err != nil || len(items) == 0 {
 		return domain.TranslationTask{}, false, err
 	}
@@ -907,6 +1129,33 @@ func (s *Store) GetTranslationTask(ctx context.Context, cacheKey string) (domain
 	return t, err == nil, err
 }
 
+func (s *Store) ListImportTasks(ctx context.Context) ([]domain.ImportTask, error) {
+	items, err := s.pb.listAll(ctx, "import_tasks", "", "-started")
+	if err != nil {
+		return nil, err
+	}
+	tasks := make([]domain.ImportTask, 0, len(items))
+	for _, raw := range items {
+		t, err := parseImportTask(raw)
+		if err == nil {
+			tasks = append(tasks, t)
+		}
+	}
+	return tasks, nil
+}
+
+func (s *Store) GetImportTask(ctx context.Context, id string) (domain.ImportTask, bool, error) {
+	var raw json.RawMessage
+	if err := s.pb.get(ctx, fmt.Sprintf("/api/collections/import_tasks/records/%s", id), &raw); err != nil {
+		if err == ErrNotFound {
+			return domain.ImportTask{}, false, nil
+		}
+		return domain.ImportTask{}, false, err
+	}
+	t, err := parseImportTask(raw)
+	return t, err == nil, err
+}
+
 // ── Parsers ───────────────────────────────────────────────────────────────────
 
 func parseScrapeTask(raw json.RawMessage) (domain.ScrapeTask, error) {
@@ -1013,6 +1262,66 @@ func parseTranslationTask(raw json.RawMessage) (domain.TranslationTask, error) {
 	}, nil
 }
 
+func parseImportTask(raw json.RawMessage) (domain.ImportTask, error) {
+	var rec struct {
+		ID              string `json:"id"`
+		Slug            string `json:"slug"`
+		Title           string `json:"title"`
+		FileName        string `json:"file_name"`
+		FileType        string `json:"file_type"`
+		ObjectKey       string `json:"object_key"`
+		ChaptersKey     string `json:"chapters_key"`
+		Author          string `json:"author"`
+		CoverURL        string `json:"cover_url"`
+		Genres          string `json:"genres"` // stored as comma-separated
+		Summary         string `json:"summary"`
+		BookStatus      string `json:"book_status"`
+		WorkerID        string `json:"worker_id"`
+		InitiatorUserID string `json:"initiator_user_id"`
+		Status          string `json:"status"`
+		ChaptersDone    int    `json:"chapters_done"`
+		ChaptersTotal   int    `json:"chapters_total"`
+		ErrorMessage    string `json:"error_message"`
+		Started         string `json:"started"`
+		Finished        string `json:"finished"`
+	}
+	if err := json.Unmarshal(raw, &rec); err != nil {
+		return domain.ImportTask{}, err
+	}
+	started, _ := time.Parse(time.RFC3339, rec.Started)
+	finished, _ := time.Parse(time.RFC3339, rec.Finished)
+	var genres []string
+	if rec.Genres != "" {
+		for _, g := range strings.Split(rec.Genres, ",") {
+			if g = strings.TrimSpace(g); g != "" {
+				genres = append(genres, g)
+			}
+		}
+	}
+	return domain.ImportTask{
+		ID:              rec.ID,
+		Slug:            rec.Slug,
+		Title:           rec.Title,
+		FileName:        rec.FileName,
+		FileType:        rec.FileType,
+		ObjectKey:       rec.ObjectKey,
+		ChaptersKey:     rec.ChaptersKey,
+		Author:          rec.Author,
+		CoverURL:        rec.CoverURL,
+		Genres:          genres,
+		Summary:         rec.Summary,
+		BookStatus:      rec.BookStatus,
+		WorkerID:        rec.WorkerID,
+		InitiatorUserID: rec.InitiatorUserID,
+		Status:          domain.TaskStatus(rec.Status),
+		ChaptersDone:    rec.ChaptersDone,
+		ChaptersTotal:   rec.ChaptersTotal,
+		ErrorMessage:    rec.ErrorMessage,
+		Started:         started,
+		Finished:        finished,
+	}, nil
+}
+
 // ── CoverStore ─────────────────────────────────────────────────────────────────
 
 func (s *Store) PutCover(ctx context.Context, slug string, data []byte, contentType string) error {
@@ -1039,10 +1348,59 @@ func (s *Store) GetCover(ctx context.Context, slug string) ([]byte, string, bool
 	return data, ct, true, nil
 }
 
+// PutImportFile stores an uploaded import file (PDF/EPUB) in MinIO.
+func (s *Store) PutImportFile(ctx context.Context, key string, data []byte) error {
+	return s.mc.putObject(ctx, "imports", key, "application/octet-stream", data)
+}
+
+// PutImportChapters stores a pre-parsed chapters JSON blob in MinIO.
+func (s *Store) PutImportChapters(ctx context.Context, key string, data []byte) error {
+	return s.mc.putObject(ctx, "imports", key, "application/json", data)
+}
+
+// GetImportChapters retrieves the pre-parsed chapters JSON from MinIO.
+func (s *Store) GetImportChapters(ctx context.Context, key string) ([]byte, error) {
+	data, err := s.mc.getObject(ctx, "imports", key)
+	if err != nil {
+		return nil, fmt.Errorf("get chapters object: %w", err)
+	}
+	return data, nil
+}
+
 func (s *Store) CoverExists(ctx context.Context, slug string) bool {
 	return s.mc.coverExists(ctx, CoverObjectKey(slug))
 }
 
+// ── ChapterImageStore ──────────────────────────────────────────────────────────
+
+func (s *Store) PutChapterImage(ctx context.Context, slug string, n int, data []byte, contentType string) error {
+	key := ChapterImageObjectKey(slug, n)
+	if contentType == "" {
+		contentType = coverContentType(data)
+	}
+	if err := s.mc.putChapterImage(ctx, key, contentType, data); err != nil {
+		return fmt.Errorf("PutChapterImage: %w", err)
+	}
+	return nil
+}
+
+func (s *Store) GetChapterImage(ctx context.Context, slug string, n int) ([]byte, string, bool, error) {
+	key := ChapterImageObjectKey(slug, n)
+	data, ok, err := s.mc.getChapterImage(ctx, key)
+	if err != nil {
+		return nil, "", false, fmt.Errorf("GetChapterImage: %w", err)
+	}
+	if !ok {
+		return nil, "", false, nil
+	}
+	ct := coverContentType(data)
+	return data, ct, true, nil
+}
+
+func (s *Store) ChapterImageExists(ctx context.Context, slug string, n int) bool {
+	return s.mc.chapterImageExists(ctx, ChapterImageObjectKey(slug, n))
+}
+
 // ── TranslationStore ───────────────────────────────────────────────────────────
 
 func (s *Store) TranslationObjectKey(lang, slug string, n int) string {

backend/internal/taskqueue/taskqueue.go

@@ -33,6 +33,11 @@ type Producer interface {
 	// returns the assigned PocketBase record ID.
 	CreateTranslationTask(ctx context.Context, slug string, chapter int, lang string) (string, error)
 
+	// CreateImportTask inserts a new import task with status=pending and
+	// returns the assigned PocketBase record ID.
+	// The task struct must have at minimum Slug, Title, FileType, and ObjectKey set.
+	CreateImportTask(ctx context.Context, task domain.ImportTask) (string, error)
+
 	// CancelTask transitions a pending task to status=cancelled.
 	// Returns ErrNotFound if the task does not exist.
 	CancelTask(ctx context.Context, id string) error
@@ -59,6 +64,11 @@ type Consumer interface {
 	// Returns (zero, false, nil) when the queue is empty.
 	ClaimNextTranslationTask(ctx context.Context, workerID string) (domain.TranslationTask, bool, error)
 
+	// ClaimNextImportTask atomically finds the oldest pending import task,
+	// sets its status=running and worker_id=workerID, and returns it.
+	// Returns (zero, false, nil) when the queue is empty.
+	ClaimNextImportTask(ctx context.Context, workerID string) (domain.ImportTask, bool, error)
+
 	// FinishScrapeTask marks a running scrape task as done and records the result.
 	FinishScrapeTask(ctx context.Context, id string, result domain.ScrapeResult) error
 
@@ -68,6 +78,9 @@ type Consumer interface {
 	// FinishTranslationTask marks a running translation task as done and records the result.
 	FinishTranslationTask(ctx context.Context, id string, result domain.TranslationResult) error
 
+	// FinishImportTask marks a running import task as done and records the result.
+	FinishImportTask(ctx context.Context, id string, result domain.ImportResult) error
+
 	// FailTask marks a task (scrape, audio, or translation) as failed with an error message.
 	FailTask(ctx context.Context, id, errMsg string) error
 
@@ -104,4 +117,11 @@ type Reader interface {
 	// GetTranslationTask returns the most recent translation task for cacheKey.
 	// Returns (zero, false, nil) if not found.
 	GetTranslationTask(ctx context.Context, cacheKey string) (domain.TranslationTask, bool, error)
+
+	// ListImportTasks returns all import tasks sorted by started descending.
+	ListImportTasks(ctx context.Context) ([]domain.ImportTask, error)
+
+	// GetImportTask returns a single import task by ID.
+	// Returns (zero, false, nil) if not found.
+	GetImportTask(ctx context.Context, id string) (domain.ImportTask, bool, error)
 }

backend/internal/taskqueue/taskqueue_test.go

@@ -26,6 +26,9 @@ func (s *stubStore) CreateAudioTask(_ context.Context, _ string, _ int, _ string
 func (s *stubStore) CreateTranslationTask(_ context.Context, _ string, _ int, _ string) (string, error) {
 	return "translation-1", nil
 }
+func (s *stubStore) CreateImportTask(_ context.Context, _ domain.ImportTask) (string, error) {
+	return "import-1", nil
+}
 func (s *stubStore) CancelTask(_ context.Context, _ string) error                    { return nil }
 func (s *stubStore) CancelAudioTasksBySlug(_ context.Context, _ string) (int, error) { return 0, nil }
 
@@ -38,6 +41,9 @@ func (s *stubStore) ClaimNextAudioTask(_ context.Context, _ string) (domain.Audi
 func (s *stubStore) ClaimNextTranslationTask(_ context.Context, _ string) (domain.TranslationTask, bool, error) {
 	return domain.TranslationTask{ID: "translation-1", Status: domain.TaskStatusRunning}, true, nil
 }
+func (s *stubStore) ClaimNextImportTask(_ context.Context, _ string) (domain.ImportTask, bool, error) {
+	return domain.ImportTask{ID: "import-1", Status: domain.TaskStatusRunning}, true, nil
+}
 func (s *stubStore) FinishScrapeTask(_ context.Context, _ string, _ domain.ScrapeResult) error {
 	return nil
 }
@@ -47,6 +53,9 @@ func (s *stubStore) FinishAudioTask(_ context.Context, _ string, _ domain.AudioR
 func (s *stubStore) FinishTranslationTask(_ context.Context, _ string, _ domain.TranslationResult) error {
 	return nil
 }
+func (s *stubStore) FinishImportTask(_ context.Context, _ string, _ domain.ImportResult) error {
+	return nil
+}
 func (s *stubStore) FailTask(_ context.Context, _, _ string) error { return nil }
 
 func (s *stubStore) HeartbeatTask(_ context.Context, _ string) error { return nil }
@@ -69,6 +78,10 @@ func (s *stubStore) ListTranslationTasks(_ context.Context) ([]domain.Translatio
 func (s *stubStore) GetTranslationTask(_ context.Context, _ string) (domain.TranslationTask, bool, error) {
 	return domain.TranslationTask{}, false, nil
 }
+func (s *stubStore) ListImportTasks(_ context.Context) ([]domain.ImportTask, error) { return nil, nil }
+func (s *stubStore) GetImportTask(_ context.Context, _ string) (domain.ImportTask, bool, error) {
+	return domain.ImportTask{}, false, nil
+}
 
 // Verify the stub satisfies all three interfaces at compile time.
 var _ taskqueue.Producer = (*stubStore)(nil)

docker-compose.yml

@@ -58,6 +58,8 @@ services:
         mc mb --ignore-existing local/audio;
         mc mb --ignore-existing local/avatars;
         mc mb --ignore-existing local/catalogue;
+        mc mb --ignore-existing local/translations;
+        mc mb --ignore-existing local/imports;
         echo 'buckets ready';
       "
     environment:
@@ -307,6 +309,8 @@ services:
       # OpenTelemetry tracing
       OTEL_EXPORTER_OTLP_ENDPOINT: "${OTEL_EXPORTER_OTLP_ENDPOINT}"
       OTEL_SERVICE_NAME: "ui"
+      # Allow large PDF/EPUB uploads (adapter-node default is 512KB)
+      BODY_SIZE_LIMIT: "52428800"
       # OAuth2 providers
       GOOGLE_CLIENT_ID: "${GOOGLE_CLIENT_ID}"
       GOOGLE_CLIENT_SECRET: "${GOOGLE_CLIENT_SECRET}"

homelab/docker-compose.yml

@@ -84,8 +84,10 @@ services:
       LOG_LEVEL: "${LOG_LEVEL}"
       GLITCHTIP_DSN: "${GLITCHTIP_DSN_RUNNER}"
 
-      # OTel — send runner traces/metrics to the local collector (HTTP)
-      OTEL_EXPORTER_OTLP_ENDPOINT: "http://otel-collector:4318"
+      # OTel — send runner traces/logs to Alloy (HTTP)
+      # Alloy forwards traces → OTel collector → Tempo
+      #                   logs → Loki
+      OTEL_EXPORTER_OTLP_ENDPOINT: "http://alloy:4318"
       OTEL_SERVICE_NAME: "runner"
 
     healthcheck:
@@ -370,6 +372,7 @@ services:
     expose:
       - "12347"  # Faro HTTP receiver (POST /collect)
       - "12348"  # Alloy UI / health endpoint
+      - "4318"   # OTLP receiver (HTTP) for backend/runner logs
     depends_on:
       - otel-collector
       - loki
@@ -382,9 +385,9 @@ services:
     volumes:
       - ./otel/collector.yaml:/etc/otelcol-contrib/config.yaml:ro
     expose:
-      - "4317"  # OTLP gRPC
-      - "4318"  # OTLP HTTP
-      - "8888"  # Collector self-metrics (scraped by Prometheus)
+      - "14317"  # OTLP gRPC (Alloy forwards traces here)
+      - "14318"  # OTLP HTTP (Alloy forwards traces here)
+      - "8888"   # Collector self-metrics (scraped by Prometheus)
     depends_on:
       - tempo
       - prometheus

homelab/otel/alloy.river

@@ -1,15 +1,19 @@
-// Grafana Alloy — Faro RUM receiver
+// Grafana Alloy — Faro RUM receiver + OTel log bridge
 //
 // Receives browser telemetry (Web Vitals, traces, logs, exceptions) from the
 // LibNovel SvelteKit frontend via the @grafana/faro-web-sdk.
 //
+// Also receives OTLP logs from the backend and runner services, and forwards
+// them to Loki in the native push format (solving the OTLP→Loki gap).
+//
 // Pipeline:
-//   faro.receiver  → receives HTTP POST /collect from browsers
+//   faro.receiver     → receives HTTP POST /collect from browsers
+//   otelcol.receiver.otlp → receives OTLP logs from backend/runner (HTTP :4318)
 //   otelcol.exporter.otlphttp → forwards traces to OTel Collector → Tempo
-//   loki.write                → forwards logs/exceptions to Loki
+//   loki.write                    → forwards Faro logs/exceptions to Loki
+//   otelcol.exporter.loki        → forwards OTel logs to Loki (native format)
 //
 // The Faro endpoint is exposed publicly at faro.libnovel.cc via cloudflared.
-// CORS is configured to allow requests from libnovel.cc.
 
 faro.receiver "faro" {
   server {
@@ -25,6 +29,40 @@ faro.receiver "faro" {
   }
 }
 
+// Receive OTLP traces and logs from backend/runner
+otelcol.receiver.otlp "otel_logs" {
+  http {
+    endpoint = "0.0.0.0:4318"
+  }
+
+  output {
+    logs   = [otelcol.exporter.loki.otel_logs.input]
+    traces = [otelcol.exporter.otlphttp.otel_logs.input]
+  }
+}
+
+// Convert OTel logs to Loki format and forward to loki.write
+otelcol.exporter.loki "otel_logs" {
+  forward_to = [loki.write.otel_logs.receiver]
+}
+
+// Send backend/runner traces to the OTel Collector → Tempo
+otelcol.exporter.otlphttp "otel_logs" {
+  client {
+    endpoint = "http://otel-collector:4318"
+    tls {
+      insecure = true
+    }
+  }
+}
+
+// Push backend/runner logs to Loki (native push format)
+loki.write "otel_logs" {
+  endpoint {
+    url = "http://loki:3100/loki/api/v1/push"
+  }
+}
+
 // Forward Faro traces to the OTel Collector (which routes to Tempo)
 otelcol.exporter.otlphttp "faro" {
   client {

homelab/otel/collector.yaml

@@ -17,7 +17,7 @@ processors:
     timeout: 5s
     send_batch_size: 512
 
-  # Attach host metadata to all telemetry
+  # Attach host metadata to traces/metrics
   resourcedetection:
     detectors: [env, system]
     timeout: 5s
@@ -55,7 +55,13 @@ service:
   extensions: [health_check, pprof]
   telemetry:
     metrics:
-      address: 0.0.0.0:8888
+      # otel-collector v0.103+ replaced `address` with `readers`
+      readers:
+        - pull:
+            exporter:
+              prometheus:
+                host: 0.0.0.0
+                port: 8888
   pipelines:
     traces:
       receivers: [otlp]
@@ -67,5 +73,7 @@ service:
       exporters: [prometheusremotewrite]
     logs:
       receivers: [otlp]
-      processors: [resourcedetection, batch]
+      # No resourcedetection — preserve service.name from OTel resource attributes
+      # (backend=backend, runner=runner, Alloy/Faro=no service.name → unknown_service)
+      processors: [batch]
       exporters: [otlphttp/loki]

homelab/otel/grafana/provisioning/dashboards/backend.json

@@ -298,7 +298,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"backend\"} | json | level =~ `(WARN|ERROR|error|warn)`",
+          "expr": "{service_name=\"backend\"}",
           "legendFormat": ""
         }
       ]

homelab/otel/grafana/provisioning/dashboards/catalogue.json

@@ -1,7 +1,7 @@
 {
   "uid": "libnovel-catalogue",
   "title": "Catalogue & Content Progress",
-  "description": "Scraping progress, audio generation coverage, and catalogue health derived from runner structured logs.",
+  "description": "Scraping progress from runner OTel logs in Loki. Logs are JSON: body=message, attributes.slug/chapters/page=fields.",
   "tags": ["libnovel", "catalogue", "content"],
   "timezone": "browser",
   "refresh": "1m",
@@ -12,9 +12,9 @@
       "id": 1,
       "type": "stat",
       "title": "Books Scraped (last 24h)",
-      "description": "Count of unique book slugs appearing in successful scrape task completions.",
+      "description": "Count of unique slugs from chapter list fetched messages.",
       "gridPos": { "x": 0, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["sum"] }, "colorMode": "value", "graphMode": "none" },
+      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "graphMode": "none" },
       "fieldConfig": {
         "defaults": {
           "color": { "fixedColor": "blue", "mode": "fixed" },
@@ -24,7 +24,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "sum_over_time({service_name=\"runner\"} | json | msg=`scrape task done` [24h])",
+          "expr": "count(count_over_time({service_name=\"runner\"} | json | body=\"chapter list fetched\" [24h])) by (attributes_slug)",
           "legendFormat": "books scraped"
         }
       ]
@@ -33,8 +33,9 @@
       "id": 2,
       "type": "stat",
       "title": "Chapters Scraped (last 24h)",
+      "description": "Count of 'chapter list fetched' events.",
       "gridPos": { "x": 4, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["sum"] }, "colorMode": "value", "graphMode": "none" },
+      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "graphMode": "none" },
       "fieldConfig": {
         "defaults": {
           "color": { "fixedColor": "blue", "mode": "fixed" },
@@ -44,17 +45,18 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "sum_over_time({service_name=\"runner\"} | json | unwrap scraped [24h])",
-          "legendFormat": "chapters scraped"
+          "expr": "sum(count_over_time({service_name=\"runner\"} | json | body=\"chapter list fetched\" [24h]))",
+          "legendFormat": "chapter lists fetched"
         }
       ]
     },
     {
       "id": 3,
       "type": "stat",
-      "title": "Audio Jobs Completed (last 24h)",
+      "title": "Metadata Saved (last 24h)",
+      "description": "Count of 'metadata saved' events.",
       "gridPos": { "x": 8, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["sum"] }, "colorMode": "value", "graphMode": "none" },
+      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "graphMode": "none" },
       "fieldConfig": {
         "defaults": {
           "color": { "fixedColor": "green", "mode": "fixed" },
@@ -64,43 +66,18 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "sum_over_time({service_name=\"runner\"} | json | msg=`audio task done` [24h])",
-          "legendFormat": "audio done"
+          "expr": "sum(count_over_time({service_name=\"runner\"} | json | body=\"metadata saved\" [24h]))",
+          "legendFormat": "metadata saved"
         }
       ]
     },
     {
       "id": 4,
       "type": "stat",
-      "title": "Audio Jobs Failed (last 24h)",
-      "gridPos": { "x": 12, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["sum"] }, "colorMode": "background", "graphMode": "none" },
-      "fieldConfig": {
-        "defaults": {
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 1 },
-              { "color": "red", "value": 5 }
-            ]
-          }
-        }
-      },
-      "targets": [
-        {
-          "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "sum_over_time({service_name=\"runner\"} | json | msg=`audio task failed` [24h])",
-          "legendFormat": "audio failed"
-        }
-      ]
-    },
-    {
-      "id": 5,
-      "type": "stat",
       "title": "Scrape Errors (last 24h)",
-      "gridPos": { "x": 16, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["sum"] }, "colorMode": "background", "graphMode": "none" },
+      "description": "Count of error severity logs from the runner.",
+      "gridPos": { "x": 12, "y": 0, "w": 4, "h": 4 },
+      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
       "fieldConfig": {
         "defaults": {
           "thresholds": {
@@ -116,97 +93,93 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "sum_over_time({service_name=\"runner\"} | json | msg=`scrape task failed` [24h])",
-          "legendFormat": "scrape errors"
+          "expr": "sum(count_over_time({service_name=\"runner\"} | json | severity=\"ERROR\" [24h]))",
+          "legendFormat": "errors"
         }
       ]
     },
     {
-      "id": 6,
+      "id": 5,
       "type": "stat",
-      "title": "Catalogue Refresh — Books Indexed",
-      "description": "Total books indexed in the last catalogue refresh cycle (from the ok field in the summary log).",
-      "gridPos": { "x": 20, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "graphMode": "none" },
+      "title": "Rate Limited (last 24h)",
+      "description": "Count of rate limiting events from Novelfire.",
+      "gridPos": { "x": 16, "y": 0, "w": 4, "h": 4 },
+      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
       "fieldConfig": {
         "defaults": {
-          "color": { "fixedColor": "purple", "mode": "fixed" },
-          "thresholds": { "mode": "absolute", "steps": [] }
+          "thresholds": {
+            "mode": "absolute",
+            "steps": [
+              { "color": "green", "value": null },
+              { "color": "yellow", "value": 5 },
+              { "color": "red", "value": 50 }
+            ]
+          }
         }
       },
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "last_over_time({service_name=\"runner\"} | json | op=`catalogue_refresh` | msg=`catalogue refresh done` | unwrap ok [7d])",
-          "legendFormat": "indexed"
+          "expr": "sum(count_over_time({service_name=\"runner\"} | json | body=~\"rate limit\" [24h]))",
+          "legendFormat": "rate limited"
         }
       ]
     },
     {
       "id": 10,
       "type": "timeseries",
-      "title": "Audio Generation Rate (tasks/min)",
+      "title": "Scrape Rate (books/min)",
+      "description": "Rate of events per minute.",
       "gridPos": { "x": 0, "y": 4, "w": 12, "h": 8 },
-      "description": "Rate of audio task completions and failures over time.",
-      "options": {
-        "tooltip": { "mode": "multi" },
-        "legend": { "displayMode": "list", "placement": "bottom" }
-      },
+      "options": { "tooltip": { "mode": "multi" }, "legend": { "displayMode": "list", "placement": "bottom" } },
       "fieldConfig": {
-        "defaults": { "unit": "short", "custom": { "lineWidth": 2, "fillOpacity": 10 } },
-        "overrides": [
-          { "matcher": { "id": "byName", "options": "failed" }, "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }] },
-          { "matcher": { "id": "byName", "options": "completed" }, "properties": [{ "id": "color", "value": { "fixedColor": "green", "mode": "fixed" } }] }
-        ]
+        "defaults": { "unit": "short", "custom": { "lineWidth": 2, "fillOpacity": 10 } }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "sum(rate(traces_spanmetrics_calls_total{service=\"runner\", span_name=\"runner.audio_task\", status_code!=\"STATUS_CODE_ERROR\"}[5m])) * 60",
-          "legendFormat": "completed"
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "sum(rate({service_name=\"runner\"} | json | body=\"chapter list fetched\" [5m])) * 60",
+          "legendFormat": "books/min"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "sum(rate(traces_spanmetrics_calls_total{service=\"runner\", span_name=\"runner.audio_task\", status_code=\"STATUS_CODE_ERROR\"}[5m])) * 60",
-          "legendFormat": "failed"
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "sum(rate({service_name=\"runner\"} | json | body=\"metadata saved\" [5m])) * 60",
+          "legendFormat": "metadata/min"
         }
       ]
     },
     {
       "id": 11,
       "type": "timeseries",
-      "title": "Scraping Rate (tasks/min)",
+      "title": "Error Rate (errors/min)",
+      "description": "Rate of error and rate-limit messages over time.",
       "gridPos": { "x": 12, "y": 4, "w": 12, "h": 8 },
-      "description": "Rate of scrape task completions and failures over time.",
-      "options": {
-        "tooltip": { "mode": "multi" },
-        "legend": { "displayMode": "list", "placement": "bottom" }
-      },
+      "options": { "tooltip": { "mode": "multi" }, "legend": { "displayMode": "list", "placement": "bottom" } },
       "fieldConfig": {
         "defaults": { "unit": "short", "custom": { "lineWidth": 2, "fillOpacity": 10 } },
         "overrides": [
-          { "matcher": { "id": "byName", "options": "failed" }, "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }] },
-          { "matcher": { "id": "byName", "options": "completed" }, "properties": [{ "id": "color", "value": { "fixedColor": "blue", "mode": "fixed" } }] }
+          { "matcher": { "id": "byName", "options": "errors/min" }, "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }] },
+          { "matcher": { "id": "byName", "options": "rate-limit/min" }, "properties": [{ "id": "color", "value": { "fixedColor": "orange", "mode": "fixed" } }] }
         ]
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "sum(rate(traces_spanmetrics_calls_total{service=\"runner\", span_name=\"runner.scrape_task\", status_code!=\"STATUS_CODE_ERROR\"}[5m])) * 60",
-          "legendFormat": "completed"
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "sum(rate({service_name=\"runner\"} | json | severity=\"ERROR\" [5m])) * 60",
+          "legendFormat": "errors/min"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "sum(rate(traces_spanmetrics_calls_total{service=\"runner\", span_name=\"runner.scrape_task\", status_code=\"STATUS_CODE_ERROR\"}[5m])) * 60",
-          "legendFormat": "failed"
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "sum(rate({service_name=\"runner\"} | json | body=~\"rate limit\" [5m])) * 60",
+          "legendFormat": "rate-limit/min"
         }
       ]
     },
     {
       "id": 20,
       "type": "logs",
-      "title": "Scrape Task Events",
-      "description": "One log line per completed or failed scrape task. Fields: task_id, kind, url, scraped, skipped, errors.",
+      "title": "Runner Logs (errors & warnings)",
+      "description": "Runner log lines containing errors or warnings.",
       "gridPos": { "x": 0, "y": 12, "w": 24, "h": 10 },
       "options": {
         "showTime": true,
@@ -220,7 +193,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"runner\"} | json | msg =~ `scrape task (done|failed|starting)`",
+          "expr": "{service_name=\"runner\"} | json | severity=~\"ERROR|WARN\"",
           "legendFormat": ""
         }
       ]
@@ -228,12 +201,12 @@
     {
       "id": 21,
       "type": "logs",
-      "title": "Audio Task Events",
-      "description": "One log line per completed or failed audio task. Fields: task_id, slug, chapter, voice, key (on success), reason (on failure).",
+      "title": "Runner Logs (all)",
+      "description": "All runner log entries.",
       "gridPos": { "x": 0, "y": 22, "w": 24, "h": 10 },
       "options": {
         "showTime": true,
-        "showLabels": false,
+        "showLabels": true,
         "wrapLogMessage": false,
         "prettifyLogMessage": true,
         "enableLogDetails": true,
@@ -243,30 +216,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"runner\"} | json | msg =~ `audio task (done|failed|starting)`",
-          "legendFormat": ""
-        }
-      ]
-    },
-    {
-      "id": 22,
-      "type": "logs",
-      "title": "Catalogue Refresh Progress",
-      "description": "Progress logs from the background catalogue refresh (every 24h). Fields: op=catalogue_refresh, scraped, ok, skipped, errors.",
-      "gridPos": { "x": 0, "y": 32, "w": 24, "h": 8 },
-      "options": {
-        "showTime": true,
-        "showLabels": false,
-        "wrapLogMessage": false,
-        "prettifyLogMessage": true,
-        "enableLogDetails": true,
-        "sortOrder": "Descending",
-        "dedupStrategy": "none"
-      },
-      "targets": [
-        {
-          "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"runner\"} | json | op=`catalogue_refresh`",
+          "expr": "{service_name=\"runner\"}",
           "legendFormat": ""
         }
       ]

homelab/otel/grafana/provisioning/dashboards/runner.json

@@ -345,7 +345,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"runner\"} | json | level =~ `(WARN|ERROR|error|warn)`",
+          "expr": "{service_name=\"runner\"}",
           "legendFormat": ""
         }
       ]
@@ -368,7 +368,7 @@
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"runner\"} | json",
+          "expr": "{service_name=\"runner\"}",
           "legendFormat": ""
         }
       ]

homelab/otel/grafana/provisioning/dashboards/web-vitals.json

@@ -1,37 +1,71 @@
 {
   "uid": "libnovel-web-vitals",
   "title": "Web Vitals (RUM)",
-  "description": "Real User Monitoring — Core Web Vitals (LCP, CLS, INP, TTFB, FCP) from @grafana/faro-web-sdk. Data flows: browser → Alloy faro.receiver → Tempo (traces) + Loki (logs).",
-  "tags": ["libnovel", "frontend", "rum", "web-vitals"],
+  "description": "Core Web Vitals from @grafana/faro-web-sdk. Data: browser \u2192 Alloy faro.receiver \u2192 Loki ({service_name=unknown_service}). Log format: key=value pairs, e.g. lcp=767.000000 fcp=767.000000. Use | regexp to extract.",
+  "tags": [
+    "libnovel",
+    "frontend",
+    "rum",
+    "web-vitals"
+  ],
   "timezone": "browser",
   "refresh": "1m",
-  "time": { "from": "now-24h", "to": "now" },
+  "time": {
+    "from": "now-24h",
+    "to": "now"
+  },
   "schemaVersion": 39,
   "panels": [
     {
       "id": 1,
       "type": "stat",
-      "title": "LCP — p75 (Largest Contentful Paint)",
-      "description": "Good < 2.5 s, needs improvement < 4 s, poor ≥ 4 s.",
-      "gridPos": { "x": 0, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
+      "title": "LCP \u2014 p75 (Largest Contentful Paint)",
+      "description": "Good < 2.5s, needs improvement < 4s, poor >= 4s. Source: Loki {service_name=unknown_service} Faro measurements.",
+      "gridPos": {
+        "x": 0,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "ms",
+          "decimals": 0,
           "thresholds": {
             "mode": "absolute",
             "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 2500 },
-              { "color": "red", "value": 4000 }
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "yellow",
+                "value": 2500
+              },
+              {
+                "color": "red",
+                "value": 4000
+              }
             ]
           }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*lcp|LCP\"}[1h])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `lcp=(?P<lcp>\\d+\\.?\\d*)` | unwrap lcp [1h])",
           "legendFormat": "LCP p75",
           "instant": true
         }
@@ -40,27 +74,53 @@
     {
       "id": 2,
       "type": "stat",
-      "title": "INP — p75 (Interaction to Next Paint)",
-      "description": "Good < 200 ms, needs improvement < 500 ms, poor ≥ 500 ms.",
-      "gridPos": { "x": 4, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
+      "title": "INP \u2014 p75 (Interaction to Next Paint)",
+      "description": "Good < 200ms, needs improvement < 500ms, poor >= 500ms.",
+      "gridPos": {
+        "x": 4,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "ms",
+          "decimals": 0,
           "thresholds": {
             "mode": "absolute",
             "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 200 },
-              { "color": "red", "value": 500 }
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "yellow",
+                "value": 200
+              },
+              {
+                "color": "red",
+                "value": 500
+              }
             ]
           }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*inp|INP\"}[1h])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `inp=(?P<inp>\\d+\\.?\\d*)` | unwrap inp [1h])",
           "legendFormat": "INP p75",
           "instant": true
         }
@@ -69,10 +129,23 @@
     {
       "id": 3,
       "type": "stat",
-      "title": "CLS — p75 (Cumulative Layout Shift)",
-      "description": "Good < 0.1, needs improvement < 0.25, poor ≥ 0.25.",
-      "gridPos": { "x": 8, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
+      "title": "CLS \u2014 p75 (Cumulative Layout Shift)",
+      "description": "Good < 0.1, needs improvement < 0.25, poor >= 0.25.",
+      "gridPos": {
+        "x": 8,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "short",
@@ -80,17 +153,29 @@
           "thresholds": {
             "mode": "absolute",
             "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 0.1 },
-              { "color": "red", "value": 0.25 }
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "yellow",
+                "value": 0.1
+              },
+              {
+                "color": "red",
+                "value": 0.25
+              }
             ]
           }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*cls|CLS\"}[1h])) by (le))",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `cls=(?P<cls>\\d+\\.?\\d*)` | unwrap cls [1h])",
           "legendFormat": "CLS p75",
           "instant": true
         }
@@ -99,27 +184,53 @@
     {
       "id": 4,
       "type": "stat",
-      "title": "TTFB — p75 (Time to First Byte)",
-      "description": "Good < 800 ms, needs improvement < 1800 ms, poor ≥ 1800 ms.",
-      "gridPos": { "x": 12, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
+      "title": "TTFB \u2014 p75 (Time to First Byte)",
+      "description": "Good < 800ms, needs improvement < 1800ms, poor >= 1800ms.",
+      "gridPos": {
+        "x": 12,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "ms",
+          "decimals": 0,
           "thresholds": {
             "mode": "absolute",
             "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 800 },
-              { "color": "red", "value": 1800 }
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "yellow",
+                "value": 800
+              },
+              {
+                "color": "red",
+                "value": 1800
+              }
             ]
           }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*ttfb|TTFB\"}[1h])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `ttfb=(?P<ttfb>\\d+\\.?\\d*)` | unwrap ttfb [1h])",
           "legendFormat": "TTFB p75",
           "instant": true
         }
@@ -128,27 +239,53 @@
     {
       "id": 5,
       "type": "stat",
-      "title": "FCP — p75 (First Contentful Paint)",
-      "description": "Good < 1.8 s, needs improvement < 3 s, poor ≥ 3 s.",
-      "gridPos": { "x": 16, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "background", "graphMode": "none" },
+      "title": "FCP \u2014 p75 (First Contentful Paint)",
+      "description": "Good < 1.8s, needs improvement < 3s, poor >= 3s.",
+      "gridPos": {
+        "x": 16,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "ms",
+          "decimals": 0,
           "thresholds": {
             "mode": "absolute",
             "steps": [
-              { "color": "green", "value": null },
-              { "color": "yellow", "value": 1800 },
-              { "color": "red", "value": 3000 }
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "yellow",
+                "value": 1800
+              },
+              {
+                "color": "red",
+                "value": 3000
+              }
             ]
           }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*fcp|FCP\"}[1h])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `fcp=(?P<fcp>\\d+\\.?\\d*)` | unwrap fcp [1h])",
           "legendFormat": "FCP p75",
           "instant": true
         }
@@ -157,20 +294,45 @@
     {
       "id": 6,
       "type": "stat",
-      "title": "Active Sessions (30 min)",
-      "gridPos": { "x": 20, "y": 0, "w": 4, "h": 4 },
-      "options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "graphMode": "area" },
+      "title": "Measurements / min",
+      "description": "Number of Faro measurement events in the last 5 minutes (activity indicator).",
+      "gridPos": {
+        "x": 20,
+        "y": 0,
+        "w": 4,
+        "h": 4
+      },
+      "options": {
+        "reduceOptions": {
+          "calcs": [
+            "lastNotNull"
+          ]
+        },
+        "colorMode": "value",
+        "graphMode": "area"
+      },
       "fieldConfig": {
         "defaults": {
           "unit": "short",
-          "thresholds": { "mode": "absolute", "steps": [{ "color": "green", "value": null }] }
+          "thresholds": {
+            "mode": "absolute",
+            "steps": [
+              {
+                "color": "green",
+                "value": null
+              }
+            ]
+          }
         }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "sum(rate(traces_spanmetrics_calls_total{service=\"libnovel-ui\"}[30m]))",
-          "legendFormat": "sessions",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "sum(count_over_time({service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" [5m]))",
+          "legendFormat": "measurements",
           "instant": true
         }
       ]
@@ -179,58 +341,176 @@
       "id": 10,
       "type": "timeseries",
       "title": "LCP over time (p50 / p75 / p95)",
-      "gridPos": { "x": 0, "y": 4, "w": 12, "h": 8 },
-      "options": { "tooltip": { "mode": "multi" }, "legend": { "displayMode": "list", "placement": "bottom" } },
+      "gridPos": {
+        "x": 0,
+        "y": 4,
+        "w": 12,
+        "h": 8
+      },
+      "options": {
+        "tooltip": {
+          "mode": "multi"
+        },
+        "legend": {
+          "displayMode": "list",
+          "placement": "bottom"
+        }
+      },
       "fieldConfig": {
-        "defaults": { "unit": "ms", "custom": { "lineWidth": 2, "fillOpacity": 10 } },
+        "defaults": {
+          "unit": "ms",
+          "custom": {
+            "lineWidth": 2,
+            "fillOpacity": 10
+          }
+        },
         "overrides": [
-          { "matcher": { "id": "byName", "options": "Good (2.5s)" }, "properties": [{ "id": "color", "value": { "fixedColor": "green", "mode": "fixed" } }, { "id": "custom.lineStyle", "value": { "fill": "dash", "dash": [4, 4] } }] },
-          { "matcher": { "id": "byName", "options": "Poor (4s)" }, "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }, { "id": "custom.lineStyle", "value": { "fill": "dash", "dash": [4, 4] } }] }
+          {
+            "matcher": {
+              "id": "byName",
+              "options": "Good (2.5s)"
+            },
+            "properties": [
+              {
+                "id": "color",
+                "value": {
+                  "fixedColor": "green",
+                  "mode": "fixed"
+                }
+              },
+              {
+                "id": "custom.lineStyle",
+                "value": {
+                  "fill": "dash",
+                  "dash": [
+                    4,
+                    4
+                  ]
+                }
+              }
+            ]
+          },
+          {
+            "matcher": {
+              "id": "byName",
+              "options": "Poor (4s)"
+            },
+            "properties": [
+              {
+                "id": "color",
+                "value": {
+                  "fixedColor": "red",
+                  "mode": "fixed"
+                }
+              },
+              {
+                "id": "custom.lineStyle",
+                "value": {
+                  "fill": "dash",
+                  "dash": [
+                    4,
+                    4
+                  ]
+                }
+              }
+            ]
+          }
         ]
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.50, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*lcp|LCP\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `lcp=(?P<lcp>\\d+\\.?\\d*)` | unwrap lcp [5m])",
           "legendFormat": "p50"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*lcp|LCP\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `lcp=(?P<lcp>\\d+\\.?\\d*)` | unwrap lcp [5m])",
           "legendFormat": "p75"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.95, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*lcp|LCP\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `lcp=(?P<lcp>\\d+\\.?\\d*)` | unwrap lcp [5m])",
           "legendFormat": "p95"
         },
-        { "datasource": { "type": "prometheus", "uid": "prometheus" }, "expr": "2500", "legendFormat": "Good (2.5s)" },
-        { "datasource": { "type": "prometheus", "uid": "prometheus" }, "expr": "4000", "legendFormat": "Poor (4s)" }
+        {
+          "datasource": {
+            "type": "prometheus",
+            "uid": "prometheus"
+          },
+          "expr": "2500",
+          "legendFormat": "Good (2.5s)"
+        },
+        {
+          "datasource": {
+            "type": "prometheus",
+            "uid": "prometheus"
+          },
+          "expr": "4000",
+          "legendFormat": "Poor (4s)"
+        }
       ]
     },
     {
       "id": 11,
       "type": "timeseries",
       "title": "TTFB over time (p50 / p75 / p95)",
-      "gridPos": { "x": 12, "y": 4, "w": 12, "h": 8 },
-      "options": { "tooltip": { "mode": "multi" }, "legend": { "displayMode": "list", "placement": "bottom" } },
+      "gridPos": {
+        "x": 12,
+        "y": 4,
+        "w": 12,
+        "h": 8
+      },
+      "options": {
+        "tooltip": {
+          "mode": "multi"
+        },
+        "legend": {
+          "displayMode": "list",
+          "placement": "bottom"
+        }
+      },
       "fieldConfig": {
-        "defaults": { "unit": "ms", "custom": { "lineWidth": 2, "fillOpacity": 10 } }
+        "defaults": {
+          "unit": "ms",
+          "custom": {
+            "lineWidth": 2,
+            "fillOpacity": 10
+          }
+        }
       },
       "targets": [
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.50, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*ttfb|TTFB\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `ttfb=(?P<ttfb>\\d+\\.?\\d*)` | unwrap ttfb [5m])",
           "legendFormat": "p50"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.75, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*ttfb|TTFB\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.75, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `ttfb=(?P<ttfb>\\d+\\.?\\d*)` | unwrap ttfb [5m])",
           "legendFormat": "p75"
         },
         {
-          "datasource": { "type": "prometheus", "uid": "prometheus" },
-          "expr": "histogram_quantile(0.95, sum(rate(traces_spanmetrics_latency_bucket{service=\"libnovel-ui\", span_name=~\"faro.*ttfb|TTFB\"}[5m])) by (le)) * 1000",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"kind=measurement\" |= \"type=web-vitals\" | regexp `ttfb=(?P<ttfb>\\d+\\.?\\d*)` | unwrap ttfb [5m])",
           "legendFormat": "p95"
         }
       ]
@@ -239,8 +519,13 @@
       "id": 20,
       "type": "logs",
       "title": "Frontend Errors & Exceptions",
-      "description": "JS exceptions and console errors captured by Faro and shipped to Loki.",
-      "gridPos": { "x": 0, "y": 12, "w": 24, "h": 10 },
+      "description": "JS exceptions captured by Faro. kind=exception events.",
+      "gridPos": {
+        "x": 0,
+        "y": 12,
+        "w": 24,
+        "h": 10
+      },
       "options": {
         "showTime": true,
         "showLabels": true,
@@ -252,8 +537,11 @@
       },
       "targets": [
         {
-          "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"libnovel-ui\"} | json | kind =~ `(exception|error)`",
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "{service_name=\"unknown_service\"} | regexp `(?P<kind>\\w+)` | kind = \"exception\"",
           "legendFormat": ""
         }
       ]
@@ -261,24 +549,256 @@
     {
       "id": 21,
       "type": "logs",
-      "title": "Frontend Logs (all Faro events)",
-      "gridPos": { "x": 0, "y": 22, "w": 24, "h": 10 },
+      "title": "Web Vitals Measurements",
+      "description": "All Faro measurement events.",
+      "gridPos": {
+        "x": 0,
+        "y": 22,
+        "w": 24,
+        "h": 10
+      },
       "options": {
         "showTime": true,
-        "showLabels": false,
-        "wrapLogMessage": true,
+        "showLabels": true,
+        "wrapLogMessage": false,
         "prettifyLogMessage": true,
         "enableLogDetails": true,
         "sortOrder": "Descending",
         "dedupStrategy": "none"
       },
+      "targets": [
+        {
+          "datasource": {
+            "type": "loki",
+            "uid": "loki"
+          },
+          "expr": "{service_name=\"unknown_service\"} | regexp `(?P<kind>\\w+)` | kind = \"measurement\"",
+          "legendFormat": ""
+        }
+      ]
+    },
+    {
+      "id": 30,
+      "type": "row",
+      "title": "API Performance (Upstream Requests)",
+      "gridPos": { "x": 0, "y": 32, "w": 24, "h": 1 },
+      "collapsed": false
+    },
+    {
+      "id": 31,
+      "type": "timeseries",
+      "title": "API Request Duration — p50 / p75 / p95 by endpoint",
+      "description": "Duration of all libnovel.cc/api/* fetch requests captured by Faro faro.performance.resource events. Values in ms.",
+      "gridPos": { "x": 0, "y": 33, "w": 24, "h": 10 },
+      "options": {
+        "tooltip": { "mode": "multi" },
+        "legend": { "displayMode": "table", "placement": "bottom", "calcs": ["mean", "max", "lastNotNull"] }
+      },
+      "fieldConfig": {
+        "defaults": {
+          "unit": "ms",
+          "custom": { "lineWidth": 2, "fillOpacity": 5 }
+        }
+      },
       "targets": [
         {
           "datasource": { "type": "loki", "uid": "loki" },
-          "expr": "{service_name=\"libnovel-ui\"}",
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress/audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/progress/audio-time"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress/audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/progress/audio-time"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/presign/audio\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/presign/audio"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/presign/audio\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/presign/audio"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress\" !~ \"audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/progress"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress\" !~ \"audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/progress"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/comments\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/comments"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/comments\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/comments"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/settings\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/settings"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/settings\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/settings"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.50, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/catalogue-page\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p50 /api/catalogue-page"
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/catalogue-page\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [5m])",
+          "legendFormat": "p95 /api/catalogue-page"
+        }
+      ]
+    },
+    {
+      "id": 32,
+      "type": "barchart",
+      "title": "API Avg Duration — last 1h",
+      "description": "Average duration per endpoint over the last hour. Useful for spotting the slowest APIs at a glance.",
+      "gridPos": { "x": 0, "y": 43, "w": 12, "h": 8 },
+      "options": {
+        "orientation": "horizontal",
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "tooltip": { "mode": "single" },
+        "xTickLabelRotation": 0
+      },
+      "fieldConfig": {
+        "defaults": { "unit": "ms", "color": { "mode": "palette-classic" } }
+      },
+      "targets": [
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress/audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/progress/audio-time",
+          "instant": true
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/presign/audio\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/presign/audio",
+          "instant": true
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/progress\" !~ \"audio-time\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/progress",
+          "instant": true
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/comments\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/comments",
+          "instant": true
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/settings\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/settings",
+          "instant": true
+        },
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "avg_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api/catalogue-page\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h])",
+          "legendFormat": "/api/catalogue-page",
+          "instant": true
+        }
+      ]
+    },
+    {
+      "id": 33,
+      "type": "stat",
+      "title": "Slowest API call — p95 last 1h",
+      "description": "p95 duration of the single slowest endpoint in the last hour.",
+      "gridPos": { "x": 12, "y": 43, "w": 6, "h": 4 },
+      "options": {
+        "reduceOptions": { "calcs": ["lastNotNull"] },
+        "colorMode": "background",
+        "graphMode": "none"
+      },
+      "fieldConfig": {
+        "defaults": {
+          "unit": "ms",
+          "decimals": 0,
+          "thresholds": {
+            "mode": "absolute",
+            "steps": [
+              { "color": "green", "value": null },
+              { "color": "yellow", "value": 500 },
+              { "color": "red", "value": 1000 }
+            ]
+          }
+        }
+      },
+      "targets": [
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "max(quantile_over_time(0.95, {service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur [1h]))",
+          "legendFormat": "p95 max",
+          "instant": true
+        }
+      ]
+    },
+    {
+      "id": 34,
+      "type": "stat",
+      "title": "API Requests / min",
+      "description": "Rate of libnovel.cc API requests captured by Faro in the last 5 minutes.",
+      "gridPos": { "x": 18, "y": 43, "w": 6, "h": 4 },
+      "options": {
+        "reduceOptions": { "calcs": ["lastNotNull"] },
+        "colorMode": "value",
+        "graphMode": "area"
+      },
+      "fieldConfig": {
+        "defaults": {
+          "unit": "short",
+          "thresholds": { "mode": "absolute", "steps": [{ "color": "green", "value": null }] }
+        }
+      },
+      "targets": [
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "sum(count_over_time({service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api\" [5m])) / 5",
+          "legendFormat": "req/min",
+          "instant": true
+        }
+      ]
+    },
+    {
+      "id": 35,
+      "type": "logs",
+      "title": "Slow API Requests (>500ms)",
+      "description": "Individual faro.performance.resource events where duration > 500ms. Useful for debugging outliers.",
+      "gridPos": { "x": 0, "y": 47, "w": 24, "h": 8 },
+      "options": {
+        "showTime": true,
+        "showLabels": false,
+        "wrapLogMessage": false,
+        "prettifyLogMessage": false,
+        "enableLogDetails": true,
+        "sortOrder": "Descending",
+        "dedupStrategy": "none"
+      },
+      "targets": [
+        {
+          "datasource": { "type": "loki", "uid": "loki" },
+          "expr": "{service_name=\"unknown_service\"} |= \"faro.performance.resource\" |= \"libnovel.cc/api\" | regexp `event_data_duration=(?P<dur>[0-9.]+)` | unwrap dur | dur > 500",
           "legendFormat": ""
         }
       ]
     }
   ]
-}
+}

scripts/pb-init-v3.sh

@@ -144,7 +144,8 @@ create "books" '{
     {"name":"total_chapters","type":"number"},
     {"name":"source_url",    "type":"text"},
     {"name":"ranking",       "type":"number"},
-    {"name":"meta_updated",  "type":"text"}
+    {"name":"meta_updated",  "type":"text"},
+    {"name":"archived",      "type":"bool"}
   ]}'
 
 create "chapters_idx" '{
@@ -245,12 +246,18 @@ create "user_library" '{
 
 create "user_settings" '{
   "name":"user_settings","type":"base","fields":[
-    {"name":"session_id","type":"text","required":true},
-    {"name":"user_id",  "type":"text"},
-    {"name":"auto_next","type":"bool"},
-    {"name":"voice",    "type":"text"},
-    {"name":"speed",    "type":"number"},
-    {"name":"updated",  "type":"text"}
+    {"name":"session_id",      "type":"text",  "required":true},
+    {"name":"user_id",         "type":"text"},
+    {"name":"auto_next",       "type":"bool"},
+    {"name":"voice",           "type":"text"},
+    {"name":"speed",           "type":"number"},
+    {"name":"theme",           "type":"text"},
+    {"name":"locale",          "type":"text"},
+    {"name":"font_family",     "type":"text"},
+    {"name":"font_size",       "type":"number"},
+    {"name":"announce_chapter","type":"bool"},
+    {"name":"audio_mode",      "type":"text"},
+    {"name":"updated",         "type":"text"}
   ]}'
 
 create "user_subscriptions" '{
@@ -294,6 +301,40 @@ create "translation_jobs" '{
     {"name":"heartbeat_at", "type":"date"}
   ]}'
 
+create "import_tasks" '{
+  "name":"import_tasks","type":"base","fields":[
+    {"name":"slug",              "type":"text",  "required":true},
+    {"name":"title",             "type":"text",  "required":true},
+    {"name":"file_name",         "type":"text"},
+    {"name":"file_type",         "type":"text"},
+    {"name":"object_key",        "type":"text"},
+    {"name":"chapters_key",      "type":"text"},
+    {"name":"author",            "type":"text"},
+    {"name":"cover_url",         "type":"text"},
+    {"name":"genres",            "type":"text"},
+    {"name":"summary",           "type":"text"},
+    {"name":"book_status",       "type":"text"},
+    {"name":"worker_id",         "type":"text"},
+    {"name":"initiator_user_id", "type":"text"},
+    {"name":"status",            "type":"text",  "required":true},
+    {"name":"chapters_done",     "type":"number"},
+    {"name":"chapters_total",    "type":"number"},
+    {"name":"error_message",     "type":"text"},
+    {"name":"started",           "type":"date"},
+    {"name":"finished",          "type":"date"},
+    {"name":"heartbeat_at",      "type":"date"}
+  ]}'
+
+create "notifications" '{
+  "name":"notifications","type":"base","fields":[
+    {"name":"user_id", "type":"text","required":true},
+    {"name":"title",   "type":"text","required":true},
+    {"name":"message", "type":"text"},
+    {"name":"link",    "type":"text"},
+    {"name":"read",    "type":"bool"},
+    {"name":"created", "type":"date"}
+  ]}'
+
 create "ai_jobs" '{
   "name":"ai_jobs","type":"base","fields":[
     {"name":"kind",          "type":"text",  "required":true},
@@ -345,6 +386,13 @@ add_field "app_users"      "polar_subscription_id"  "text"
 add_field "user_library"   "shelf"                  "text"
 add_field "user_sessions"  "device_fingerprint"     "text"
 add_field "chapters_idx"   "created"                "date"
+add_field "user_settings"  "theme"                  "text"
+add_field "user_settings"  "locale"                 "text"
+add_field "user_settings"  "font_family"            "text"
+add_field "user_settings"  "font_size"              "number"
+add_field "user_settings"  "announce_chapter"       "bool"
+add_field "user_settings"  "audio_mode"             "text"
+add_field "books"          "archived"               "bool"
 
 # ── 6. Indexes ────────────────────────────────────────────────────────────────
 add_index "chapters_idx" "idx_chapters_idx_slug_number" \

ui/messages/en.json

@@ -161,6 +161,9 @@
   "profile_theme_amber": "Amber",
   "profile_theme_slate": "Slate",
   "profile_theme_rose": "Rose",
+  "profile_theme_forest": "Forest",
+  "profile_theme_mono": "Mono",
+  "profile_theme_cyber": "Cyberpunk",
   "profile_theme_light": "Light",
   "profile_theme_light_slate": "Light Blue",
   "profile_theme_light_rose": "Light Rose",
@@ -399,11 +402,13 @@
   "admin_nav_scrape": "Scrape",
   "admin_nav_audio": "Audio",
   "admin_nav_translation": "Translation",
+  "admin_nav_import": "Import",
   "admin_nav_changelog": "Changelog",
   "admin_nav_image_gen": "Image Gen",
   "admin_nav_text_gen": "Text Gen",
   "admin_nav_catalogue_tools": "Catalogue Tools",
   "admin_nav_ai_jobs": "AI Jobs",
+  "admin_nav_notifications": "Notifications",
   "admin_nav_feedback": "Feedback",
   "admin_nav_errors": "Errors",
   "admin_nav_analytics": "Analytics",
@@ -475,5 +480,20 @@
   "feed_reader_label": "reading",
   "feed_chapters_label": "{n} chapters",
   "feed_browse_cta": "Browse catalogue",
-  "feed_find_users_cta": "Discover readers"
+  "feed_find_users_cta": "Discover readers",
+
+  "admin_translation_page_title": "Translation \u2014 Admin",
+  "admin_translation_heading": "Machine Translation",
+  "admin_translation_tab_enqueue": "Enqueue",
+  "admin_translation_tab_jobs": "Jobs",
+  "admin_translation_filter_placeholder": "Filter by slug, lang, or status\u2026",
+  "admin_translation_no_matching": "No matching jobs.",
+  "admin_translation_no_jobs": "No translation jobs yet.",
+
+  "admin_ai_jobs_page_title": "AI Jobs \u2014 Admin",
+  "admin_ai_jobs_heading": "AI Jobs",
+  "admin_ai_jobs_subheading": "Background AI generation tasks",
+
+  "admin_text_gen_page_title": "Text Gen \u2014 Admin",
+  "admin_text_gen_heading": "Text Generation"
 }

ui/messages/fr.json

@@ -1,6 +1,5 @@
 {
   "$schema": "https://inlang.com/schema/inlang-message-format",
-
   "nav_library": "Bibliothèque",
   "nav_catalogue": "Catalogue",
   "nav_feed": "Fil",
@@ -11,7 +10,6 @@
   "nav_sign_out": "Déconnexion",
   "nav_toggle_menu": "Menu",
   "nav_admin_panel": "Panneau admin",
-
   "footer_library": "Bibliothèque",
   "footer_catalogue": "Catalogue",
   "footer_feedback": "Retour",
@@ -20,7 +18,6 @@
   "footer_dmca": "DMCA",
   "footer_copyright": "© {year} libnovel",
   "footer_dev": "dev",
-
   "home_title": "libnovel",
   "home_stat_books": "Livres",
   "home_stat_chapters": "Chapitres",
@@ -34,7 +31,6 @@
   "home_discover_novels": "Découvrir des romans",
   "home_via_reader": "via {username}",
   "home_chapter_badge": "ch.{n}",
-
   "player_generating": "Génération… {percent}%",
   "player_loading": "Chargement…",
   "player_chapters": "Chapitres",
@@ -58,7 +54,6 @@
   "player_auto_next_aria": "Suivant auto {state}",
   "player_go_to_chapter": "Aller au chapitre",
   "player_close": "Fermer le lecteur",
-
   "login_page_title": "Connexion — libnovel",
   "login_heading": "Se connecter à libnovel",
   "login_subheading": "Choisissez un fournisseur pour continuer",
@@ -68,7 +63,6 @@
   "login_error_oauth_state": "Connexion annulée ou expirée. Veuillez réessayer.",
   "login_error_oauth_failed": "Impossible de se connecter au fournisseur. Veuillez réessayer.",
   "login_error_oauth_no_email": "Votre compte n'a pas d'adresse e-mail vérifiée. Ajoutez-en une et réessayez.",
-
   "books_page_title": "Bibliothèque — libnovel",
   "books_heading": "Votre bibliothèque",
   "books_empty_title": "Aucun livre pour l'instant",
@@ -78,7 +72,6 @@
   "books_last_read": "Dernier lu : Ch.{n}",
   "books_reading_progress": "Ch.{current} / {total}",
   "books_remove": "Supprimer",
-
   "catalogue_page_title": "Catalogue — libnovel",
   "catalogue_heading": "Catalogue",
   "catalogue_search_placeholder": "Rechercher des romans…",
@@ -99,7 +92,6 @@
   "catalogue_loading": "Chargement…",
   "catalogue_load_more": "Charger plus",
   "catalogue_results_count": "{n} résultats",
-
   "book_detail_page_title": "{title} — libnovel",
   "book_detail_signin_to_save": "Connectez-vous pour sauvegarder",
   "book_detail_add_to_library": "Ajouter à la bibliothèque",
@@ -116,13 +108,11 @@
   "book_detail_rescrape": "Réextraire",
   "book_detail_scraping": "Extraction en cours…",
   "book_detail_in_library": "Dans la bibliothèque",
-
   "chapters_page_title": "Chapitres — {title}",
   "chapters_heading": "Chapitres",
   "chapters_back_to_book": "Retour au livre",
   "chapters_reading_now": "En cours de lecture",
   "chapters_empty": "Aucun chapitre extrait pour l'instant.",
-
   "reader_page_title": "{title} — Ch.{n} — libnovel",
   "reader_play_narration": "Lire la narration",
   "reader_generating_audio": "Génération audio…",
@@ -144,7 +134,6 @@
   "reader_auto_next": "Suivant auto",
   "reader_speed": "Vitesse",
   "reader_preview_notice": "Aperçu — ce chapitre n'a pas été entièrement extrait.",
-
   "profile_page_title": "Profil — libnovel",
   "profile_heading": "Profil",
   "profile_avatar_label": "Avatar",
@@ -161,6 +150,9 @@
   "profile_theme_amber": "Ambre",
   "profile_theme_slate": "Ardoise",
   "profile_theme_rose": "Rose",
+  "profile_theme_forest": "Forêt",
+  "profile_theme_mono": "Mono",
+  "profile_theme_cyber": "Cyberpunk",
   "profile_theme_light": "Light",
   "profile_theme_light_slate": "Light Blue",
   "profile_theme_light_rose": "Light Rose",
@@ -176,7 +168,6 @@
   "profile_sessions_heading": "Sessions actives",
   "profile_sign_out_all": "Se déconnecter de tous les autres appareils",
   "profile_joined": "Inscrit le {date}",
-
   "user_page_title": "{username} — libnovel",
   "user_library_heading": "Bibliothèque de {username}",
   "user_follow": "Suivre",
@@ -184,13 +175,11 @@
   "user_followers": "{n} abonnés",
   "user_following": "{n} abonnements",
   "user_library_empty": "Aucun livre dans la bibliothèque.",
-
   "error_not_found_title": "Page introuvable",
   "error_not_found_body": "La page que vous cherchez n'existe pas.",
   "error_generic_title": "Une erreur s'est produite",
   "error_go_home": "Accueil",
   "error_status": "Erreur {status}",
-
   "admin_scrape_page_title": "Extraction — Admin",
   "admin_scrape_heading": "Extraction",
   "admin_scrape_catalogue": "Extraire le catalogue",
@@ -208,14 +197,11 @@
   "admin_scrape_status_cancelled": "Annulé",
   "admin_tasks_heading": "Tâches récentes",
   "admin_tasks_empty": "Aucune tâche pour l'instant.",
-
   "admin_audio_page_title": "Audio — Admin",
   "admin_audio_heading": "Tâches audio",
   "admin_audio_empty": "Aucune tâche audio.",
-
   "admin_changelog_page_title": "Changelog — Admin",
   "admin_changelog_heading": "Changelog",
-
   "comments_heading": "Commentaires",
   "comments_empty": "Aucun commentaire pour l'instant. Soyez le premier !",
   "comments_placeholder": "Écrire un commentaire…",
@@ -229,12 +215,10 @@
   "comments_hide_replies": "Masquer les réponses",
   "comments_edited": "modifié",
   "comments_deleted": "[supprimé]",
-
   "disclaimer_page_title": "Avertissement — libnovel",
   "privacy_page_title": "Politique de confidentialité — libnovel",
   "dmca_page_title": "DMCA — libnovel",
   "terms_page_title": "Conditions d'utilisation — libnovel",
-
   "common_loading": "Chargement…",
   "common_error": "Erreur",
   "common_save": "Enregistrer",
@@ -248,15 +232,12 @@
   "common_no": "Non",
   "common_on": "activé",
   "common_off": "désactivé",
-
   "locale_switcher_label": "Langue",
-
   "books_empty_library": "Votre bibliothèque est vide.",
   "books_empty_discover": "Les livres que vous commencez à lire ou enregistrez depuis",
   "books_empty_discover_link": "Découvrir",
   "books_empty_discover_suffix": "apparaîtront ici.",
   "books_count": "{n} livre{s}",
-
   "catalogue_sort_updated": "Mis à jour",
   "catalogue_search_button": "Rechercher",
   "catalogue_refresh": "Actualiser",
@@ -289,7 +270,6 @@
   "catalogue_scrape_forbidden_badge": "Interdit",
   "catalogue_scrape_novel_button": "Extraire",
   "catalogue_scraping_novel": "Extraction…",
-
   "book_detail_not_in_library": "pas dans la bibliothèque",
   "book_detail_continue_ch": "Continuer ch.{n}",
   "book_detail_start_ch1": "Commencer au ch.1",
@@ -325,18 +305,15 @@
   "book_detail_rescrape_book": "Réextraire le livre",
   "book_detail_less": "Moins",
   "book_detail_more": "Plus",
-
   "chapters_search_placeholder": "Rechercher des chapitres…",
   "chapters_jump_to": "Aller au Ch.{n}",
   "chapters_no_match": "Aucun chapitre ne correspond à « {q} »",
   "chapters_none_available": "Aucun chapitre disponible pour l'instant.",
   "chapters_reading_indicator": "en cours",
   "chapters_result_count": "{n} résultats",
-
   "reader_fetching_chapter": "Récupération du chapitre…",
   "reader_words": "{n} mots",
   "reader_preview_audio_notice": "Aperçu — audio non disponible pour les livres hors bibliothèque.",
-
   "profile_click_to_change": "Cliquez sur l'avatar pour changer la photo",
   "profile_tts_voice": "Voix TTS",
   "profile_auto_advance": "Avancer automatiquement au chapitre suivant",
@@ -354,7 +331,6 @@
   "profile_updating": "Mise à jour…",
   "profile_password_changed_ok": "Mot de passe modifié avec succès.",
   "profile_playback_speed": "Vitesse de lecture — {speed}x",
-
   "profile_subscription_heading": "Abonnement",
   "profile_plan_pro": "Pro",
   "profile_plan_free": "Gratuit",
@@ -366,7 +342,7 @@
   "profile_upgrade_monthly": "Mensuel — 6 $ / mois",
   "profile_upgrade_annual": "Annuel — 48 $ / an",
   "profile_free_limits": "Plan gratuit : 3 chapitres audio par jour, lecture en anglais uniquement.",
-  "subscribe_page_title": "Passer Pro \u2014 libnovel",
+  "subscribe_page_title": "Passer Pro — libnovel",
   "subscribe_heading": "Lisez plus. Écoutez plus.",
   "subscribe_subheading": "Passez Pro et débloquez l'expérience libnovel complète.",
   "subscribe_monthly_label": "Mensuel",
@@ -386,14 +362,12 @@
   "subscribe_benefit_downloads": "Télécharger des chapitres pour une écoute hors ligne",
   "subscribe_login_prompt": "Connectez-vous pour vous abonner",
   "subscribe_login_cta": "Se connecter",
-
   "user_currently_reading": "En cours de lecture",
   "user_library_count": "Bibliothèque ({n})",
   "user_joined": "Inscrit le {date}",
   "user_followers_label": "abonnés",
   "user_following_label": "abonnements",
   "user_no_books": "Aucun livre dans la bibliothèque pour l'instant.",
-
   "admin_pages_label": "Pages",
   "admin_tools_label": "Outils",
   "admin_nav_scrape": "Scrape",
@@ -404,12 +378,12 @@
   "admin_nav_text_gen": "Text Gen",
   "admin_nav_catalogue_tools": "Catalogue Tools",
   "admin_nav_ai_jobs": "Tâches IA",
+  "admin_nav_notifications": "Notifications",
   "admin_nav_errors": "Erreurs",
   "admin_nav_analytics": "Analytique",
   "admin_nav_logs": "Journaux",
   "admin_nav_uptime": "Disponibilité",
   "admin_nav_push": "Notifications",
-
   "admin_scrape_status_idle": "Inactif",
   "admin_scrape_full_catalogue": "Catalogue complet",
   "admin_scrape_single_book": "Livre unique",
@@ -420,25 +394,21 @@
   "admin_scrape_start": "Démarrer l'extraction",
   "admin_scrape_queuing": "En file d'attente…",
   "admin_scrape_running": "En cours…",
-
   "admin_audio_filter_jobs": "Filtrer par slug, voix ou statut…",
   "admin_audio_filter_cache": "Filtrer par slug, chapitre ou voix…",
   "admin_audio_no_matching_jobs": "Aucun job correspondant.",
   "admin_audio_no_jobs": "Aucun job audio pour l'instant.",
   "admin_audio_cache_empty": "Cache audio vide.",
   "admin_audio_no_cache_results": "Aucun résultat.",
-
   "admin_changelog_gitea": "Releases Gitea",
   "admin_changelog_no_releases": "Aucune release trouvée.",
   "admin_changelog_load_error": "Impossible de charger les releases : {error}",
-
   "comments_top": "Les meilleures",
   "comments_new": "Nouvelles",
   "comments_posting": "Publication…",
   "comments_login_link": "Connectez-vous",
   "comments_login_suffix": "pour laisser un commentaire.",
   "comments_anonymous": "Anonyme",
-
   "reader_audio_narration": "Narration Audio",
   "reader_playing": "Lecture en cours — contrôles ci-dessous",
   "reader_paused": "En pause — contrôles ci-dessous",
@@ -451,7 +421,6 @@
   "reader_voice_applies_next": "La nouvelle voix s'appliquera au prochain « Lire la narration ».",
   "reader_choose_voice": "Choisir une voix",
   "reader_generating_narration": "Génération de la narration…",
-
   "profile_font_family": "Police",
   "profile_font_system": "Système",
   "profile_font_serif": "Serif",
@@ -461,7 +430,6 @@
   "profile_text_size_md": "Normal",
   "profile_text_size_lg": "Grand",
   "profile_text_size_xl": "Très grand",
-
   "feed_page_title": "Fil — LibNovel",
   "feed_heading": "Fil d'abonnements",
   "feed_subheading": "Livres lus par vos abonnements",
@@ -473,5 +441,18 @@
   "feed_browse_cta": "Parcourir le catalogue",
   "feed_find_users_cta": "Trouver des lecteurs",
   "admin_nav_gitea": "Gitea",
-  "admin_nav_grafana": "Grafana"
+  "admin_nav_grafana": "Grafana",
+  "admin_translation_page_title": "Translation — Admin",
+  "admin_translation_heading": "Machine Translation",
+  "admin_translation_tab_enqueue": "Enqueue",
+  "admin_translation_tab_jobs": "Jobs",
+  "admin_translation_filter_placeholder": "Filter by slug, lang, or status…",
+  "admin_translation_no_matching": "No matching jobs.",
+  "admin_translation_no_jobs": "No translation jobs yet.",
+  "admin_ai_jobs_page_title": "AI Jobs — Admin",
+  "admin_ai_jobs_heading": "AI Jobs",
+  "admin_ai_jobs_subheading": "Background AI generation tasks",
+  "admin_text_gen_page_title": "Text Gen — Admin",
+  "admin_text_gen_heading": "Text Generation",
+  "admin_nav_import": "Import"
 }

ui/messages/id.json

@@ -1,6 +1,5 @@
 {
   "$schema": "https://inlang.com/schema/inlang-message-format",
-
   "nav_library": "Perpustakaan",
   "nav_catalogue": "Katalog",
   "nav_feed": "Umpan",
@@ -11,7 +10,6 @@
   "nav_sign_out": "Keluar",
   "nav_toggle_menu": "Menu",
   "nav_admin_panel": "Panel admin",
-
   "footer_library": "Perpustakaan",
   "footer_catalogue": "Katalog",
   "footer_feedback": "Masukan",
@@ -20,7 +18,6 @@
   "footer_dmca": "DMCA",
   "footer_copyright": "© {year} libnovel",
   "footer_dev": "dev",
-
   "home_title": "libnovel",
   "home_stat_books": "Buku",
   "home_stat_chapters": "Bab",
@@ -34,7 +31,6 @@
   "home_discover_novels": "Temukan Novel",
   "home_via_reader": "via {username}",
   "home_chapter_badge": "bab.{n}",
-
   "player_generating": "Membuat… {percent}%",
   "player_loading": "Memuat…",
   "player_chapters": "Bab",
@@ -58,7 +54,6 @@
   "player_auto_next_aria": "Auto-lanjut {state}",
   "player_go_to_chapter": "Pergi ke bab",
   "player_close": "Tutup pemutar",
-
   "login_page_title": "Masuk — libnovel",
   "login_heading": "Masuk ke libnovel",
   "login_subheading": "Pilih penyedia untuk melanjutkan",
@@ -68,7 +63,6 @@
   "login_error_oauth_state": "Masuk dibatalkan atau kedaluwarsa. Coba lagi.",
   "login_error_oauth_failed": "Tidak dapat terhubung ke penyedia. Coba lagi.",
   "login_error_oauth_no_email": "Akunmu tidak memiliki alamat email terverifikasi. Tambahkan dan coba lagi.",
-
   "books_page_title": "Perpustakaan — libnovel",
   "books_heading": "Perpustakaanmu",
   "books_empty_title": "Belum ada buku",
@@ -78,7 +72,6 @@
   "books_last_read": "Terakhir: Bab.{n}",
   "books_reading_progress": "Bab.{current} / {total}",
   "books_remove": "Hapus",
-
   "catalogue_page_title": "Katalog — libnovel",
   "catalogue_heading": "Katalog",
   "catalogue_search_placeholder": "Cari novel…",
@@ -99,7 +92,6 @@
   "catalogue_loading": "Memuat…",
   "catalogue_load_more": "Muat lebih banyak",
   "catalogue_results_count": "{n} hasil",
-
   "book_detail_page_title": "{title} — libnovel",
   "book_detail_signin_to_save": "Masuk untuk menyimpan",
   "book_detail_add_to_library": "Tambah ke Perpustakaan",
@@ -116,13 +108,11 @@
   "book_detail_rescrape": "Perbarui",
   "book_detail_scraping": "Memperbarui…",
   "book_detail_in_library": "Ada di Perpustakaan",
-
   "chapters_page_title": "Bab — {title}",
   "chapters_heading": "Bab",
   "chapters_back_to_book": "Kembali ke buku",
   "chapters_reading_now": "Sedang dibaca",
   "chapters_empty": "Belum ada bab yang diambil.",
-
   "reader_page_title": "{title} — Bab.{n} — libnovel",
   "reader_play_narration": "Putar narasi",
   "reader_generating_audio": "Membuat audio…",
@@ -144,7 +134,6 @@
   "reader_auto_next": "Auto-lanjut",
   "reader_speed": "Kecepatan",
   "reader_preview_notice": "Pratinjau — bab ini belum sepenuhnya diambil.",
-
   "profile_page_title": "Profil — libnovel",
   "profile_heading": "Profil",
   "profile_avatar_label": "Avatar",
@@ -161,6 +150,9 @@
   "profile_theme_amber": "Amber",
   "profile_theme_slate": "Abu-abu",
   "profile_theme_rose": "Mawar",
+  "profile_theme_forest": "Hutan",
+  "profile_theme_mono": "Mono",
+  "profile_theme_cyber": "Cyberpunk",
   "profile_theme_light": "Light",
   "profile_theme_light_slate": "Light Blue",
   "profile_theme_light_rose": "Light Rose",
@@ -176,7 +168,6 @@
   "profile_sessions_heading": "Sesi aktif",
   "profile_sign_out_all": "Keluar dari semua perangkat lain",
   "profile_joined": "Bergabung {date}",
-
   "user_page_title": "{username} — libnovel",
   "user_library_heading": "Perpustakaan {username}",
   "user_follow": "Ikuti",
@@ -184,13 +175,11 @@
   "user_followers": "{n} pengikut",
   "user_following": "{n} mengikuti",
   "user_library_empty": "Tidak ada buku di perpustakaan.",
-
   "error_not_found_title": "Halaman tidak ditemukan",
   "error_not_found_body": "Halaman yang kamu cari tidak ada.",
   "error_generic_title": "Terjadi kesalahan",
   "error_go_home": "Ke beranda",
   "error_status": "Error {status}",
-
   "admin_scrape_page_title": "Scrape — Admin",
   "admin_scrape_heading": "Scrape",
   "admin_scrape_catalogue": "Scrape Katalog",
@@ -208,14 +197,11 @@
   "admin_scrape_status_cancelled": "Dibatalkan",
   "admin_tasks_heading": "Tugas terbaru",
   "admin_tasks_empty": "Belum ada tugas.",
-
   "admin_audio_page_title": "Audio — Admin",
   "admin_audio_heading": "Tugas Audio",
   "admin_audio_empty": "Tidak ada tugas audio.",
-
   "admin_changelog_page_title": "Changelog — Admin",
   "admin_changelog_heading": "Changelog",
-
   "comments_heading": "Komentar",
   "comments_empty": "Belum ada komentar. Jadilah yang pertama!",
   "comments_placeholder": "Tulis komentar…",
@@ -229,12 +215,10 @@
   "comments_hide_replies": "Sembunyikan balasan",
   "comments_edited": "diedit",
   "comments_deleted": "[dihapus]",
-
   "disclaimer_page_title": "Penyangkalan — libnovel",
   "privacy_page_title": "Kebijakan Privasi — libnovel",
   "dmca_page_title": "DMCA — libnovel",
   "terms_page_title": "Syarat Layanan — libnovel",
-
   "common_loading": "Memuat…",
   "common_error": "Error",
   "common_save": "Simpan",
@@ -248,15 +232,12 @@
   "common_no": "Tidak",
   "common_on": "aktif",
   "common_off": "nonaktif",
-
   "locale_switcher_label": "Bahasa",
-
   "books_empty_library": "Perpustakaanmu kosong.",
   "books_empty_discover": "Buku yang mulai kamu baca atau simpan dari",
   "books_empty_discover_link": "Temukan",
   "books_empty_discover_suffix": "akan muncul di sini.",
   "books_count": "{n} buku",
-
   "catalogue_sort_updated": "Diperbarui",
   "catalogue_search_button": "Cari",
   "catalogue_refresh": "Segarkan",
@@ -289,7 +270,6 @@
   "catalogue_scrape_forbidden_badge": "Terlarang",
   "catalogue_scrape_novel_button": "Scrape",
   "catalogue_scraping_novel": "Scraping…",
-
   "book_detail_not_in_library": "tidak di perpustakaan",
   "book_detail_continue_ch": "Lanjutkan bab.{n}",
   "book_detail_start_ch1": "Mulai dari bab.1",
@@ -325,18 +305,15 @@
   "book_detail_rescrape_book": "Scrape ulang buku",
   "book_detail_less": "Lebih sedikit",
   "book_detail_more": "Selengkapnya",
-
   "chapters_search_placeholder": "Cari bab…",
   "chapters_jump_to": "Loncat ke Bab.{n}",
   "chapters_no_match": "Tidak ada bab yang cocok dengan \"{q}\"",
   "chapters_none_available": "Belum ada bab tersedia.",
   "chapters_reading_indicator": "sedang dibaca",
   "chapters_result_count": "{n} hasil",
-
   "reader_fetching_chapter": "Mengambil bab…",
   "reader_words": "{n} kata",
   "reader_preview_audio_notice": "Pratinjau — audio tidak tersedia untuk buku di luar perpustakaan.",
-
   "profile_click_to_change": "Klik avatar untuk mengganti foto",
   "profile_tts_voice": "Suara TTS",
   "profile_auto_advance": "Otomatis lanjut ke bab berikutnya",
@@ -354,7 +331,6 @@
   "profile_updating": "Memperbarui…",
   "profile_password_changed_ok": "Kata sandi berhasil diubah.",
   "profile_playback_speed": "Kecepatan pemutaran — {speed}x",
-
   "profile_subscription_heading": "Langganan",
   "profile_plan_pro": "Pro",
   "profile_plan_free": "Gratis",
@@ -366,7 +342,7 @@
   "profile_upgrade_monthly": "Bulanan — $6 / bln",
   "profile_upgrade_annual": "Tahunan — $48 / thn",
   "profile_free_limits": "Paket gratis: 3 bab audio per hari, hanya bahasa Inggris.",
-  "subscribe_page_title": "Jadi Pro \u2014 libnovel",
+  "subscribe_page_title": "Jadi Pro — libnovel",
   "subscribe_heading": "Baca lebih. Dengarkan lebih.",
   "subscribe_subheading": "Tingkatkan ke Pro dan buka pengalaman libnovel sepenuhnya.",
   "subscribe_monthly_label": "Bulanan",
@@ -386,14 +362,12 @@
   "subscribe_benefit_downloads": "Unduh bab untuk didengarkan secara offline",
   "subscribe_login_prompt": "Masuk untuk berlangganan",
   "subscribe_login_cta": "Masuk",
-
   "user_currently_reading": "Sedang Dibaca",
   "user_library_count": "Perpustakaan ({n})",
   "user_joined": "Bergabung {date}",
   "user_followers_label": "pengikut",
   "user_following_label": "mengikuti",
   "user_no_books": "Belum ada buku di perpustakaan.",
-
   "admin_pages_label": "Halaman",
   "admin_tools_label": "Alat",
   "admin_nav_scrape": "Scrape",
@@ -404,12 +378,12 @@
   "admin_nav_text_gen": "Text Gen",
   "admin_nav_catalogue_tools": "Catalogue Tools",
   "admin_nav_ai_jobs": "Tugas AI",
+  "admin_nav_notifications": "Notifikasi",
   "admin_nav_errors": "Kesalahan",
   "admin_nav_analytics": "Analitik",
   "admin_nav_logs": "Log",
   "admin_nav_uptime": "Uptime",
   "admin_nav_push": "Notifikasi",
-
   "admin_scrape_status_idle": "Menunggu",
   "admin_scrape_full_catalogue": "Katalog penuh",
   "admin_scrape_single_book": "Satu buku",
@@ -420,25 +394,21 @@
   "admin_scrape_start": "Mulai scrape",
   "admin_scrape_queuing": "Mengantri…",
   "admin_scrape_running": "Berjalan…",
-
   "admin_audio_filter_jobs": "Filter berdasarkan slug, suara, atau status…",
   "admin_audio_filter_cache": "Filter berdasarkan slug, bab, atau suara…",
   "admin_audio_no_matching_jobs": "Tidak ada pekerjaan yang cocok.",
   "admin_audio_no_jobs": "Belum ada pekerjaan audio.",
   "admin_audio_cache_empty": "Cache audio kosong.",
   "admin_audio_no_cache_results": "Tidak ada hasil.",
-
   "admin_changelog_gitea": "Rilis Gitea",
   "admin_changelog_no_releases": "Tidak ada rilis.",
   "admin_changelog_load_error": "Gagal memuat rilis: {error}",
-
   "comments_top": "Teratas",
   "comments_new": "Terbaru",
   "comments_posting": "Mengirim…",
   "comments_login_link": "Masuk",
   "comments_login_suffix": "untuk meninggalkan komentar.",
   "comments_anonymous": "Anonim",
-
   "reader_audio_narration": "Narasi Audio",
   "reader_playing": "Memutar — kontrol di bawah",
   "reader_paused": "Dijeda — kontrol di bawah",
@@ -451,7 +421,6 @@
   "reader_voice_applies_next": "Suara baru berlaku pada \"Putar narasi\" berikutnya.",
   "reader_choose_voice": "Pilih Suara",
   "reader_generating_narration": "Membuat narasi…",
-
   "profile_font_family": "Jenis Font",
   "profile_font_system": "Sistem",
   "profile_font_serif": "Serif",
@@ -461,7 +430,6 @@
   "profile_text_size_md": "Normal",
   "profile_text_size_lg": "Besar",
   "profile_text_size_xl": "Sangat Besar",
-
   "feed_page_title": "Umpan — LibNovel",
   "feed_heading": "Umpan Ikutan",
   "feed_subheading": "Buku yang sedang dibaca oleh pengguna yang Anda ikuti",
@@ -473,5 +441,18 @@
   "feed_browse_cta": "Jelajahi katalog",
   "feed_find_users_cta": "Temukan pembaca",
   "admin_nav_gitea": "Gitea",
-  "admin_nav_grafana": "Grafana"
+  "admin_nav_grafana": "Grafana",
+  "admin_translation_page_title": "Translation — Admin",
+  "admin_translation_heading": "Machine Translation",
+  "admin_translation_tab_enqueue": "Enqueue",
+  "admin_translation_tab_jobs": "Jobs",
+  "admin_translation_filter_placeholder": "Filter by slug, lang, or status…",
+  "admin_translation_no_matching": "No matching jobs.",
+  "admin_translation_no_jobs": "No translation jobs yet.",
+  "admin_ai_jobs_page_title": "AI Jobs — Admin",
+  "admin_ai_jobs_heading": "AI Jobs",
+  "admin_ai_jobs_subheading": "Background AI generation tasks",
+  "admin_text_gen_page_title": "Text Gen — Admin",
+  "admin_text_gen_heading": "Text Generation",
+  "admin_nav_import": "Import"
 }

ui/messages/pt.json

@@ -1,6 +1,5 @@
 {
   "$schema": "https://inlang.com/schema/inlang-message-format",
-
   "nav_library": "Biblioteca",
   "nav_catalogue": "Catálogo",
   "nav_feed": "Feed",
@@ -11,7 +10,6 @@
   "nav_sign_out": "Sair",
   "nav_toggle_menu": "Menu",
   "nav_admin_panel": "Painel admin",
-
   "footer_library": "Biblioteca",
   "footer_catalogue": "Catálogo",
   "footer_feedback": "Feedback",
@@ -20,7 +18,6 @@
   "footer_dmca": "DMCA",
   "footer_copyright": "© {year} libnovel",
   "footer_dev": "dev",
-
   "home_title": "libnovel",
   "home_stat_books": "Livros",
   "home_stat_chapters": "Capítulos",
@@ -34,7 +31,6 @@
   "home_discover_novels": "Descobrir Romances",
   "home_via_reader": "via {username}",
   "home_chapter_badge": "cap.{n}",
-
   "player_generating": "Gerando… {percent}%",
   "player_loading": "Carregando…",
   "player_chapters": "Capítulos",
@@ -58,7 +54,6 @@
   "player_auto_next_aria": "Próximo automático {state}",
   "player_go_to_chapter": "Ir para capítulo",
   "player_close": "Fechar player",
-
   "login_page_title": "Entrar — libnovel",
   "login_heading": "Entrar no libnovel",
   "login_subheading": "Escolha um provedor para continuar",
@@ -68,7 +63,6 @@
   "login_error_oauth_state": "Login cancelado ou expirado. Tente novamente.",
   "login_error_oauth_failed": "Não foi possível conectar ao provedor. Tente novamente.",
   "login_error_oauth_no_email": "Sua conta não tem endereço de email verificado. Adicione um e tente novamente.",
-
   "books_page_title": "Biblioteca — libnovel",
   "books_heading": "Sua Biblioteca",
   "books_empty_title": "Nenhum livro ainda",
@@ -78,7 +72,6 @@
   "books_last_read": "Último: Cap.{n}",
   "books_reading_progress": "Cap.{current} / {total}",
   "books_remove": "Remover",
-
   "catalogue_page_title": "Catálogo — libnovel",
   "catalogue_heading": "Catálogo",
   "catalogue_search_placeholder": "Pesquisar romances…",
@@ -99,7 +92,6 @@
   "catalogue_loading": "Carregando…",
   "catalogue_load_more": "Carregar mais",
   "catalogue_results_count": "{n} resultados",
-
   "book_detail_page_title": "{title} — libnovel",
   "book_detail_signin_to_save": "Entre para salvar",
   "book_detail_add_to_library": "Adicionar à Biblioteca",
@@ -116,13 +108,11 @@
   "book_detail_rescrape": "Atualizar",
   "book_detail_scraping": "Atualizando…",
   "book_detail_in_library": "Na Biblioteca",
-
   "chapters_page_title": "Capítulos — {title}",
   "chapters_heading": "Capítulos",
   "chapters_back_to_book": "Voltar ao livro",
   "chapters_reading_now": "Lendo",
   "chapters_empty": "Nenhum capítulo extraído ainda.",
-
   "reader_page_title": "{title} — Cap.{n} — libnovel",
   "reader_play_narration": "Reproduzir narração",
   "reader_generating_audio": "Gerando áudio…",
@@ -144,7 +134,6 @@
   "reader_auto_next": "Próximo automático",
   "reader_speed": "Velocidade",
   "reader_preview_notice": "Prévia — este capítulo não foi totalmente extraído.",
-
   "profile_page_title": "Perfil — libnovel",
   "profile_heading": "Perfil",
   "profile_avatar_label": "Avatar",
@@ -161,6 +150,9 @@
   "profile_theme_amber": "Âmbar",
   "profile_theme_slate": "Ardósia",
   "profile_theme_rose": "Rosa",
+  "profile_theme_forest": "Floresta",
+  "profile_theme_mono": "Mono",
+  "profile_theme_cyber": "Cyberpunk",
   "profile_theme_light": "Light",
   "profile_theme_light_slate": "Light Blue",
   "profile_theme_light_rose": "Light Rose",
@@ -176,7 +168,6 @@
   "profile_sessions_heading": "Sessões ativas",
   "profile_sign_out_all": "Sair de todos os outros dispositivos",
   "profile_joined": "Entrou em {date}",
-
   "user_page_title": "{username} — libnovel",
   "user_library_heading": "Biblioteca de {username}",
   "user_follow": "Seguir",
@@ -184,13 +175,11 @@
   "user_followers": "{n} seguidores",
   "user_following": "{n} seguindo",
   "user_library_empty": "Nenhum livro na biblioteca.",
-
   "error_not_found_title": "Página não encontrada",
   "error_not_found_body": "A página que você procura não existe.",
   "error_generic_title": "Algo deu errado",
   "error_go_home": "Ir para início",
   "error_status": "Erro {status}",
-
   "admin_scrape_page_title": "Extração — Admin",
   "admin_scrape_heading": "Extração",
   "admin_scrape_catalogue": "Extrair Catálogo",
@@ -208,14 +197,11 @@
   "admin_scrape_status_cancelled": "Cancelado",
   "admin_tasks_heading": "Tarefas recentes",
   "admin_tasks_empty": "Nenhuma tarefa ainda.",
-
   "admin_audio_page_title": "Áudio — Admin",
   "admin_audio_heading": "Tarefas de Áudio",
   "admin_audio_empty": "Nenhuma tarefa de áudio.",
-
   "admin_changelog_page_title": "Changelog — Admin",
   "admin_changelog_heading": "Changelog",
-
   "comments_heading": "Comentários",
   "comments_empty": "Nenhum comentário ainda. Seja o primeiro!",
   "comments_placeholder": "Escreva um comentário…",
@@ -229,12 +215,10 @@
   "comments_hide_replies": "Ocultar respostas",
   "comments_edited": "editado",
   "comments_deleted": "[excluído]",
-
   "disclaimer_page_title": "Aviso Legal — libnovel",
   "privacy_page_title": "Política de Privacidade — libnovel",
   "dmca_page_title": "DMCA — libnovel",
   "terms_page_title": "Termos de Serviço — libnovel",
-
   "common_loading": "Carregando…",
   "common_error": "Erro",
   "common_save": "Salvar",
@@ -248,15 +232,12 @@
   "common_no": "Não",
   "common_on": "ativado",
   "common_off": "desativado",
-
   "locale_switcher_label": "Idioma",
-
   "books_empty_library": "Sua biblioteca está vazia.",
   "books_empty_discover": "Livros que você começar a ler ou salvar de",
   "books_empty_discover_link": "Descobrir",
   "books_empty_discover_suffix": "aparecerão aqui.",
   "books_count": "{n} livro{s}",
-
   "catalogue_sort_updated": "Atualizado",
   "catalogue_search_button": "Pesquisar",
   "catalogue_refresh": "Atualizar",
@@ -289,7 +270,6 @@
   "catalogue_scrape_forbidden_badge": "Proibido",
   "catalogue_scrape_novel_button": "Extrair",
   "catalogue_scraping_novel": "Extraindo…",
-
   "book_detail_not_in_library": "não está na biblioteca",
   "book_detail_continue_ch": "Continuar cap.{n}",
   "book_detail_start_ch1": "Começar pelo cap.1",
@@ -325,18 +305,15 @@
   "book_detail_rescrape_book": "Reextrair livro",
   "book_detail_less": "Menos",
   "book_detail_more": "Mais",
-
   "chapters_search_placeholder": "Pesquisar capítulos…",
   "chapters_jump_to": "Ir para Cap.{n}",
   "chapters_no_match": "Nenhum capítulo encontrado para \"{q}\"",
   "chapters_none_available": "Nenhum capítulo disponível ainda.",
   "chapters_reading_indicator": "lendo",
   "chapters_result_count": "{n} resultados",
-
   "reader_fetching_chapter": "Buscando capítulo…",
   "reader_words": "{n} palavras",
   "reader_preview_audio_notice": "Prévia — áudio não disponível para livros fora da biblioteca.",
-
   "profile_click_to_change": "Clique no avatar para mudar a foto",
   "profile_tts_voice": "Voz TTS",
   "profile_auto_advance": "Avançar automaticamente para o próximo capítulo",
@@ -354,7 +331,6 @@
   "profile_updating": "Atualizando…",
   "profile_password_changed_ok": "Senha alterada com sucesso.",
   "profile_playback_speed": "Velocidade de reprodução — {speed}x",
-
   "profile_subscription_heading": "Assinatura",
   "profile_plan_pro": "Pro",
   "profile_plan_free": "Gratuito",
@@ -366,7 +342,7 @@
   "profile_upgrade_monthly": "Mensal — $6 / mês",
   "profile_upgrade_annual": "Anual — $48 / ano",
   "profile_free_limits": "Plano gratuito: 3 capítulos de áudio por dia, somente inglês.",
-  "subscribe_page_title": "Seja Pro \u2014 libnovel",
+  "subscribe_page_title": "Seja Pro — libnovel",
   "subscribe_heading": "Leia mais. Ouça mais.",
   "subscribe_subheading": "Torne-se Pro e desbloqueie a experiência completa do libnovel.",
   "subscribe_monthly_label": "Mensal",
@@ -386,14 +362,12 @@
   "subscribe_benefit_downloads": "Baixe capítulos para ouvir offline",
   "subscribe_login_prompt": "Entre para assinar",
   "subscribe_login_cta": "Entrar",
-
   "user_currently_reading": "Lendo Agora",
   "user_library_count": "Biblioteca ({n})",
   "user_joined": "Entrou em {date}",
   "user_followers_label": "seguidores",
   "user_following_label": "seguindo",
   "user_no_books": "Nenhum livro na biblioteca ainda.",
-
   "admin_pages_label": "Páginas",
   "admin_tools_label": "Ferramentas",
   "admin_nav_scrape": "Scrape",
@@ -404,12 +378,12 @@
   "admin_nav_text_gen": "Text Gen",
   "admin_nav_catalogue_tools": "Catalogue Tools",
   "admin_nav_ai_jobs": "Tarefas de IA",
+  "admin_nav_notifications": "Notificações",
   "admin_nav_errors": "Erros",
   "admin_nav_analytics": "Análise",
   "admin_nav_logs": "Logs",
   "admin_nav_uptime": "Uptime",
   "admin_nav_push": "Notificações",
-
   "admin_scrape_status_idle": "Ocioso",
   "admin_scrape_full_catalogue": "Catálogo completo",
   "admin_scrape_single_book": "Livro único",
@@ -420,25 +394,21 @@
   "admin_scrape_start": "Iniciar extração",
   "admin_scrape_queuing": "Na fila…",
   "admin_scrape_running": "Executando…",
-
   "admin_audio_filter_jobs": "Filtrar por slug, voz ou status…",
   "admin_audio_filter_cache": "Filtrar por slug, capítulo ou voz…",
   "admin_audio_no_matching_jobs": "Nenhum job correspondente.",
   "admin_audio_no_jobs": "Nenhum job de áudio ainda.",
   "admin_audio_cache_empty": "Cache de áudio vazio.",
   "admin_audio_no_cache_results": "Sem resultados.",
-
   "admin_changelog_gitea": "Releases do Gitea",
   "admin_changelog_no_releases": "Nenhum release encontrado.",
   "admin_changelog_load_error": "Não foi possível carregar os releases: {error}",
-
   "comments_top": "Mais votados",
   "comments_new": "Novos",
   "comments_posting": "Publicando…",
   "comments_login_link": "Entre",
   "comments_login_suffix": "para deixar um comentário.",
   "comments_anonymous": "Anônimo",
-
   "reader_audio_narration": "Narração em Áudio",
   "reader_playing": "Reproduzindo — controles abaixo",
   "reader_paused": "Pausado — controles abaixo",
@@ -451,7 +421,6 @@
   "reader_voice_applies_next": "A nova voz será aplicada no próximo \"Reproduzir narração\".",
   "reader_choose_voice": "Escolher Voz",
   "reader_generating_narration": "Gerando narração…",
-
   "profile_font_family": "Fonte",
   "profile_font_system": "Sistema",
   "profile_font_serif": "Serif",
@@ -461,7 +430,6 @@
   "profile_text_size_md": "Normal",
   "profile_text_size_lg": "Grande",
   "profile_text_size_xl": "Muito grande",
-
   "feed_page_title": "Feed — LibNovel",
   "feed_heading": "Feed de seguidos",
   "feed_subheading": "Livros que seus seguidos estão lendo",
@@ -473,5 +441,18 @@
   "feed_browse_cta": "Ver catálogo",
   "feed_find_users_cta": "Encontrar leitores",
   "admin_nav_gitea": "Gitea",
-  "admin_nav_grafana": "Grafana"
+  "admin_nav_grafana": "Grafana",
+  "admin_translation_page_title": "Translation — Admin",
+  "admin_translation_heading": "Machine Translation",
+  "admin_translation_tab_enqueue": "Enqueue",
+  "admin_translation_tab_jobs": "Jobs",
+  "admin_translation_filter_placeholder": "Filter by slug, lang, or status…",
+  "admin_translation_no_matching": "No matching jobs.",
+  "admin_translation_no_jobs": "No translation jobs yet.",
+  "admin_ai_jobs_page_title": "AI Jobs — Admin",
+  "admin_ai_jobs_heading": "AI Jobs",
+  "admin_ai_jobs_subheading": "Background AI generation tasks",
+  "admin_text_gen_page_title": "Text Gen — Admin",
+  "admin_text_gen_heading": "Text Generation",
+  "admin_nav_import": "Import"
 }

ui/messages/ru.json

@@ -1,6 +1,5 @@
 {
   "$schema": "https://inlang.com/schema/inlang-message-format",
-
   "nav_library": "Библиотека",
   "nav_catalogue": "Каталог",
   "nav_feed": "Лента",
@@ -11,7 +10,6 @@
   "nav_sign_out": "Выйти",
   "nav_toggle_menu": "Меню",
   "nav_admin_panel": "Панель администратора",
-
   "footer_library": "Библиотека",
   "footer_catalogue": "Каталог",
   "footer_feedback": "Обратная связь",
@@ -20,7 +18,6 @@
   "footer_dmca": "DMCA",
   "footer_copyright": "© {year} libnovel",
   "footer_dev": "dev",
-
   "home_title": "libnovel",
   "home_stat_books": "Книги",
   "home_stat_chapters": "Главы",
@@ -34,7 +31,6 @@
   "home_discover_novels": "Открыть новеллы",
   "home_via_reader": "от {username}",
   "home_chapter_badge": "гл.{n}",
-
   "player_generating": "Генерация… {percent}%",
   "player_loading": "Загрузка…",
   "player_chapters": "Главы",
@@ -58,7 +54,6 @@
   "player_auto_next_aria": "Автопереход {state}",
   "player_go_to_chapter": "Перейти к главе",
   "player_close": "Закрыть плеер",
-
   "login_page_title": "Вход — libnovel",
   "login_heading": "Войти в libnovel",
   "login_subheading": "Выберите провайдера для входа",
@@ -68,7 +63,6 @@
   "login_error_oauth_state": "Вход отменён или истёк срок действия. Попробуйте снова.",
   "login_error_oauth_failed": "Не удалось подключиться к провайдеру. Попробуйте снова.",
   "login_error_oauth_no_email": "У вашего аккаунта нет подтверждённого email. Добавьте его и повторите попытку.",
-
   "books_page_title": "Библиотека — libnovel",
   "books_heading": "Ваша библиотека",
   "books_empty_title": "Книг пока нет",
@@ -78,7 +72,6 @@
   "books_last_read": "Последнее: гл.{n}",
   "books_reading_progress": "Гл.{current} / {total}",
   "books_remove": "Удалить",
-
   "catalogue_page_title": "Каталог — libnovel",
   "catalogue_heading": "Каталог",
   "catalogue_search_placeholder": "Поиск новелл…",
@@ -99,7 +92,6 @@
   "catalogue_loading": "Загрузка…",
   "catalogue_load_more": "Загрузить ещё",
   "catalogue_results_count": "{n} результатов",
-
   "book_detail_page_title": "{title} — libnovel",
   "book_detail_signin_to_save": "Войдите, чтобы сохранить",
   "book_detail_add_to_library": "В библиотеку",
@@ -116,13 +108,11 @@
   "book_detail_rescrape": "Обновить",
   "book_detail_scraping": "Обновление…",
   "book_detail_in_library": "В библиотеке",
-
   "chapters_page_title": "Главы — {title}",
   "chapters_heading": "Главы",
   "chapters_back_to_book": "К книге",
   "chapters_reading_now": "Читается",
   "chapters_empty": "Главы ещё не загружены.",
-
   "reader_page_title": "{title} — Гл.{n} — libnovel",
   "reader_play_narration": "Воспроизвести озвучку",
   "reader_generating_audio": "Генерация аудио…",
@@ -144,7 +134,6 @@
   "reader_auto_next": "Автопереход",
   "reader_speed": "Скорость",
   "reader_preview_notice": "Предпросмотр — эта глава не полностью загружена.",
-
   "profile_page_title": "Профиль — libnovel",
   "profile_heading": "Профиль",
   "profile_avatar_label": "Аватар",
@@ -161,6 +150,9 @@
   "profile_theme_amber": "Янтарь",
   "profile_theme_slate": "Сланец",
   "profile_theme_rose": "Роза",
+  "profile_theme_forest": "Лес",
+  "profile_theme_mono": "Моно",
+  "profile_theme_cyber": "Киберпанк",
   "profile_theme_light": "Light",
   "profile_theme_light_slate": "Light Blue",
   "profile_theme_light_rose": "Light Rose",
@@ -176,7 +168,6 @@
   "profile_sessions_heading": "Активные сессии",
   "profile_sign_out_all": "Выйти на всех других устройствах",
   "profile_joined": "Зарегистрирован {date}",
-
   "user_page_title": "{username} — libnovel",
   "user_library_heading": "Библиотека {username}",
   "user_follow": "Подписаться",
@@ -184,13 +175,11 @@
   "user_followers": "{n} подписчиков",
   "user_following": "{n} подписок",
   "user_library_empty": "В библиотеке нет книг.",
-
   "error_not_found_title": "Страница не найдена",
   "error_not_found_body": "Запрошенная страница не существует.",
   "error_generic_title": "Что-то пошло не так",
   "error_go_home": "На главную",
   "error_status": "Ошибка {status}",
-
   "admin_scrape_page_title": "Парсинг — Админ",
   "admin_scrape_heading": "Парсинг",
   "admin_scrape_catalogue": "Парсинг каталога",
@@ -208,14 +197,11 @@
   "admin_scrape_status_cancelled": "Отменено",
   "admin_tasks_heading": "Последние задачи",
   "admin_tasks_empty": "Задач пока нет.",
-
   "admin_audio_page_title": "Аудио — Админ",
   "admin_audio_heading": "Аудио задачи",
   "admin_audio_empty": "Аудио задач нет.",
-
   "admin_changelog_page_title": "Changelog — Админ",
   "admin_changelog_heading": "Changelog",
-
   "comments_heading": "Комментарии",
   "comments_empty": "Комментариев пока нет. Будьте первым!",
   "comments_placeholder": "Написать комментарий…",
@@ -229,12 +215,10 @@
   "comments_hide_replies": "Скрыть ответы",
   "comments_edited": "изменено",
   "comments_deleted": "[удалено]",
-
   "disclaimer_page_title": "Отказ от ответственности — libnovel",
   "privacy_page_title": "Политика конфиденциальности — libnovel",
   "dmca_page_title": "DMCA — libnovel",
   "terms_page_title": "Условия использования — libnovel",
-
   "common_loading": "Загрузка…",
   "common_error": "Ошибка",
   "common_save": "Сохранить",
@@ -248,15 +232,12 @@
   "common_no": "Нет",
   "common_on": "вкл.",
   "common_off": "выкл.",
-
   "locale_switcher_label": "Язык",
-
   "books_empty_library": "Ваша библиотека пуста.",
   "books_empty_discover": "Книги, которые вы начнёте читать или сохраните из",
   "books_empty_discover_link": "Каталога",
   "books_empty_discover_suffix": "появятся здесь.",
   "books_count": "{n} книг{s}",
-
   "catalogue_sort_updated": "По дате обновления",
   "catalogue_search_button": "Поиск",
   "catalogue_refresh": "Обновить",
@@ -289,7 +270,6 @@
   "catalogue_scrape_forbidden_badge": "Запрещено",
   "catalogue_scrape_novel_button": "Парсить",
   "catalogue_scraping_novel": "Парсинг…",
-
   "book_detail_not_in_library": "не в библиотеке",
   "book_detail_continue_ch": "Продолжить гл.{n}",
   "book_detail_start_ch1": "Начать с гл.1",
@@ -325,18 +305,15 @@
   "book_detail_rescrape_book": "Перепарсить книгу",
   "book_detail_less": "Скрыть",
   "book_detail_more": "Ещё",
-
   "chapters_search_placeholder": "Поиск глав…",
   "chapters_jump_to": "Перейти к гл.{n}",
   "chapters_no_match": "Главы по запросу «{q}» не найдены",
   "chapters_none_available": "Глав пока нет.",
   "chapters_reading_indicator": "читается",
   "chapters_result_count": "{n} результатов",
-
   "reader_fetching_chapter": "Загрузка главы…",
   "reader_words": "{n} слов",
   "reader_preview_audio_notice": "Предпросмотр — аудио недоступно для книг вне библиотеки.",
-
   "profile_click_to_change": "Нажмите на аватар для смены фото",
   "profile_tts_voice": "Голос TTS",
   "profile_auto_advance": "Автопереход к следующей главе",
@@ -354,7 +331,6 @@
   "profile_updating": "Обновление…",
   "profile_password_changed_ok": "Пароль успешно изменён.",
   "profile_playback_speed": "Скорость воспроизведения — {speed}x",
-
   "profile_subscription_heading": "Подписка",
   "profile_plan_pro": "Pro",
   "profile_plan_free": "Бесплатно",
@@ -366,7 +342,7 @@
   "profile_upgrade_monthly": "Ежемесячно — $6 / мес",
   "profile_upgrade_annual": "Ежегодно — $48 / год",
   "profile_free_limits": "Бесплатный план: 3 аудиоглавы в день, только английский.",
-  "subscribe_page_title": "Перейти на Pro \u2014 libnovel",
+  "subscribe_page_title": "Перейти на Pro — libnovel",
   "subscribe_heading": "Читайте больше. Слушайте больше.",
   "subscribe_subheading": "Перейдите на Pro и откройте полный опыт libnovel.",
   "subscribe_monthly_label": "Ежемесячно",
@@ -386,14 +362,12 @@
   "subscribe_benefit_downloads": "Скачивайте главы для прослушивания офлайн",
   "subscribe_login_prompt": "Войдите, чтобы оформить подписку",
   "subscribe_login_cta": "Войти",
-
   "user_currently_reading": "Сейчас читает",
   "user_library_count": "Библиотека ({n})",
   "user_joined": "Зарегистрирован {date}",
   "user_followers_label": "подписчиков",
   "user_following_label": "подписок",
   "user_no_books": "Книг в библиотеке пока нет.",
-
   "admin_pages_label": "Страницы",
   "admin_tools_label": "Инструменты",
   "admin_nav_scrape": "Скрейпинг",
@@ -404,12 +378,12 @@
   "admin_nav_text_gen": "Text Gen",
   "admin_nav_catalogue_tools": "Catalogue Tools",
   "admin_nav_ai_jobs": "Задачи ИИ",
+  "admin_nav_notifications": "Уведомления",
   "admin_nav_errors": "Ошибки",
   "admin_nav_analytics": "Аналитика",
   "admin_nav_logs": "Логи",
   "admin_nav_uptime": "Мониторинг",
   "admin_nav_push": "Уведомления",
-
   "admin_scrape_status_idle": "Ожидание",
   "admin_scrape_full_catalogue": "Полный каталог",
   "admin_scrape_single_book": "Одна книга",
@@ -420,25 +394,21 @@
   "admin_scrape_start": "Начать парсинг",
   "admin_scrape_queuing": "В очереди…",
   "admin_scrape_running": "Выполняется…",
-
   "admin_audio_filter_jobs": "Фильтр по slug, голосу или статусу…",
   "admin_audio_filter_cache": "Фильтр по slug, главе или голосу…",
   "admin_audio_no_matching_jobs": "Заданий не найдено.",
   "admin_audio_no_jobs": "Аудиозаданий пока нет.",
   "admin_audio_cache_empty": "Аудиокэш пуст.",
   "admin_audio_no_cache_results": "Результатов нет.",
-
   "admin_changelog_gitea": "Релизы Gitea",
   "admin_changelog_no_releases": "Релизов не найдено.",
   "admin_changelog_load_error": "Не удалось загрузить релизы: {error}",
-
   "comments_top": "Лучшие",
   "comments_new": "Новые",
   "comments_posting": "Отправка…",
   "comments_login_link": "Войдите",
   "comments_login_suffix": "чтобы оставить комментарий.",
   "comments_anonymous": "Аноним",
-
   "reader_audio_narration": "Аудионарратив",
   "reader_playing": "Воспроизводится — управление ниже",
   "reader_paused": "Пауза — управление ниже",
@@ -451,7 +421,6 @@
   "reader_voice_applies_next": "Новый голос применится при следующем нажатии «Воспроизвести».",
   "reader_choose_voice": "Выбрать голос",
   "reader_generating_narration": "Генерация озвучки…",
-
   "profile_font_family": "Шрифт",
   "profile_font_system": "Системный",
   "profile_font_serif": "Serif",
@@ -461,7 +430,6 @@
   "profile_text_size_md": "Нормальный",
   "profile_text_size_lg": "Большой",
   "profile_text_size_xl": "Очень большой",
-
   "feed_page_title": "Лента — LibNovel",
   "feed_heading": "Лента подписок",
   "feed_subheading": "Книги, которые читают ваши подписки",
@@ -473,5 +441,18 @@
   "feed_browse_cta": "Каталог",
   "feed_find_users_cta": "Найти читателей",
   "admin_nav_gitea": "Gitea",
-  "admin_nav_grafana": "Grafana"
+  "admin_nav_grafana": "Grafana",
+  "admin_translation_page_title": "Translation — Admin",
+  "admin_translation_heading": "Machine Translation",
+  "admin_translation_tab_enqueue": "Enqueue",
+  "admin_translation_tab_jobs": "Jobs",
+  "admin_translation_filter_placeholder": "Filter by slug, lang, or status…",
+  "admin_translation_no_matching": "No matching jobs.",
+  "admin_translation_no_jobs": "No translation jobs yet.",
+  "admin_ai_jobs_page_title": "AI Jobs — Admin",
+  "admin_ai_jobs_heading": "AI Jobs",
+  "admin_ai_jobs_subheading": "Background AI generation tasks",
+  "admin_text_gen_page_title": "Text Gen — Admin",
+  "admin_text_gen_heading": "Text Generation",
+  "admin_nav_import": "Import"
 }

ui/src/app.css

@@ -97,6 +97,48 @@
 	--color-success:   #16a34a;   /* green-600 */
 }
 
+/* ── Forest theme — dark green ────────────────────────────────────────── */
+[data-theme="forest"] {
+	--color-brand:     #4ade80;   /* green-400 */
+	--color-brand-dim: #16a34a;   /* green-600 */
+	--color-surface:   #0a130d;   /* custom near-black green */
+	--color-surface-2: #111c14;   /* custom dark green */
+	--color-surface-3: #1a2e1e;   /* custom mid green */
+	--color-muted:     #6b9a77;   /* custom muted green */
+	--color-text:      #e8f5e9;   /* custom light green-tinted white */
+	--color-border:    #1e3a24;   /* custom green border */
+	--color-danger:    #f87171;   /* red-400 */
+	--color-success:   #4ade80;   /* green-400 */
+}
+
+/* ── Mono theme — pure dark with white accent ─────────────────────────── */
+[data-theme="mono"] {
+	--color-brand:     #f4f4f5;   /* zinc-100 — white accent */
+	--color-brand-dim: #a1a1aa;   /* zinc-400 */
+	--color-surface:   #09090b;   /* zinc-950 */
+	--color-surface-2: #18181b;   /* zinc-900 */
+	--color-surface-3: #27272a;   /* zinc-800 */
+	--color-muted:     #71717a;   /* zinc-500 */
+	--color-text:      #f4f4f5;   /* zinc-100 */
+	--color-border:    #27272a;   /* zinc-800 */
+	--color-danger:    #f87171;   /* red-400 */
+	--color-success:   #4ade80;   /* green-400 */
+}
+
+/* ── Cyberpunk theme — dark with neon cyan/magenta accents ────────────── */
+[data-theme="cyber"] {
+	--color-brand:     #22d3ee;   /* cyan-400 — neon cyan */
+	--color-brand-dim: #06b6d4;   /* cyan-500 */
+	--color-surface:   #050712;   /* custom near-black blue */
+	--color-surface-2: #0d1117;   /* custom dark blue-black */
+	--color-surface-3: #161b27;   /* custom dark blue */
+	--color-muted:     #6272a4;   /* dracula comment blue */
+	--color-text:      #e2e8f0;   /* slate-200 */
+	--color-border:    #1e2d45;   /* custom dark border */
+	--color-danger:    #ff5555;   /* dracula red */
+	--color-success:   #50fa7b;   /* dracula green */
+}
+
 html {
 	background-color: var(--color-surface);
 	color: var(--color-text);
@@ -205,5 +247,22 @@ html {
 	100% { width: 100%; opacity: 0; }
 }
 .animate-progress-bar {
-	animation: progress-bar 8s cubic-bezier(0.1, 0.05, 0.1, 1) forwards;
+	animation: progress-bar 4s cubic-bezier(0.1, 0.05, 0.1, 1) forwards;
+}
+
+/* ── Respect reduced motion — disable all decorative animations ─────── */
+@media (prefers-reduced-motion: reduce) {
+	*,
+	*::before,
+	*::after {
+		animation-duration: 0.01ms !important;
+		animation-iteration-count: 1 !important;
+		transition-duration: 0.01ms !important;
+	}
+}
+
+/* ── Footer content-visibility — skip paint for off-screen footer ───── */
+footer {
+	content-visibility: auto;
+	contain-intrinsic-size: auto 80px;
 }

ui/src/lib/audio.svelte.ts

@@ -36,6 +36,14 @@ import type { Voice } from '$lib/types';
 
 export type AudioStatus = 'idle' | 'loading' | 'generating' | 'ready' | 'error';
 export type NextStatus = 'none' | 'prefetching' | 'prefetched' | 'failed';
+/**
+ * 'stream'   – Use /api/audio-stream: audio starts playing within seconds,
+ *              stream is saved to MinIO concurrently. No runner task needed.
+ * 'generate' – Legacy mode: queue a runner task, poll until done, then play
+ *              from the presigned MinIO URL. Needed for CF AI voices which
+ *              do not support native streaming.
+ */
+export type AudioMode = 'stream' | 'generate';
 
 class AudioStore {
 	// ── What is loaded ──────────────────────────────────────────────────────
@@ -46,6 +54,13 @@ class AudioStore {
 	voice = $state('af_bella');
 	speed = $state(1.0);
 
+	/**
+	 * Playback mode:
+	 * 'stream'   – pipe from /api/audio-stream (low latency, saves concurrently)
+	 * 'generate' – queue runner task, poll, then play presigned URL (CF AI / legacy)
+	 */
+	audioMode = $state<AudioMode>('stream');
+
 	/** Cover image URL for the currently loaded book. */
 	cover = $state('');
 
@@ -101,6 +116,13 @@ class AudioStore {
 	 */
 	autoNext = $state(false);
 
+	/**
+	 * When true, announces the upcoming chapter number and title via the
+	 * Web Speech API before auto-next navigation fires.
+	 * e.g. "Chapter 12 — The Final Battle"
+	 */
+	announceChapter = $state(false);
+
 	/**
 	 * The next chapter number for the currently playing chapter, or null if
 	 * there is no next chapter.  Written by the chapter page's AudioPlayer.
@@ -153,6 +175,19 @@ class AudioStore {
 		return this.slug === slug && this.chapter === chapter;
 	}
 
+	// ── Announce-chapter navigation state ────────────────────────────────────
+	/**
+	 * When true, the <audio> element is playing a short announcement clip
+	 * (not chapter audio).  The next `onended` should navigate to
+	 * announcePendingSlug / announcePendingChapter instead of the normal
+	 * auto-next flow.
+	 */
+	announceNavigatePending = $state(false);
+	/** Target book slug for the pending announce-then-navigate transition. */
+	announcePendingSlug    = $state('');
+	/** Target chapter number for the pending announce-then-navigate transition. */
+	announcePendingChapter = $state(0);
+
 	/** Reset all next-chapter pre-fetch state. */
 	resetNextPrefetch() {
 		this.nextStatus = 'none';

ui/src/lib/components/AudioPlayer.svelte

@@ -70,8 +70,10 @@
 		voices?: Voice[];
 		/** Called when the server returns 402 (free daily limit reached). */
 		onProRequired?: () => void;
-		/** Visual style of the player card. 'standard' = full controls; 'compact' = slim seekable player. */
-		playerStyle?: 'standard' | 'compact';
+	/** Visual style of the player card. 'standard' = inline card; 'float' = draggable overlay. */
+	playerStyle?: 'standard' | 'float';
+		/** Approximate word count for the chapter, used to show estimated listen time in the idle state. */
+		wordCount?: number;
 	}
 
 	let {
@@ -84,9 +86,13 @@
 		chapters = [],
 		voices = [],
 		onProRequired = undefined,
-		playerStyle = 'standard'
+		playerStyle = 'standard',
+		wordCount = 0
 	}: Props = $props();
 
+	/** Estimated listen time in minutes at ~150 wpm average narration speed. */
+	const estimatedMinutes = $derived(wordCount > 0 ? Math.max(1, Math.round(wordCount / 150)) : 0);
+
 	// ── Derived: voices grouped by engine ──────────────────────────────────
 	const kokoroVoices = $derived(voices.filter((v) => v.engine === 'kokoro'));
 	const pocketVoices = $derived(voices.filter((v) => v.engine === 'pocket-tts'));
@@ -241,13 +247,19 @@
 	}
 
 	// Keep nextChapter in the store so the layout's onended can navigate.
-	// NOTE: we do NOT clear on unmount here — the store retains the value so
-	// onended (which may fire after {#key} unmounts this component) can still
-	// read it.  The value is superseded when the new chapter mounts.
+	// We write null on mount (before deriving the real value) so there is no
+	// stale window where the previous chapter's nextChapter is still set while
+	// this chapter's AudioPlayer hasn't written its own value yet.
 	$effect(() => {
 		audioStore.nextChapter = nextChapter ?? null;
 	});
 
+	// Keep chapters list in store up to date so the layout's onended announce
+	// can find titles even if startPlayback() hasn't been called yet on this mount.
+	$effect(() => {
+		if (chapters.length > 0) audioStore.chapters = chapters;
+	});
+
 	// Keep voices in store up to date whenever prop changes.
 	$effect(() => {
 		if (voices.length > 0) audioStore.voices = voices;
@@ -566,21 +578,27 @@
 		audioStore.errorMsg = '';
 
 		try {
-			// Fast path A: pre-fetch already landed for THIS chapter.
+			// Fast path A: pre-fetch already confirmed audio is in MinIO for THIS chapter.
+			// Re-presign instead of using the cached URL — it may have expired if the
+			// user paused for a while between the prefetch and actually reaching this chapter.
 			if (
 				audioStore.nextStatus === 'prefetched' &&
-				audioStore.nextChapterPrefetched === chapter &&
-				audioStore.nextAudioUrl
+				audioStore.nextChapterPrefetched === chapter
 			) {
-				const url = audioStore.nextAudioUrl;
-				// Consume the pre-fetch — reset so it doesn't carry over
+				// Consume the pre-fetch state first so it doesn't carry over on error.
 				audioStore.resetNextPrefetch();
-				audioStore.audioUrl = url;
-				audioStore.status = 'ready';
-				// Don't restore saved time for auto-next; position is 0
-				// Immediately start pre-generating the chapter after this one.
-				maybeStartPrefetch();
-				return;
+				// Fresh presign — audio is confirmed in MinIO so this is a fast, cheap call.
+				const presigned = await tryPresign(slug, chapter, voice);
+				if (presigned.ready) {
+					audioStore.audioUrl = presigned.url;
+					audioStore.status = 'ready';
+					// Don't restore saved time for auto-next; position is 0.
+					// Immediately start pre-generating the chapter after this one.
+					maybeStartPrefetch();
+					return;
+				}
+				// Presign returned not-ready (race: MinIO object vanished?).
+				// Fall through to the normal slow path below.
 			}
 
 			// Fast path B: audio already in MinIO (presign check).
@@ -595,41 +613,95 @@
 				return;
 			}
 
-			// Slow path: audio not yet in MinIO.
-			//
-			// For Kokoro / PocketTTS: always use the streaming endpoint so audio
-			// starts playing within seconds. The stream handler checks MinIO first
-			// (fast redirect if already cached) and otherwise generates + uploads
-			// concurrently. Even if the async runner is already working on this
-			// chapter, the stream will redirect to MinIO the moment the runner
-			// finishes — no harmful double-generation occurs because the backend
-			// deduplications via AudioExists on the next request.
-			if (!voice.startsWith('cfai:')) {
-				// PocketTTS outputs raw WAV — skip the ffmpeg transcode entirely.
-				// WAV (PCM) is natively supported on all platforms including iOS Safari.
-				// Kokoro and CF AI output MP3 natively, so keep mp3 for those.
-				const isPocketTTS = voices.some((v) => v.id === voice && v.engine === 'pocket-tts');
-				const format = isPocketTTS ? 'wav' : 'mp3';
-				const qs = new URLSearchParams({ voice, format });
-				const streamUrl = `/api/audio-stream/${slug}/${chapter}?${qs}`;
-				// HEAD probe: check paywall without triggering generation.
-				const headRes = await fetch(streamUrl, { method: 'HEAD' }).catch(() => null);
-				if (headRes?.status === 402) {
+		// Slow path: audio not yet in MinIO.
+		//
+		// For Kokoro / PocketTTS in 'stream' mode: use the streaming endpoint so
+		// audio starts playing within seconds. The stream handler checks MinIO
+		// first (fast redirect if already cached) and otherwise generates +
+		// uploads concurrently.
+		//
+		// In 'generate' mode (user preference): queue a runner task and poll,
+		// same as CF AI — audio plays only after the full file is ready in MinIO.
+		if (!voice.startsWith('cfai:') && audioStore.audioMode === 'stream') {
+			// PocketTTS outputs raw WAV — skip the ffmpeg transcode entirely.
+			// WAV (PCM) is natively supported on all platforms including iOS Safari.
+			// Kokoro and CF AI output MP3 natively, so keep mp3 for those.
+			const isPocketTTS = voices.some((v) => v.id === voice && v.engine === 'pocket-tts');
+			const format = isPocketTTS ? 'wav' : 'mp3';
+			const qs = new URLSearchParams({ voice, format });
+			const streamUrl = `/api/audio-stream/${slug}/${chapter}?${qs}`;
+			// HEAD probe: check paywall without triggering generation.
+			const headRes = await fetch(streamUrl, { method: 'HEAD' }).catch(() => null);
+			if (headRes?.status === 402) {
+				audioStore.status = 'idle';
+				onProRequired?.();
+				return;
+			}
+			audioStore.audioUrl = streamUrl;
+			audioStore.status = 'ready';
+			maybeStartPrefetch();
+			return;
+		}
+
+		// Non-CF AI voices in 'generate' mode: queue runner task, show progress,
+		// wait for full audio in MinIO before playing (same as CF AI but no preview).
+		if (!voice.startsWith('cfai:')) {
+			audioStore.status = 'generating';
+			audioStore.isPreview = false;
+			startProgress();
+
+			if (!presignResult.enqueued) {
+				const res = await fetch(`/api/audio/${slug}/${chapter}`, {
+					method: 'POST',
+					headers: { 'Content-Type': 'application/json' },
+					body: JSON.stringify({ voice })
+				});
+
+				if (res.status === 402) {
 					audioStore.status = 'idle';
+					stopProgress();
 					onProRequired?.();
 					return;
 				}
-				audioStore.audioUrl = streamUrl;
-				audioStore.status = 'ready';
-				maybeStartPrefetch();
-				return;
+
+				if (!res.ok) throw new Error(`Generation failed: HTTP ${res.status}`);
+
+				if (res.status === 200) {
+					await res.body?.cancel();
+					await finishProgress();
+					const doneUrl = await tryPresign(slug, chapter, voice);
+					if (!doneUrl.ready) throw new Error('Audio generated but presign returned 404');
+					audioStore.audioUrl = doneUrl.url;
+					audioStore.status = 'ready';
+					restoreSavedAudioTime();
+					maybeStartPrefetch();
+					return;
+				}
+				// 202 — runner task enqueued, fall through to poll.
 			}
 
-			// CF AI voices: use preview/swap strategy.
-			// 1. Fetch a short ~1-2 min preview clip from the first text chunk
-			//    so playback starts immediately — no more waiting behind a spinner.
-			// 2. Meanwhile keep polling the full audio job; when it finishes,
-			//    swap the <audio> src to the full URL preserving currentTime.
+			const final = await pollAudioStatus(slug, chapter, voice);
+			if (final.status === 'failed') {
+				throw new Error(
+					`Generation failed: ${(final as { error?: string }).error ?? 'unknown error'}`
+				);
+			}
+
+			await finishProgress();
+			const doneUrl = await tryPresign(slug, chapter, voice);
+			if (!doneUrl.ready) throw new Error('Audio generated but presign returned 404');
+			audioStore.audioUrl = doneUrl.url;
+			audioStore.status = 'ready';
+			restoreSavedAudioTime();
+			maybeStartPrefetch();
+			return;
+		}
+
+		// CF AI voices: use preview/swap strategy.
+		// 1. Fetch a short ~1-2 min preview clip from the first text chunk
+		//    so playback starts immediately — no more waiting behind a spinner.
+		// 2. Meanwhile keep polling the full audio job; when it finishes,
+		//    swap the <audio> src to the full URL preserving currentTime.
 			audioStore.status = 'generating';
 			audioStore.isPreview = false;
 			startProgress();
@@ -873,18 +945,32 @@
 		audioStore.duration > 0 ? (audioStore.currentTime / audioStore.duration) * 100 : 0
 	);
 
-	const SPEED_OPTIONS = [0.75, 1, 1.25, 1.5, 2] as const;
-	function cycleSpeed() {
-		const idx = SPEED_OPTIONS.indexOf(audioStore.speed as (typeof SPEED_OPTIONS)[number]);
-		audioStore.speed = SPEED_OPTIONS[(idx + 1) % SPEED_OPTIONS.length];
-	}
-
-	function seekFromCompactBar(e: MouseEvent) {
+	function seekFromBar(e: MouseEvent) {
 		if (audioStore.duration <= 0) return;
 		const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();
 		const pct = Math.max(0, Math.min(1, (e.clientX - rect.left) / rect.width));
 		audioStore.seekRequest = pct * audioStore.duration;
 	}
+
+	// ── Float player drag state ──────────────────────────────────────────────
+	/** Position of the floating overlay (bottom-right anchor by default). */
+	let floatPos = $state({ x: 0, y: 0 });
+	let floatDragging = $state(false);
+	let floatDragStart = $state({ mx: 0, my: 0, ox: 0, oy: 0 });
+
+	function onFloatPointerDown(e: PointerEvent) {
+		floatDragging = true;
+		floatDragStart = { mx: e.clientX, my: e.clientY, ox: floatPos.x, oy: floatPos.y };
+		(e.currentTarget as HTMLElement).setPointerCapture(e.pointerId);
+	}
+	function onFloatPointerMove(e: PointerEvent) {
+		if (!floatDragging) return;
+		floatPos = {
+			x: floatDragStart.ox + (e.clientX - floatDragStart.mx),
+			y: floatDragStart.oy + (e.clientY - floatDragStart.my)
+		};
+	}
+	function onFloatPointerUp() { floatDragging = false; }
 </script>
 
 <svelte:window onkeydown={handleKeyDown} />
@@ -935,122 +1021,163 @@
 	</div>
 {/snippet}
 
-{#if playerStyle === 'compact'}
-<!-- ── Compact player ──────────────────────────────────────────────────────── -->
-<div class="mt-4 p-3 rounded-lg bg-(--color-surface-2) border border-(--color-border)">
-	{#if audioStore.isCurrentChapter(slug, chapter)}
-		{#if audioStore.status === 'idle' || audioStore.status === 'error'}
-			{#if audioStore.status === 'error'}
-				<p class="text-(--color-danger) text-xs mb-2">{audioStore.errorMsg || 'Failed to load audio.'}</p>
-			{/if}
-			<Button variant="default" size="sm" onclick={handlePlay}>
-				<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24"><path d="M8 5v14l11-7z"/></svg>
+<!-- ── Standard player ─────────────────────────────────────────────────────── -->
+
+{#if
+	(!audioStore.isCurrentChapter(slug, chapter) && !audioStore.active) ||
+	(audioStore.isCurrentChapter(slug, chapter) && (audioStore.status === 'idle' || audioStore.status === 'error'))
+}
+<!-- ── Idle / not-yet-started pill ─────────────────────────────────────────── -->
+<div class="px-3 py-2.5">
+	{#if audioStore.isCurrentChapter(slug, chapter) && audioStore.status === 'error'}
+		<p class="text-(--color-danger) text-xs mb-2">{audioStore.errorMsg || 'Failed to load audio.'}</p>
+	{/if}
+	<div class="flex items-center gap-3">
+		<!-- Big play button -->
+		<button
+			type="button"
+			onclick={handlePlay}
+			class="w-11 h-11 rounded-full bg-(--color-brand) text-(--color-surface) flex items-center justify-center hover:bg-(--color-brand-dim) active:scale-95 transition-all flex-shrink-0 shadow-sm"
+			aria-label={m.reader_play_narration()}
+		>
+			<svg class="w-5 h-5 ml-0.5" fill="currentColor" viewBox="0 0 24 24">
+				<path d="M8 5v14l11-7z"/>
+			</svg>
+		</button>
+
+		<!-- Track info -->
+		<div class="flex-1 min-w-0">
+			<p class="text-sm font-semibold text-(--color-text) leading-tight truncate">
 				{m.reader_play_narration()}
-			</Button>
-
-		{:else if audioStore.status === 'loading'}
-			<div class="flex items-center gap-2 text-xs text-(--color-muted)">
-				<svg class="w-3.5 h-3.5 animate-spin" fill="none" viewBox="0 0 24 24">
-					<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
-					<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"></path>
-				</svg>
-				{m.player_loading()}
-			</div>
-
-		{:else if audioStore.status === 'generating'}
-			<div class="space-y-1.5">
-				<div class="flex items-center justify-between text-xs text-(--color-muted)">
-					<span>{m.reader_generating_narration()}</span>
-					<span class="tabular-nums">{Math.round(audioStore.progress)}%</span>
-				</div>
-				<div class="w-full h-1 bg-(--color-surface-3) rounded-full overflow-hidden">
-					<div class="h-full bg-(--color-brand) rounded-full transition-none" style="width: {audioStore.progress}%"></div>
-				</div>
-			</div>
-
-		{:else if audioStore.status === 'ready'}
-			<div class="space-y-2">
-				<!-- Seekable progress bar -->
-				<!-- svelte-ignore a11y_click_events_have_key_events a11y_no_static_element_interactions -->
-				<div
-					role="none"
-					class="w-full h-1.5 bg-(--color-surface-3) rounded-full overflow-hidden cursor-pointer group"
-					onclick={seekFromCompactBar}
-				>
-					<div class="h-full bg-(--color-brand) rounded-full transition-none" style="width: {playPct}%"></div>
-				</div>
-				<!-- Controls row -->
-				<div class="flex items-center gap-2">
-					<!-- Skip back 15s -->
+			</p>
+			<div class="flex items-center gap-1.5 mt-0.5">
+				<!-- Voice indicator -->
+				{#if voices.length > 0}
 					<button
 						type="button"
-						onclick={() => { audioStore.seekRequest = Math.max(0, audioStore.currentTime - 15); }}
-						class="text-(--color-muted) hover:text-(--color-text) transition-colors flex-shrink-0"
-						title="-15s"
+						onclick={() => { stopSample(); showVoicePanel = !showVoicePanel; showChapterPanel = false; chapterSearch = ''; }}
+						class={cn('flex items-center gap-1 text-xs transition-colors leading-none', showVoicePanel ? 'text-(--color-brand)' : 'text-(--color-muted) hover:text-(--color-text)')}
+						title={m.reader_change_voice()}
 					>
-						<svg class="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M11.99 5V1l-5 5 5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6h-2c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z"/>
+						<svg class="w-3 h-3 flex-shrink-0" fill="currentColor" viewBox="0 0 24 24">
+							<path d="M12 14c1.66 0 3-1.34 3-3V5c0-1.66-1.34-3-3-3S9 3.34 9 5v6c0 1.66 1.34 3 3 3zm-1-9c0-.55.45-1 1-1s1 .45 1 1v6c0 .55-.45 1-1 1s-1-.45-1-1V5zm6 6c0 2.76-2.24 5-5 5s-5-2.24-5-5H5c0 3.53 2.61 6.43 6 6.92V21h2v-3.08c3.39-.49 6-3.39 6-6.92h-2z"/>
+						</svg>
+						<span class="max-w-[90px] truncate">{voiceLabel(audioStore.voice)}</span>
+						<svg class={cn('w-2.5 h-2.5 flex-shrink-0 transition-transform', showVoicePanel && 'rotate-180')} fill="currentColor" viewBox="0 0 24 24">
+							<path d="M7 10l5 5 5-5z"/>
 						</svg>
 					</button>
-					<!-- Play/pause -->
+				{/if}
+				<!-- Estimated duration -->
+				{#if estimatedMinutes > 0}
+					{#if voices.length > 0}<span class="text-(--color-border) text-xs leading-none">·</span>{/if}
+					<span class="text-xs text-(--color-muted) leading-none tabular-nums">~{estimatedMinutes} min</span>
+				{/if}
+				<!-- Stream / Generate mode toggle -->
+				{#if !audioStore.voice.startsWith('cfai:')}
+					<span class="text-(--color-border) text-xs leading-none">·</span>
 					<button
 						type="button"
-						onclick={() => { audioStore.toggleRequest++; }}
-						class="w-8 h-8 rounded-full bg-(--color-brand) text-(--color-surface) flex items-center justify-center hover:bg-(--color-brand-dim) transition-colors flex-shrink-0"
+						onclick={() => { audioStore.audioMode = audioStore.audioMode === 'stream' ? 'generate' : 'stream'; }}
+						class={cn(
+							'flex items-center gap-0.5 text-xs leading-none transition-colors',
+							audioStore.audioMode === 'stream'
+								? 'text-(--color-brand)'
+								: 'text-(--color-muted) hover:text-(--color-text)'
+						)}
+						title={audioStore.audioMode === 'stream' ? 'Stream mode — click to switch to generate' : 'Generate mode — click to switch to stream'}
 					>
-						{#if audioStore.isPlaying}
-							<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24"><path d="M6 4h4v16H6V4zm8 0h4v16h-4V4z"/></svg>
+						{#if audioStore.audioMode === 'stream'}
+							<svg class="w-3 h-3 flex-shrink-0" fill="currentColor" viewBox="0 0 24 24">
+								<path d="M8 5v14l11-7z"/>
+							</svg>
+							Stream
 						{:else}
-							<svg class="w-3.5 h-3.5 ml-0.5" fill="currentColor" viewBox="0 0 24 24"><path d="M8 5v14l11-7z"/></svg>
+							<svg class="w-3 h-3 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+								<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+							</svg>
+							Generate
 						{/if}
 					</button>
-					<!-- Skip forward 30s -->
-					<button
-						type="button"
-						onclick={() => { audioStore.seekRequest = Math.min(audioStore.duration || 0, audioStore.currentTime + 30); }}
-						class="text-(--color-muted) hover:text-(--color-text) transition-colors flex-shrink-0"
-						title="+30s"
-					>
-						<svg class="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M18 13c0 3.31-2.69 6-6 6s-6-2.69-6-6 2.69-6 6-6v4l5-5-5-5v4c-4.42 0-8 3.58-8 8s3.58 8 8 8 8-3.58 8-8h-2z"/>
-						</svg>
-					</button>
-					<!-- Time display -->
-					<span class="flex-1 text-xs text-center tabular-nums text-(--color-muted)">
-						{formatTime(audioStore.currentTime)} / {formatDuration(audioStore.duration)}
-					</span>
-					<!-- Speed cycle -->
-					<button
-						type="button"
-						onclick={cycleSpeed}
-						class="text-xs font-medium text-(--color-muted) hover:text-(--color-text) flex-shrink-0 tabular-nums transition-colors"
-						title="Playback speed"
-					>
-						{audioStore.speed}×
-					</button>
-				</div>
+				{/if}
 			</div>
-		{/if}
-
-	{:else if audioStore.active}
-		<div class="flex items-center justify-between gap-3">
-			<p class="text-xs text-(--color-muted)">
-				{m.reader_now_playing({ title: audioStore.chapterTitle || `Ch.${audioStore.chapter}` })}
-			</p>
-			<Button variant="secondary" size="sm" class="flex-shrink-0" onclick={startPlayback}>
-				{m.reader_load_this_chapter()}
-			</Button>
 		</div>
 
-	{:else}
-		<Button variant="default" size="sm" onclick={handlePlay}>
-			<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24"><path d="M8 5v14l11-7z"/></svg>
-			{m.reader_play_narration()}
-		</Button>
+		<!-- Chapters button (right side) -->
+		{#if chapters.length > 0}
+			<button
+				type="button"
+				onclick={() => { showChapterPanel = !showChapterPanel; showVoicePanel = false; stopSample(); }}
+				class={cn('flex items-center gap-1 px-2 py-1.5 rounded-md text-xs transition-colors flex-shrink-0', showChapterPanel ? 'text-(--color-brand) bg-(--color-brand)/10' : 'text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-3)')}
+				title="Browse chapters"
+			>
+				<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 10h16M4 14h10"/>
+				</svg>
+				<span class="hidden sm:inline">Chapters</span>
+			</button>
+		{/if}
+	</div>
+
+	<!-- Voice selector panel (inline below pill) -->
+	{#if showVoicePanel && voices.length > 0}
+		<div class="mt-3 rounded-lg border border-(--color-border) bg-(--color-surface) overflow-hidden">
+			<div class="px-3 py-2 border-b border-(--color-border) flex items-center justify-between">
+				<span class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider">{m.reader_choose_voice()}</span>
+				<Button
+					variant="ghost"
+					size="icon"
+					class="h-6 w-6 text-(--color-muted) hover:text-(--color-text)"
+					onclick={() => { stopSample(); showVoicePanel = false; }}
+					aria-label={m.reader_close_voice_panel()}
+				>
+					<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+					</svg>
+				</Button>
+			</div>
+			<div class="max-h-64 overflow-y-auto">
+				{#if kokoroVoices.length > 0}
+					<div class="px-3 py-1.5 bg-(--color-surface-2)/70 border-b border-(--color-border)/50">
+						<span class="text-[10px] font-semibold text-(--color-muted) uppercase tracking-widest">Kokoro (GPU)</span>
+					</div>
+					{#each kokoroVoices as v (v.id)}{@render voiceRow(v)}{/each}
+				{/if}
+				{#if pocketVoices.length > 0}
+					<div class="px-3 py-1.5 bg-(--color-surface-2)/70 border-b border-(--color-border)/50 {kokoroVoices.length > 0 ? 'border-t border-(--color-border)' : ''}">
+						<span class="text-[10px] font-semibold text-(--color-muted) uppercase tracking-widest">Pocket TTS (CPU)</span>
+					</div>
+					{#each pocketVoices as v (v.id)}{@render voiceRow(v)}{/each}
+				{/if}
+				{#if cfaiVoices.length > 0}
+					<div class="px-3 py-1.5 bg-(--color-surface-2)/70 border-b border-(--color-border)/50 {kokoroVoices.length > 0 || pocketVoices.length > 0 ? 'border-t border-(--color-border)' : ''}">
+						<span class="text-[10px] font-semibold text-(--color-muted) uppercase tracking-widest">Cloudflare AI</span>
+					</div>
+					{#each cfaiVoices as v (v.id)}{@render voiceRow(v)}{/each}
+				{/if}
+			</div>
+			<div class="px-3 py-2 border-t border-(--color-border) bg-(--color-surface-2)/50">
+				<p class="text-xs text-(--color-muted)">
+					{m.reader_voice_applies_next()}
+					{#if voices.length > 0}
+						<a
+							href="/api/audio/voice-samples"
+							class="text-(--color-muted) hover:text-(--color-brand) transition-colors underline"
+							onclick={(e) => {
+								e.preventDefault();
+								fetch('/api/audio/voice-samples', { method: 'POST' }).catch(() => {});
+							}}
+						>{m.reader_generate_samples()}</a>
+					{/if}
+				</p>
+			</div>
+		</div>
 	{/if}
 </div>
+
 {:else}
-<!-- ── Standard player ─────────────────────────────────────────────────────── -->
+<!-- ── Non-idle states (loading / generating / ready / other-chapter-playing) ── -->
+{#if !(playerStyle === 'float' && audioStore.isCurrentChapter(slug, chapter) && audioStore.active)}
 <div class="p-4">
 	<div class="flex items-center justify-end gap-2 mb-3">
 		<!-- Chapter picker button -->
@@ -1154,94 +1281,11 @@
 		</div>
 	{/if}
 
-	<!-- ── Chapter picker overlay ────────────────────────────────────────── -->
-	{#if showChapterPanel && audioStore.chapters.length > 0}
-		<!-- svelte-ignore a11y_no_static_element_interactions -->
-		<div
-			class="fixed inset-0 z-[60] flex flex-col"
-			style="background: var(--color-surface);"
-		>
-			<!-- Header -->
-			<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0">
-				<button
-					type="button"
-					onclick={() => { showChapterPanel = false; chapterSearch = ''; }}
-					class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-					aria-label="Close chapter picker"
-				>
-					<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
-					</svg>
-				</button>
-				<span class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider flex-1">Chapters</span>
-			</div>
-			<!-- Search -->
-			<div class="px-4 py-3 shrink-0 border-b border-(--color-border)">
-				<div class="relative">
-					<svg class="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-(--color-muted)" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
-					</svg>
-					<input
-						type="search"
-						placeholder="Search chapters…"
-						bind:value={chapterSearch}
-						class="w-full pl-9 pr-4 py-2 text-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg text-(--color-text) placeholder:text-(--color-muted) focus:outline-none focus:border-(--color-brand) transition-colors"
-					/>
-				</div>
-			</div>
-			<!-- Chapter list -->
-			<div class="flex-1 overflow-y-auto">
-				{#each filteredChapters as ch (ch.number)}
-					<button
-						type="button"
-						onclick={() => playChapter(ch.number)}
-						class={cn(
-							'w-full flex items-center gap-3 px-4 py-3 border-b border-(--color-border)/40 transition-colors text-left',
-							ch.number === chapter ? 'bg-(--color-brand)/8' : 'hover:bg-(--color-surface-2)'
-						)}
-					>
-						<!-- Chapter number badge (mirrors voice radio indicator) -->
-						<span class={cn(
-							'w-8 h-8 shrink-0 rounded-full border-2 flex items-center justify-center tabular-nums text-xs font-semibold transition-colors',
-							ch.number === chapter
-								? 'border-(--color-brand) bg-(--color-brand) text-(--color-surface)'
-								: 'border-(--color-border) text-(--color-muted)'
-						)}>{ch.number}</span>
-						<!-- Title -->
-						<span class={cn(
-							'flex-1 text-sm truncate',
-							ch.number === chapter ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)'
-						)}>{ch.title || `Chapter ${ch.number}`}</span>
-						<!-- Now-playing indicator -->
-						{#if ch.number === chapter}
-							<svg class="w-4 h-4 shrink-0 text-(--color-brand)" fill="currentColor" viewBox="0 0 24 24">
-								<path d="M8 5v14l11-7z"/>
-							</svg>
-						{/if}
-					</button>
-				{/each}
-				{#if filteredChapters.length === 0}
-					<p class="px-4 py-8 text-sm text-(--color-muted) text-center">No chapters match "{chapterSearch}"</p>
-				{/if}
-			</div>
-		</div>
-	{/if}
 
 	{#if audioStore.isCurrentChapter(slug, chapter)}
-		<!-- ── This chapter is the active one ── -->
+		<!-- ── This chapter is the active one (non-idle states) ── -->
 
-		{#if audioStore.status === 'idle' || audioStore.status === 'error'}
-			{#if audioStore.status === 'error'}
-				<p class="text-(--color-danger) text-sm mb-2">{audioStore.errorMsg || 'Failed to load audio.'}</p>
-			{/if}
-		<Button variant="default" size="sm" onclick={handlePlay}>
-			<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
-				<path d="M8 5v14l11-7z"/>
-			</svg>
-			{m.reader_play_narration()}
-		</Button>
-
-		{:else if audioStore.status === 'loading'}
+		{#if audioStore.status === 'loading'}
 			<Button variant="default" size="sm" disabled>
 				<svg class="w-3.5 h-3.5 animate-spin" fill="none" viewBox="0 0 24 24">
 					<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
@@ -1282,6 +1326,47 @@
 					</span>
 				</div>
 			</div>
+
+			<!-- Warm-up next chapter (only when autoNext is off and next exists) -->
+			{#if !audioStore.autoNext && nextChapter != null}
+				<div class="mt-2 flex items-center gap-2">
+					{#if audioStore.nextStatus === 'none'}
+						<button
+							type="button"
+							onclick={prefetchNext}
+							class="flex items-center gap-1.5 text-xs text-(--color-muted) hover:text-(--color-brand) transition-colors"
+							title="Pre-generate audio for the next chapter"
+						>
+							<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+								<path d="M7 2l10 10L7 22z"/>
+							</svg>
+							Warm up Ch. {nextChapter}
+						</button>
+					{:else if audioStore.nextStatus === 'prefetching'}
+						<span class="flex items-center gap-1.5 text-xs text-(--color-muted)">
+							<svg class="w-3.5 h-3.5 animate-spin" fill="none" viewBox="0 0 24 24">
+								<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+								<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"></path>
+							</svg>
+							Warming up Ch. {nextChapter}…
+						</span>
+					{:else if audioStore.nextStatus === 'prefetched'}
+						<span class="flex items-center gap-1.5 text-xs text-(--color-brand)">
+							<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+								<path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/>
+							</svg>
+							Ch. {nextChapter} ready
+						</span>
+					{:else if audioStore.nextStatus === 'failed'}
+						<span class="flex items-center gap-1.5 text-xs text-red-400">
+							<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+								<path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>
+							</svg>
+							Warm-up failed
+						</span>
+					{/if}
+				</div>
+			{/if}
 		{/if}
 
 	{:else if audioStore.active}
@@ -1294,15 +1379,186 @@
 				{m.reader_load_this_chapter()}
 			</Button>
 		</div>
-
-	{:else}
-		<!-- ── Idle — nothing playing ── -->
-		<Button variant="default" size="sm" onclick={handlePlay}>
-			<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
-				<path d="M8 5v14l11-7z"/>
-			</svg>
-			{m.reader_play_narration()}
-		</Button>
 	{/if}
 </div>
 {/if}
+{/if}
+
+<!-- ── Chapter picker overlay ─────────────────────────────────────────────────
+     Rendered as a top-level sibling (outside all player containers) so that
+     the fixed inset-0 positioning is never clipped by overflow-hidden or
+     border-radius on any ancestor wrapping the AudioPlayer component.        -->
+{#if showChapterPanel && audioStore.chapters.length > 0}
+	<!-- svelte-ignore a11y_no_static_element_interactions -->
+	<div
+		class="fixed inset-0 z-[60] flex flex-col"
+		style="background: var(--color-surface);"
+	>
+		<!-- Header -->
+		<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0">
+			<span class="text-sm font-semibold text-(--color-text) flex-1">Chapters</span>
+			<button
+				type="button"
+				onclick={() => { showChapterPanel = false; chapterSearch = ''; }}
+				class="w-9 h-9 flex items-center justify-center rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+				aria-label="Close chapter picker"
+			>
+				<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+				</svg>
+			</button>
+		</div>
+		<!-- Search -->
+		<div class="px-4 py-3 shrink-0 border-b border-(--color-border)">
+			<div class="relative">
+				<svg class="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-(--color-muted)" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+				</svg>
+				<input
+					type="search"
+					placeholder="Search chapters…"
+					bind:value={chapterSearch}
+					class="w-full pl-9 pr-4 py-2 text-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg text-(--color-text) placeholder:text-(--color-muted) focus:outline-none focus:border-(--color-brand) transition-colors"
+				/>
+			</div>
+		</div>
+		<!-- Chapter list -->
+		<div class="flex-1 overflow-y-auto">
+			{#each filteredChapters as ch (ch.number)}
+				<button
+					type="button"
+					onclick={() => playChapter(ch.number)}
+					class={cn(
+						'w-full flex items-center gap-3 px-4 py-3 border-b border-(--color-border)/40 transition-colors text-left',
+						ch.number === chapter ? 'bg-(--color-brand)/8' : 'hover:bg-(--color-surface-2)'
+					)}
+				>
+					<!-- Chapter number badge -->
+					<span class={cn(
+						'w-8 h-8 shrink-0 rounded-full border-2 flex items-center justify-center tabular-nums text-xs font-semibold transition-colors',
+						ch.number === chapter
+							? 'border-(--color-brand) bg-(--color-brand) text-(--color-surface)'
+							: 'border-(--color-border) text-(--color-muted)'
+					)}>{ch.number}</span>
+					<!-- Title -->
+					<span class={cn(
+						'flex-1 text-sm truncate',
+						ch.number === chapter ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)'
+					)}>{ch.title || `Chapter ${ch.number}`}</span>
+					<!-- Now-playing indicator -->
+					{#if ch.number === chapter}
+						<svg class="w-4 h-4 shrink-0 text-(--color-brand)" fill="currentColor" viewBox="0 0 24 24">
+							<path d="M8 5v14l11-7z"/>
+						</svg>
+					{/if}
+				</button>
+			{/each}
+			{#if filteredChapters.length === 0}
+				<p class="px-4 py-8 text-sm text-(--color-muted) text-center">No chapters match "{chapterSearch}"</p>
+			{/if}
+		</div>
+	</div>
+{/if}
+
+<!-- ── Float player overlay ──────────────────────────────────────────────────
+     Rendered outside all containers so fixed positioning is never clipped.
+     Visible when playerStyle='float' and audio is active for this chapter.  -->
+{#if playerStyle === 'float' && audioStore.isCurrentChapter(slug, chapter) && audioStore.active}
+	<!-- svelte-ignore a11y_no_static_element_interactions -->
+	<div
+		class="fixed z-[55] select-none"
+		style="
+			bottom: calc(4.5rem + {-floatPos.y}px);
+			right: calc(1rem + {-floatPos.x}px);
+			touch-action: none;
+		"
+	>
+		<div class="w-64 rounded-2xl bg-(--color-surface) border border-(--color-border) shadow-2xl overflow-hidden">
+			<!-- Drag handle + title row -->
+			<!-- svelte-ignore a11y_no_static_element_interactions -->
+			<div
+				class="flex items-center gap-2 px-3 pt-2.5 pb-1 cursor-grab active:cursor-grabbing"
+				onpointerdown={onFloatPointerDown}
+				onpointermove={onFloatPointerMove}
+				onpointerup={onFloatPointerUp}
+				onpointercancel={onFloatPointerUp}
+			>
+				<!-- Drag grip dots -->
+				<svg class="w-3.5 h-3.5 text-(--color-muted)/50 flex-shrink-0" fill="currentColor" viewBox="0 0 24 24">
+					<circle cx="9" cy="6" r="1.5"/><circle cx="15" cy="6" r="1.5"/>
+					<circle cx="9" cy="12" r="1.5"/><circle cx="15" cy="12" r="1.5"/>
+					<circle cx="9" cy="18" r="1.5"/><circle cx="15" cy="18" r="1.5"/>
+				</svg>
+				<span class="flex-1 text-xs font-medium text-(--color-muted) truncate">
+					{audioStore.chapterTitle || `Chapter ${audioStore.chapter}`}
+				</span>
+				<!-- Status dot -->
+				{#if audioStore.isPlaying}
+					<span class="w-1.5 h-1.5 rounded-full bg-(--color-brand) flex-shrink-0 animate-pulse"></span>
+				{/if}
+			</div>
+
+			<!-- Seek bar -->
+			<!-- svelte-ignore a11y_click_events_have_key_events a11y_no_static_element_interactions -->
+			<div
+				role="none"
+				class="mx-3 mb-2 h-1 bg-(--color-surface-3) rounded-full overflow-hidden cursor-pointer"
+				onclick={seekFromBar}
+			>
+				<div class="h-full bg-(--color-brand) rounded-full transition-none" style="width: {playPct}%"></div>
+			</div>
+
+			<!-- Controls row -->
+			<div class="flex items-center gap-1 px-3 pb-2.5">
+				<!-- Skip back 15s -->
+				<button
+					type="button"
+					onclick={() => { audioStore.seekRequest = Math.max(0, audioStore.currentTime - 15); }}
+					class="w-8 h-8 flex items-center justify-center rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors flex-shrink-0"
+					title="-15s"
+				>
+					<svg class="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M11.99 5V1l-5 5 5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6h-2c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z"/>
+					</svg>
+				</button>
+
+				<!-- Play/pause -->
+				<button
+					type="button"
+					onclick={() => { audioStore.toggleRequest++; }}
+					class="w-9 h-9 rounded-full bg-(--color-brand) text-(--color-surface) flex items-center justify-center hover:bg-(--color-brand-dim) active:scale-95 transition-all flex-shrink-0"
+				>
+					{#if audioStore.isPlaying}
+						<svg class="w-4 h-4" fill="currentColor" viewBox="0 0 24 24"><path d="M6 4h4v16H6V4zm8 0h4v16h-4V4z"/></svg>
+					{:else}
+						<svg class="w-4 h-4 ml-0.5" fill="currentColor" viewBox="0 0 24 24"><path d="M8 5v14l11-7z"/></svg>
+					{/if}
+				</button>
+
+				<!-- Skip forward 30s -->
+				<button
+					type="button"
+					onclick={() => { audioStore.seekRequest = Math.min(audioStore.duration || 0, audioStore.currentTime + 30); }}
+					class="w-8 h-8 flex items-center justify-center rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors flex-shrink-0"
+					title="+30s"
+				>
+					<svg class="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M18 13c0 3.31-2.69 6-6 6s-6-2.69-6-6 2.69-6 6-6v4l5-5-5-5v4c-4.42 0-8 3.58-8 8s3.58 8 8 8 8-3.58 8-8h-2z"/>
+					</svg>
+				</button>
+
+				<!-- Time -->
+				<span class="flex-1 text-[11px] text-center tabular-nums text-(--color-muted)">
+					{formatTime(audioStore.currentTime)}
+					<span class="opacity-50">/</span>
+					{formatDuration(audioStore.duration)}
+				</span>
+
+				<!-- Speed -->
+				<span class="text-[11px] font-medium tabular-nums text-(--color-muted) flex-shrink-0">
+					{audioStore.speed}×
+				</span>
+			</div>
+		</div>
+	</div>
+{/if}

ui/src/lib/components/ListeningMode.svelte

@@ -26,6 +26,65 @@
 	let samplePlayingVoice = $state<string | null>(null);
 	let sampleAudio: HTMLAudioElement | null = null;
 
+	// ── Pull-down-to-dismiss gesture ─────────────────────────────────────────
+	let dragY = $state(0);
+	let isDragging = $state(false);
+	let dragStartY = 0;
+	let dragStartTime = 0;
+	let overlayEl = $state<HTMLDivElement | null>(null);
+
+	// Register ontouchmove with passive:false so e.preventDefault() works.
+	// Svelte 5 does not support the |nonpassive modifier, so we use $effect.
+	$effect(() => {
+		if (!overlayEl) return;
+		overlayEl.addEventListener('touchmove', onTouchMove, { passive: false });
+		return () => overlayEl!.removeEventListener('touchmove', onTouchMove);
+	});
+
+	function onTouchStart(e: TouchEvent) {
+		// Don't hijack touches that start inside a scrollable element
+		const target = e.target as Element;
+		if (target.closest('.overflow-y-auto')) return;
+		// Don't activate if a modal is open (they handle their own scroll)
+		if (showVoiceModal || showChapterModal) return;
+
+		isDragging = true;
+		dragStartY = e.touches[0].clientY;
+		dragStartTime = Date.now();
+		dragY = 0;
+	}
+
+	function onTouchMove(e: TouchEvent) {
+		if (!isDragging) return;
+		const delta = e.touches[0].clientY - dragStartY;
+		// Only track downward movement
+		if (delta > 0) {
+			dragY = delta;
+			// Prevent page scroll while dragging the overlay down
+			e.preventDefault();
+		} else {
+			dragY = 0;
+		}
+	}
+
+	function onTouchEnd() {
+		if (!isDragging) return;
+		isDragging = false;
+
+		const elapsed = Date.now() - dragStartTime;
+		const velocity = dragY / Math.max(elapsed, 1); // px/ms
+
+		// Dismiss if dragged far enough (>130px) or flicked fast enough (>0.4px/ms)
+		if (dragY > 130 || velocity > 0.4) {
+			// Animate out: snap to bottom then close
+			dragY = window.innerHeight;
+			setTimeout(onclose, 220);
+		} else {
+			// Spring back to 0
+			dragY = 0;
+		}
+	}
+
 	// ── Voice search filtering ────────────────────────────────────────────────
 	const voiceSearchLower = $derived(voiceSearch.toLowerCase());
 	const filteredKokoro = $derived(kokoroVoices.filter((v) => voiceLabel(v).toLowerCase().includes(voiceSearchLower)));
@@ -188,31 +247,53 @@
 <!-- Full-screen listening mode overlay -->
 <!-- svelte-ignore a11y_no_static_element_interactions -->
 <div
+	bind:this={overlayEl}
 	class="fixed inset-0 z-60 flex flex-col overflow-hidden"
-	style="background: var(--color-surface);"
+	style="
+		background: var(--color-surface);
+		transform: translateY({dragY}px);
+		opacity: {Math.max(0, 1 - dragY / 500)};
+		transition: {isDragging ? 'none' : 'transform 0.32s cubic-bezier(0.32,0.72,0,1), opacity 0.32s ease'};
+		will-change: transform;
+		touch-action: pan-x;
+		pointer-events: auto;
+	"
+	ontouchstart={onTouchStart}
+	ontouchend={onTouchEnd}
 >
-	<!-- Blurred cover background -->
-	{#if audioStore.cover}
-		<div
-			class="absolute inset-0 bg-cover bg-center opacity-10 blur-2xl scale-110"
-			style="background-image: url('{audioStore.cover}');"
-			aria-hidden="true"
-		></div>
-	{/if}
 
-	<!-- Header bar -->
-	<div class="relative flex items-center justify-between px-4 py-3 shrink-0">
+	<!-- ── Blurred background (full-screen atmospheric layer) ───────────── -->
+	{#if audioStore.cover}
+		<img
+			src={audioStore.cover}
+			alt=""
+			aria-hidden="true"
+			class="absolute inset-0 w-full h-full object-cover pointer-events-none select-none"
+			style="filter: blur(40px) brightness(0.25) saturate(1.4); transform: scale(1.15); z-index: 0;"
+		/>
+	{:else}
+		<div class="absolute inset-0 pointer-events-none" style="background: var(--color-surface-2); z-index: 0;"></div>
+	{/if}
+	<!-- Subtle vignette overlay for depth -->
+	<div
+		class="absolute inset-0 pointer-events-none"
+		style="background: radial-gradient(ellipse at center, transparent 40%, rgba(0,0,0,0.55) 100%); z-index: 1;"
+		aria-hidden="true"
+	></div>
+
+	<!-- ── Header bar ─────────────────────────────────────────────────────── -->
+	<div class="relative flex items-center justify-between px-4 pt-3 pb-2 shrink-0" style="z-index: 2;">
 		<button
 			type="button"
 			onclick={onclose}
-			class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+			class="p-2 rounded-full text-(--color-text)/70 hover:text-(--color-text) hover:bg-white/10 transition-colors"
 			aria-label="Close listening mode"
 		>
 			<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
 				<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
 			</svg>
 		</button>
-		<span class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider">Now Playing</span>
+		<span class="text-xs font-semibold text-(--color-text)/60 uppercase tracking-wider">Now Playing</span>
 		<div class="flex items-center gap-2">
 			<!-- Chapters button -->
 			{#if audioStore.chapters.length > 0}
@@ -222,8 +303,8 @@
 					class={cn(
 						'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-medium border transition-colors',
 						showChapterModal
-							? 'border-(--color-brand) bg-(--color-brand)/10 text-(--color-brand)'
-							: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+							? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+							: 'border-white/20 bg-black/25 text-(--color-text)/70 hover:text-(--color-text) backdrop-blur-sm'
 					)}
 					aria-label="Browse chapters"
 				>
@@ -240,8 +321,8 @@
 				class={cn(
 					'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-medium border transition-colors',
 					showVoiceModal
-						? 'border-(--color-brand) bg-(--color-brand)/10 text-(--color-brand)'
-						: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+						? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+						: 'border-white/20 bg-black/25 text-(--color-text)/70 hover:text-(--color-text) backdrop-blur-sm'
 				)}
 			>
 				<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -252,15 +333,51 @@
 		</div>
 	</div>
 
+	<!-- ── Portrait cover card + track info ───────────────────────────────── -->
+	<div class="relative flex flex-col items-center gap-4 px-8 pt-2 pb-4 shrink-0" style="z-index: 2;">
+		<!-- Cover card -->
+		<div
+			class="rounded-2xl overflow-hidden shadow-2xl"
+			style="height: 38svh; min-height: 180px; max-height: 320px; aspect-ratio: 2/3;"
+		>
+			{#if audioStore.cover}
+				<img
+					src={audioStore.cover}
+					alt=""
+					class="w-full h-full object-cover"
+				/>
+			{:else}
+				<div class="w-full h-full bg-(--color-surface-2) flex items-center justify-center">
+					<svg class="w-16 h-16 text-(--color-muted)/30" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M18 2H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm-2 14H8v-2h8v2zm0-4H8v-2h8v2zm0-4H8V6h8v2z"/>
+					</svg>
+				</div>
+			{/if}
+		</div>
+
+		<!-- Track info -->
+		<div class="text-center w-full">
+			{#if audioStore.chapter > 0}
+				<p class="text-[10px] font-bold uppercase tracking-widest text-(--color-brand) mb-0.5">
+					Chapter {audioStore.chapter}
+				</p>
+			{/if}
+			<p class="text-lg font-bold text-(--color-text) leading-snug line-clamp-2">
+				{audioStore.chapterTitle || (audioStore.chapter > 0 ? `Chapter ${audioStore.chapter}` : '')}
+			</p>
+			<p class="text-sm text-(--color-text)/50 mt-0.5 truncate">{audioStore.bookTitle}</p>
+		</div>
+	</div>
+
 	<!-- Voice modal (full-screen overlay) -->
 	{#if showVoiceModal && voices.length > 0}
 		<!-- svelte-ignore a11y_no_static_element_interactions -->
 		<div
-			class="absolute inset-0 z-70 flex flex-col"
+			class="fixed inset-0 z-[80] flex flex-col"
 			style="background: var(--color-surface);"
 		>
 			<!-- Modal header -->
-			<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0">
+			<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0" style="padding-top: max(0.75rem, env(safe-area-inset-top));">
 				<button
 					type="button"
 					onclick={() => { stopSample(); showVoiceModal = false; voiceSearch = ''; }}
@@ -273,7 +390,6 @@
 				</button>
 				<span class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider flex-1">Select Voice</span>
 			</div>
-
 			<!-- Search input -->
 			<div class="px-4 py-3 shrink-0 border-b border-(--color-border)">
 				<div class="relative">
@@ -288,9 +404,8 @@
 					/>
 				</div>
 			</div>
-
 			<!-- Voice list -->
-			<div class="flex-1 overflow-y-auto">
+			<div class="flex-1 overflow-y-auto overscroll-contain" style="padding-bottom: env(safe-area-inset-bottom);">
 				{#each ([['Kokoro', filteredKokoro], ['Pocket TTS', filteredPocket], ['CF AI', filteredCfai]] as [string, Voice[]][]) as [label, group]}
 					{#if group.length > 0}
 						<p class="text-[10px] font-semibold text-(--color-muted) uppercase tracking-wider px-4 py-2 sticky top-0 bg-(--color-surface) border-b border-(--color-border)/50">{label}</p>
@@ -298,45 +413,24 @@
 							<div
 								class={cn(
 									'flex items-center gap-3 px-4 py-3 border-b border-(--color-border)/40 transition-colors',
-									audioStore.voice === v.id
-										? 'bg-(--color-brand)/8'
-										: 'hover:bg-(--color-surface-2)'
+									audioStore.voice === v.id ? 'bg-(--color-brand)/8' : 'hover:bg-(--color-surface-2)'
 								)}
 							>
-								<!-- Select voice -->
-								<button
-									type="button"
-									onclick={() => selectVoice(v.id)}
-									class="flex-1 flex items-center gap-3 text-left"
-								>
-									<!-- Selected indicator -->
+								<button type="button" onclick={() => selectVoice(v.id)} class="flex-1 flex items-center gap-3 text-left">
 									<span class={cn(
 										'w-4 h-4 shrink-0 rounded-full border-2 flex items-center justify-center transition-colors',
-										audioStore.voice === v.id
-											? 'border-(--color-brand) bg-(--color-brand)'
-											: 'border-(--color-border)'
+										audioStore.voice === v.id ? 'border-(--color-brand) bg-(--color-brand)' : 'border-(--color-border)'
 									)}>
 										{#if audioStore.voice === v.id}
-											<svg class="w-2 h-2 text-(--color-surface)" fill="currentColor" viewBox="0 0 24 24">
-												<path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/>
-											</svg>
+											<svg class="w-2 h-2 text-(--color-surface)" fill="currentColor" viewBox="0 0 24 24"><path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/></svg>
 										{/if}
 									</span>
-									<span class={cn(
-										'text-sm',
-										audioStore.voice === v.id ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)'
-									)}>{voiceLabel(v)}</span>
+									<span class={cn('text-sm', audioStore.voice === v.id ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)')}>{voiceLabel(v)}</span>
 								</button>
-								<!-- Sample play button -->
 								<button
 									type="button"
 									onclick={() => playSample(v.id)}
-									class={cn(
-										'shrink-0 p-2 rounded-full transition-colors',
-										samplePlayingVoice === v.id
-											? 'text-(--color-brand) bg-(--color-brand)/10'
-											: 'text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2)'
-									)}
+									class={cn('shrink-0 p-2 rounded-full transition-colors', samplePlayingVoice === v.id ? 'text-(--color-brand) bg-(--color-brand)/10' : 'text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2)')}
 									title={samplePlayingVoice === v.id ? 'Stop sample' : 'Play sample'}
 									aria-label={samplePlayingVoice === v.id ? 'Stop sample' : 'Play sample'}
 								>
@@ -361,11 +455,10 @@
 	{#if showChapterModal && audioStore.chapters.length > 0}
 		<!-- svelte-ignore a11y_no_static_element_interactions -->
 		<div
-			class="absolute inset-0 z-70 flex flex-col"
+			class="fixed inset-0 z-[80] flex flex-col"
 			style="background: var(--color-surface);"
 		>
-			<!-- Modal header -->
-			<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0">
+			<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0" style="padding-top: max(0.75rem, env(safe-area-inset-top));">
 				<button
 					type="button"
 					onclick={() => { showChapterModal = false; }}
@@ -378,7 +471,6 @@
 				</button>
 				<span class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider flex-1">Chapters</span>
 			</div>
-			<!-- Search input -->
 			<div class="px-4 py-3 shrink-0 border-b border-(--color-border)">
 				<div class="relative">
 					<svg class="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-(--color-muted)" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -392,35 +484,24 @@
 					/>
 				</div>
 			</div>
-			<!-- Chapter list -->
-			<div class="flex-1 overflow-y-auto">
-			{#each filteredChapters as ch (ch.number)}
-				<button
-					type="button"
-					onclick={() => playChapter(ch.number)}
-					use:scrollIfActive={ch.number === audioStore.chapter}
-					class={cn(
+			<div class="flex-1 overflow-y-auto overscroll-contain" style="padding-bottom: env(safe-area-inset-bottom);">
+				{#each filteredChapters as ch (ch.number)}
+					<button
+						type="button"
+						onclick={() => playChapter(ch.number)}
+						use:scrollIfActive={ch.number === audioStore.chapter}
+						class={cn(
 							'w-full flex items-center gap-3 px-4 py-3 border-b border-(--color-border)/40 transition-colors text-left',
 							ch.number === audioStore.chapter ? 'bg-(--color-brand)/8' : 'hover:bg-(--color-surface-2)'
 						)}
 					>
-						<!-- Chapter number badge (mirrors voice radio indicator) -->
 						<span class={cn(
 							'w-8 h-8 shrink-0 rounded-full border-2 flex items-center justify-center tabular-nums text-xs font-semibold transition-colors',
-							ch.number === audioStore.chapter
-								? 'border-(--color-brand) bg-(--color-brand) text-(--color-surface)'
-								: 'border-(--color-border) text-(--color-muted)'
+							ch.number === audioStore.chapter ? 'border-(--color-brand) bg-(--color-brand) text-(--color-surface)' : 'border-(--color-border) text-(--color-muted)'
 						)}>{ch.number}</span>
-						<!-- Title -->
-						<span class={cn(
-							'flex-1 text-sm truncate',
-							ch.number === audioStore.chapter ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)'
-						)}>{ch.title || `Chapter ${ch.number}`}</span>
-						<!-- Now-playing indicator -->
+						<span class={cn('flex-1 text-sm truncate', ch.number === audioStore.chapter ? 'font-semibold text-(--color-brand)' : 'text-(--color-text)')}>{ch.title || `Chapter ${ch.number}`}</span>
 						{#if ch.number === audioStore.chapter}
-							<svg class="w-4 h-4 shrink-0 text-(--color-brand)" fill="currentColor" viewBox="0 0 24 24">
-								<path d="M8 5v14l11-7z"/>
-							</svg>
+							<svg class="w-4 h-4 shrink-0 text-(--color-brand)" fill="currentColor" viewBox="0 0 24 24"><path d="M8 5v14l11-7z"/></svg>
 						{/if}
 					</button>
 				{/each}
@@ -431,195 +512,227 @@
 		</div>
 	{/if}
 
-	<!-- Scrollable body — fills remaining height, content spread vertically -->
-	<div class="relative flex-1 overflow-y-auto flex flex-col justify-between py-4">
+	<!-- ── Controls area (bottom half) ───────────────────────────────────── -->
+	<div class="flex-1 flex flex-col justify-end px-6 pb-6 gap-0 shrink-0 overflow-hidden" style="z-index: 2; position: relative;">
 
-		<!-- Cover art + track info -->
-		<div class="flex flex-col items-center px-8 shrink-0">
-			{#if audioStore.cover}
-				<img
-					src={audioStore.cover}
-					alt=""
-					class="w-44 h-64 object-cover rounded-xl shadow-2xl mb-5"
-				/>
-			{:else}
-				<div class="w-44 h-64 flex items-center justify-center bg-(--color-surface-2) rounded-xl shadow-2xl mb-5 border border-(--color-border)">
-					<svg class="w-16 h-16 text-(--color-muted)/40" fill="currentColor" viewBox="0 0 24 24">
-						<path d="M18 2H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm-2 14H8v-2h8v2zm0-4H8v-2h8v2zm0-4H8V6h8v2z"/>
-					</svg>
-				</div>
-			{/if}
-
-			<p class="text-base font-bold text-(--color-text) text-center leading-snug">
-				{audioStore.chapterTitle || (audioStore.chapter > 0 ? `Chapter ${audioStore.chapter}` : '')}
-			</p>
-			<p class="text-sm text-(--color-muted) text-center mt-0.5 truncate max-w-full">{audioStore.bookTitle}</p>
+		<!-- Seek bar -->
+		<div class="shrink-0 mb-1">
+			<input
+				type="range"
+				aria-label="Seek"
+				min="0"
+				max={audioStore.duration || 0}
+				value={audioStore.currentTime}
+				oninput={seek}
+				class="w-full h-1.5 cursor-pointer block"
+				style="accent-color: var(--color-brand);"
+			/>
+			<div class="flex justify-between text-xs text-(--color-muted) tabular-nums mt-1">
+				<span>{formatTime(audioStore.currentTime)}</span>
+				<!-- Remaining time in centre -->
+				{#if audioStore.duration > 0}
+					<span class="text-(--color-muted)/60">−{formatTime(Math.max(0, audioStore.duration - audioStore.currentTime))}</span>
+				{/if}
+				<span>{formatTime(audioStore.duration)}</span>
+			</div>
 		</div>
 
-		<!-- Bottom controls cluster: seek + transport + secondary -->
-		<div class="flex flex-col gap-0 px-6 shrink-0">
+		<!-- Transport controls -->
+		<div class="flex items-center justify-between pt-3 pb-4 shrink-0">
+			<!-- Prev chapter — smaller, clearly secondary -->
+			{#if audioStore.chapter > 1 && audioStore.slug}
+				<button
+					type="button"
+					onclick={() => playChapter(audioStore.chapter - 1)}
+					class="p-2 rounded-full text-(--color-muted)/60 hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+					title="Previous chapter"
+					aria-label="Previous chapter"
+				>
+					<svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M6 6h2v12H6zm2 6 8.5 6V6z"/>
+					</svg>
+				</button>
+			{:else}
+				<div class="w-9 h-9"></div>
+			{/if}
 
-			<!-- Seek bar -->
-			<div class="shrink-0">
-				<input
-					type="range"
-					aria-label="Seek"
-					min="0"
-					max={audioStore.duration || 0}
-					value={audioStore.currentTime}
-					oninput={seek}
-					class="w-full h-1.5 accent-[--color-brand] cursor-pointer block"
-					style="accent-color: var(--color-brand);"
-				/>
-				<div class="flex justify-between text-xs text-(--color-muted) tabular-nums mt-1">
-					<span>{formatTime(audioStore.currentTime)}</span>
-					<span>{formatTime(audioStore.duration)}</span>
-				</div>
-			</div>
+			<!-- Skip back 15s — medium -->
+			<button
+				type="button"
+				onclick={skipBack}
+				class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+				aria-label="Skip back 15 seconds"
+				title="Back 15s"
+			>
+				<svg class="w-7 h-7" fill="currentColor" viewBox="0 0 24 24">
+					<path d="M11.99 5V1l-5 5 5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6h-2c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z"/>
+					<text x="8.5" y="14.5" font-size="5" font-family="sans-serif" font-weight="bold" fill="currentColor">15</text>
+				</svg>
+			</button>
 
-			<!-- Transport controls -->
-			<div class="flex items-center justify-center gap-4 pt-5 pb-3 shrink-0">
-				<!-- Prev chapter -->
-				{#if audioStore.chapter > 1 && audioStore.slug}
-					<a
-						href="/books/{audioStore.slug}/chapters/{audioStore.chapter - 1}"
-						class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-						title="Previous chapter"
-						aria-label="Previous chapter"
-					>
-						<svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M6 6h2v12H6zm3.5 6l8.5 6V6z"/>
-						</svg>
-					</a>
+			<!-- Play / Pause — largest, centred -->
+			<button
+				type="button"
+				onclick={togglePlay}
+				class="w-18 h-18 rounded-full bg-(--color-brand) text-(--color-surface) flex items-center justify-center hover:bg-(--color-brand-dim) transition-colors shadow-xl"
+				style="width: 4.5rem; height: 4.5rem;"
+				aria-label={audioStore.isPlaying ? 'Pause' : 'Play'}
+			>
+				{#if audioStore.isPlaying}
+					<svg class="w-8 h-8" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M6 4h4v16H6V4zm8 0h4v16h-4V4z"/>
+					</svg>
 				{:else}
-					<div class="w-9 h-9"></div>
+					<svg class="w-8 h-8 ml-1" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M8 5v14l11-7z"/>
+					</svg>
 				{/if}
+			</button>
 
-				<!-- Skip back 15s -->
+			<!-- Skip forward 30s — medium -->
+			<button
+				type="button"
+				onclick={skipForward}
+				class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+				aria-label="Skip forward 30 seconds"
+				title="Forward 30s"
+			>
+				<svg class="w-7 h-7" fill="currentColor" viewBox="0 0 24 24">
+					<path d="M12 5V1l5 5-5 5V7c-3.31 0-6 2.69-6 6s2.69 6 6 6 6-2.69 6-6h2c0 4.42-3.58 8-8 8s-8-3.58-8-8 3.58-8 8-8z"/>
+					<text x="8.5" y="14.5" font-size="5" font-family="sans-serif" font-weight="bold" fill="currentColor">30</text>
+				</svg>
+			</button>
+
+			<!-- Next chapter — smaller, clearly secondary -->
+			{#if audioStore.nextChapter !== null && audioStore.slug}
 				<button
 					type="button"
-					onclick={skipBack}
-					class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-					aria-label="Skip back 15 seconds"
-					title="Back 15s"
+					onclick={() => playChapter(audioStore.nextChapter!)}
+					class="p-2 rounded-full text-(--color-muted)/60 hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+					title="Next chapter"
+					aria-label="Next chapter"
 				>
-					<svg class="w-6 h-6" fill="currentColor" viewBox="0 0 24 24">
-						<path d="M11.99 5V1l-5 5 5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6h-2c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z"/>
-						<text x="8.5" y="14.5" font-size="5" font-family="sans-serif" font-weight="bold" fill="currentColor">15</text>
+					<svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
+						<path d="M6 18l8.5-6L6 6v12zM16 6v12h2V6h-2z"/>
 					</svg>
 				</button>
+			{:else}
+				<div class="w-9 h-9"></div>
+			{/if}
+		</div>
 
-				<!-- Play / Pause -->
-				<button
-					type="button"
-					onclick={togglePlay}
-					class="w-16 h-16 rounded-full bg-(--color-brand) text-(--color-surface) flex items-center justify-center hover:bg-(--color-brand-dim) transition-colors shadow-lg"
-					aria-label={audioStore.isPlaying ? 'Pause' : 'Play'}
-				>
-					{#if audioStore.isPlaying}
-						<svg class="w-7 h-7" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M6 4h4v16H6V4zm8 0h4v16h-4V4z"/>
-						</svg>
-					{:else}
-						<svg class="w-7 h-7 ml-1" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M8 5v14l11-7z"/>
-						</svg>
-					{/if}
-				</button>
-
-				<!-- Skip forward 30s -->
-				<button
-					type="button"
-					onclick={skipForward}
-					class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-					aria-label="Skip forward 30 seconds"
-					title="Forward 30s"
-				>
-					<svg class="w-6 h-6" fill="currentColor" viewBox="0 0 24 24">
-						<path d="M12 5V1l5 5-5 5V7c-3.31 0-6 2.69-6 6s2.69 6 6 6 6-2.69 6-6h2c0 4.42-3.58 8-8 8s-8-3.58-8-8 3.58-8 8-8z"/>
-						<text x="8.5" y="14.5" font-size="5" font-family="sans-serif" font-weight="bold" fill="currentColor">30</text>
-					</svg>
-				</button>
-
-				<!-- Next chapter -->
-				{#if audioStore.nextChapter !== null && audioStore.slug}
-					<a
-						href="/books/{audioStore.slug}/chapters/{audioStore.nextChapter}"
-						class="p-2 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-						title="Next chapter"
-						aria-label="Next chapter"
-					>
-						<svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
-							<path d="M6 18l8.5-6L6 6v12zm8.5-6L23 6v12l-8.5-6z"/>
-						</svg>
-					</a>
-				{:else}
-					<div class="w-9 h-9"></div>
-				{/if}
+		<!-- Secondary controls: unified single row — Speed · Auto · Announce · Sleep -->
+		<div class="flex items-center justify-center gap-2 shrink-0 flex-wrap">
+			<!-- Speed — segmented pill -->
+			<div class="flex items-center gap-0.5 bg-(--color-surface-2) rounded-full px-1.5 py-1 border border-(--color-border)">
+				{#each SPEED_OPTIONS as s}
+					<button
+						type="button"
+						onclick={() => (audioStore.speed = s)}
+						class={cn(
+							'px-2 py-0.5 rounded-full text-xs font-semibold transition-colors',
+							audioStore.speed === s
+								? 'bg-(--color-brand) text-(--color-surface)'
+								: 'text-(--color-muted) hover:text-(--color-text)'
+						)}
+						aria-pressed={audioStore.speed === s}
+					>{s}×</button>
+				{/each}
 			</div>
 
-			<!-- Secondary controls: Speed · Auto-next · Sleep -->
-			<div class="flex items-center justify-center gap-3 pb-3 shrink-0 flex-wrap">
-				<!-- Speed -->
-				<div class="flex items-center gap-1 bg-(--color-surface-2) rounded-full px-2 py-1 border border-(--color-border)">
-					{#each SPEED_OPTIONS as s}
-						<button
-							type="button"
-							onclick={() => (audioStore.speed = s)}
-							class={cn(
-								'px-2 py-0.5 rounded-full text-xs font-semibold transition-colors',
-								audioStore.speed === s
-									? 'bg-(--color-brand) text-(--color-surface)'
-									: 'text-(--color-muted) hover:text-(--color-text)'
-							)}
-							aria-pressed={audioStore.speed === s}
-						>{s}×</button>
-					{/each}
-				</div>
+			<!-- Auto-next pill -->
+			<button
+				type="button"
+				onclick={() => (audioStore.autoNext = !audioStore.autoNext)}
+				class={cn(
+					'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
+					audioStore.autoNext
+						? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+						: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+				)}
+				aria-pressed={audioStore.autoNext}
+				title={audioStore.autoNext ? 'Auto-next on' : 'Auto-next off'}
+			>
+				<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+					<path d="M6 18l8.5-6L6 6v12zm8.5-6L23 6v12l-8.5-6z"/>
+				</svg>
+				Auto
+				{#if audioStore.autoNext && audioStore.nextStatus === 'prefetching'}
+					<span class="w-1.5 h-1.5 rounded-full bg-(--color-brand) animate-pulse"></span>
+				{:else if audioStore.autoNext && audioStore.nextStatus === 'prefetched'}
+					<span class="w-1.5 h-1.5 rounded-full bg-green-400"></span>
+				{/if}
+			</button>
 
-				<!-- Auto-next -->
-				<button
-					type="button"
-					onclick={() => (audioStore.autoNext = !audioStore.autoNext)}
-					class={cn(
-						'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
-						audioStore.autoNext
-							? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
-							: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
-					)}
-					aria-pressed={audioStore.autoNext}
-					title={audioStore.autoNext ? 'Auto-next on' : 'Auto-next off'}
-				>
-					<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
-						<path d="M6 18l8.5-6L6 6v12zm8.5-6L23 6v12l-8.5-6z"/>
-					</svg>
-					Auto
-					{#if audioStore.autoNext && audioStore.nextStatus === 'prefetching'}
-						<span class="w-1.5 h-1.5 rounded-full bg-(--color-brand) animate-pulse"></span>
-					{:else if audioStore.autoNext && audioStore.nextStatus === 'prefetched'}
-						<span class="w-1.5 h-1.5 rounded-full bg-green-400"></span>
-					{/if}
-				</button>
+		<!-- Announce chapter pill (only meaningful when auto-next is on) -->
+		<button
+			type="button"
+			onclick={() => (audioStore.announceChapter = !audioStore.announceChapter)}
+			class={cn(
+				'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
+				audioStore.announceChapter
+					? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+					: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+			)}
+			aria-pressed={audioStore.announceChapter}
+			title={audioStore.announceChapter ? 'Chapter announcing on' : 'Chapter announcing off'}
+		>
+			<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+				<path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02z"/>
+			</svg>
+			Announce
+		</button>
 
-				<!-- Sleep timer -->
-				<button
-					type="button"
-					onclick={cycleSleepTimer}
-					class={cn(
-						'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
-						audioStore.sleepUntil || audioStore.sleepAfterChapter
-							? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
-							: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
-					)}
-					title="Sleep timer"
-				>
-					<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
-					</svg>
-					{sleepLabel}
-				</button>
-			</div>
+		<!-- Stream / Generate mode toggle -->
+		<!-- CF AI voices are batch-only and always use generate mode regardless of this setting -->
+		<button
+			type="button"
+			onclick={() => {
+				if (!audioStore.voice.startsWith('cfai:')) {
+					audioStore.audioMode = audioStore.audioMode === 'stream' ? 'generate' : 'stream';
+				}
+			}}
+			disabled={audioStore.voice.startsWith('cfai:')}
+			class={cn(
+				'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
+				audioStore.voice.startsWith('cfai:')
+					? 'border-(--color-border) bg-(--color-surface-2) text-(--color-border) cursor-not-allowed opacity-50'
+					: audioStore.audioMode === 'stream'
+						? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+						: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+			)}
+			aria-pressed={audioStore.audioMode === 'stream'}
+			title={audioStore.voice.startsWith('cfai:') ? 'CF AI voices always use generate mode' : audioStore.audioMode === 'stream' ? 'Stream mode — audio starts instantly' : 'Generate mode — wait for full audio before playing'}
+		>
+			{#if audioStore.audioMode === 'stream' && !audioStore.voice.startsWith('cfai:')}
+				<svg class="w-3.5 h-3.5" fill="currentColor" viewBox="0 0 24 24">
+					<path d="M8 5v14l11-7z"/>
+				</svg>
+			{:else}
+				<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+				</svg>
+			{/if}
+			{audioStore.audioMode === 'stream' && !audioStore.voice.startsWith('cfai:') ? 'Stream' : 'Generate'}
+		</button>
 
+			<!-- Sleep timer pill -->
+			<button
+				type="button"
+				onclick={cycleSleepTimer}
+				class={cn(
+					'flex items-center gap-1.5 px-3 py-1.5 rounded-full text-xs font-semibold border transition-colors',
+					audioStore.sleepUntil || audioStore.sleepAfterChapter
+						? 'border-(--color-brand) bg-(--color-brand)/15 text-(--color-brand)'
+						: 'border-(--color-border) bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'
+				)}
+				title="Sleep timer"
+			>
+				<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+				</svg>
+				{sleepLabel}
+			</button>
 		</div>
 
 	</div>

ui/src/lib/components/SearchModal.svelte

@@ -0,0 +1,437 @@
+<script lang="ts">
+	import { browser } from '$app/environment';
+	import { goto } from '$app/navigation';
+	import { cn } from '$lib/utils';
+
+	interface Props {
+		onclose: () => void;
+	}
+	let { onclose }: Props = $props();
+
+	// ── Types ─────────────────────────────────────────────────────────────────
+	interface SearchResult {
+		slug: string;
+		title: string;
+		cover?: string;
+		author?: string;
+		genres?: string[];
+		status?: string;
+		chapters?: string;  // e.g. "42 chapters"
+		url?: string;       // novelfire source url — present for remote results
+	}
+
+	interface SearchResponse {
+		results: SearchResult[];
+		local_count: number;
+		remote_count: number;
+	}
+
+	// ── State ─────────────────────────────────────────────────────────────────
+	const RECENTS_KEY = 'search_recents_v1';
+	const MAX_RECENTS = 8;
+
+	function loadRecents(): string[] {
+		if (!browser) return [];
+		try {
+			const raw = localStorage.getItem(RECENTS_KEY);
+			if (raw) return JSON.parse(raw) as string[];
+		} catch { /* ignore */ }
+		return [];
+	}
+
+	function saveRecents(list: string[]) {
+		if (!browser) return;
+		try { localStorage.setItem(RECENTS_KEY, JSON.stringify(list)); } catch { /* ignore */ }
+	}
+
+	let recents = $state<string[]>(loadRecents());
+	let query   = $state('');
+	let results = $state<SearchResult[]>([]);
+	let localCount  = $state(0);
+	let remoteCount = $state(0);
+	let loading = $state(false);
+	let error   = $state('');
+
+	// For keyboard navigation through results
+	let selectedIdx = $state(-1);
+
+	// Input element ref for autofocus
+	let inputEl = $state<HTMLInputElement | null>(null);
+
+	// ── Autofocus + body scroll lock ──────────────────────────────────────────
+	$effect(() => {
+		if (inputEl) inputEl.focus();
+		if (browser) {
+			const prev = document.body.style.overflow;
+			document.body.style.overflow = 'hidden';
+			return () => { document.body.style.overflow = prev; };
+		}
+	});
+
+	// ── Keyboard shortcuts (global): Escape closes ────────────────────────────
+	function onKeydown(e: KeyboardEvent) {
+		if (e.key === 'Escape') { onclose(); return; }
+
+		const total = visibleResults.length;
+		if (total === 0) return;
+
+		if (e.key === 'ArrowDown') {
+			e.preventDefault();
+			selectedIdx = (selectedIdx + 1) % total;
+		} else if (e.key === 'ArrowUp') {
+			e.preventDefault();
+			selectedIdx = (selectedIdx - 1 + total) % total;
+		} else if (e.key === 'Enter' && selectedIdx >= 0) {
+			e.preventDefault();
+			navigateTo(visibleResults[selectedIdx]);
+		}
+	}
+
+	// ── Debounced search ──────────────────────────────────────────────────────
+	let debounceTimer = 0;
+
+	$effect(() => {
+		const q = query.trim();
+		selectedIdx = -1;
+
+		if (q.length < 2) {
+			results = [];
+			localCount = 0;
+			remoteCount = 0;
+			loading = false;
+			error = '';
+			clearTimeout(debounceTimer);
+			return;
+		}
+
+		loading = true;
+		error = '';
+		clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(async () => {
+			try {
+				const res = await fetch(`/api/search?q=${encodeURIComponent(q)}`);
+				if (!res.ok) throw new Error(`HTTP ${res.status}`);
+				const data: SearchResponse = await res.json();
+				results    = data.results ?? [];
+				localCount  = data.local_count ?? 0;
+				remoteCount = data.remote_count ?? 0;
+			} catch (e) {
+				error = 'Search failed. Please try again.';
+				results = [];
+			} finally {
+				loading = false;
+			}
+		}, 300) as unknown as number;
+	});
+
+	// Results visible in the list — same as results (no client-side filter needed)
+	const visibleResults = $derived(results);
+
+	// ── Genre suggestions shown when query is empty ───────────────────────────
+	const GENRE_SUGGESTIONS = [
+		'Fantasy', 'Action', 'Romance', 'Cultivation', 'System',
+		'Reincarnation', 'Sci-Fi', 'Horror', 'Slice of Life', 'Adventure',
+	];
+
+	// ── Navigation helpers ────────────────────────────────────────────────────
+	function navigateTo(r: SearchResult) {
+		pushRecent(query.trim());
+		goto(`/books/${r.slug}`);
+		onclose();
+	}
+
+	function searchGenre(genre: string) {
+		goto(`/catalogue?genre=${encodeURIComponent(genre)}`);
+		onclose();
+	}
+
+	function submitQuery() {
+		const q = query.trim();
+		if (!q) return;
+		pushRecent(q);
+		goto(`/catalogue?q=${encodeURIComponent(q)}`);
+		onclose();
+	}
+
+	// ── Recent searches ───────────────────────────────────────────────────────
+	function pushRecent(q: string) {
+		if (!q || q.length < 2) return;
+		const next = [q, ...recents.filter(r => r.toLowerCase() !== q.toLowerCase())].slice(0, MAX_RECENTS);
+		recents = next;
+		saveRecents(next);
+	}
+
+	function removeRecent(q: string) {
+		const next = recents.filter(r => r !== q);
+		recents = next;
+		saveRecents(next);
+	}
+
+	function clearAllRecents() {
+		recents = [];
+		saveRecents([]);
+	}
+
+	function applyRecent(q: string) {
+		query = q;
+		if (inputEl) inputEl.focus();
+	}
+
+	// ── Helpers ───────────────────────────────────────────────────────────────
+	function parseGenres(genres: string[] | string | undefined): string[] {
+		if (!genres) return [];
+		if (Array.isArray(genres)) return genres;
+		try { const p = JSON.parse(genres); return Array.isArray(p) ? p : []; } catch { return []; }
+	}
+
+	const isRemote = (r: SearchResult) => r.url != null && r.url.includes('novelfire');
+</script>
+
+<!-- svelte:window for global keyboard handling -->
+<svelte:window onkeydown={onKeydown} />
+
+<!-- Backdrop -->
+<!-- svelte-ignore a11y_no_static_element_interactions -->
+<div
+	class="fixed inset-0 z-[70] flex flex-col"
+	style="background: rgba(0,0,0,0.6); backdrop-filter: blur(4px);"
+	onpointerdown={(e) => { if (e.target === e.currentTarget) onclose(); }}
+>
+	<!-- Modal panel — slides down from top -->
+	<!-- svelte-ignore a11y_no_static_element_interactions -->
+	<div
+		class="w-full max-w-2xl mx-auto mt-0 sm:mt-16 flex flex-col bg-(--color-surface) sm:rounded-2xl border-b sm:border border-(--color-border) shadow-2xl overflow-hidden"
+		style="max-height: 100svh; sm:max-height: calc(100svh - 8rem);"
+		onpointerdown={(e) => e.stopPropagation()}
+	>
+		<!-- ── Search input row ──────────────────────────────────────────────── -->
+		<div class="flex items-center gap-3 px-4 py-3 border-b border-(--color-border) shrink-0">
+			<!-- Search icon -->
+			{#if loading}
+				<svg class="w-5 h-5 text-(--color-brand) animate-spin shrink-0" fill="none" viewBox="0 0 24 24">
+					<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"/>
+					<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"/>
+				</svg>
+			{:else}
+				<svg class="w-5 h-5 text-(--color-muted) shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+				</svg>
+			{/if}
+
+			<input
+				bind:this={inputEl}
+				bind:value={query}
+				type="search"
+				placeholder="Search books, authors, genres…"
+				class="flex-1 bg-transparent text-(--color-text) placeholder:text-(--color-muted) text-base focus:outline-none min-w-0"
+				onkeydown={(e) => { if (e.key === 'Enter') { e.preventDefault(); submitQuery(); } }}
+				autocomplete="off"
+				autocorrect="off"
+				spellcheck={false}
+			/>
+
+			{#if query}
+				<button
+					type="button"
+					onclick={() => { query = ''; inputEl?.focus(); }}
+					class="shrink-0 p-1 rounded-full text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+					aria-label="Clear search"
+				>
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+					</svg>
+				</button>
+			{/if}
+
+			<button
+				type="button"
+				onclick={onclose}
+				class="shrink-0 px-3 py-1 rounded-lg text-sm text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+				aria-label="Close search"
+			>
+				Cancel
+			</button>
+		</div>
+
+		<!-- ── Scrollable body ───────────────────────────────────────────────── -->
+		<div class="flex-1 overflow-y-auto overscroll-contain">
+
+			<!-- ── Error state ─────────────────────────────────────────────── -->
+			{#if error}
+				<p class="px-5 py-8 text-sm text-center text-(--color-danger)">{error}</p>
+
+			<!-- ── Results ─────────────────────────────────────────────────── -->
+			{:else if visibleResults.length > 0}
+				<!-- Result count + "see all" hint -->
+				<div class="flex items-center justify-between px-4 pt-3 pb-1.5">
+					<p class="text-xs text-(--color-muted)">
+						{#if localCount > 0 && remoteCount > 0}
+							<span class="text-(--color-text) font-medium">{localCount}</span> in library
+							· <span class="text-(--color-text) font-medium">{remoteCount}</span> from Novelfire
+						{:else if localCount > 0}
+							<span class="text-(--color-text) font-medium">{localCount}</span> in library
+						{:else}
+							<span class="text-(--color-text) font-medium">{remoteCount}</span> from Novelfire
+						{/if}
+					</p>
+					<!-- "All results in catalogue" shortcut -->
+					<button
+						type="button"
+						onclick={submitQuery}
+						class="text-xs text-(--color-brand) hover:text-(--color-brand-dim) transition-colors"
+					>
+						See all in catalogue →
+					</button>
+				</div>
+
+				{#each visibleResults as r, i}
+					{@const genres = parseGenres(r.genres)}
+					{@const remote = isRemote(r)}
+					<button
+						type="button"
+						onclick={() => navigateTo(r)}
+						class={cn(
+							'w-full flex items-center gap-3 px-4 py-3 text-left transition-colors border-b border-(--color-border)/40 last:border-0',
+							selectedIdx === i ? 'bg-(--color-surface-2)' : 'hover:bg-(--color-surface-2)'
+						)}
+					>
+						<!-- Cover thumbnail -->
+						<div class="shrink-0 w-10 h-14 rounded overflow-hidden bg-(--color-surface-2) border border-(--color-border)">
+							{#if r.cover}
+								<img src={r.cover} alt="" class="w-full h-full object-cover" loading="lazy" />
+							{:else}
+								<div class="w-full h-full flex items-center justify-center">
+									<svg class="w-5 h-5 text-(--color-muted)/40" fill="currentColor" viewBox="0 0 24 24">
+										<path d="M18 2H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2z"/>
+									</svg>
+								</div>
+							{/if}
+						</div>
+
+						<!-- Info -->
+						<div class="flex-1 min-w-0">
+							<div class="flex items-start gap-2">
+								<p class="text-sm font-semibold text-(--color-text) leading-snug line-clamp-1 flex-1">
+									{r.title}
+								</p>
+								{#if remote}
+									<span class="shrink-0 text-[10px] font-semibold px-1.5 py-0.5 rounded bg-(--color-surface-3) text-(--color-muted) border border-(--color-border) leading-none mt-0.5">
+										Novelfire
+									</span>
+								{/if}
+							</div>
+							{#if r.author}
+								<p class="text-xs text-(--color-muted) mt-0.5 truncate">{r.author}</p>
+							{/if}
+							<div class="flex items-center gap-1.5 mt-1 flex-wrap">
+								{#if r.chapters}
+									<span class="text-xs text-(--color-muted)/60">{r.chapters}</span>
+								{/if}
+								{#if r.status}
+									<span class="text-xs text-(--color-muted)/60 capitalize">{r.status}</span>
+								{/if}
+								{#each genres.slice(0, 2) as g}
+									<span class="text-[10px] px-1.5 py-0.5 rounded-full bg-(--color-surface-3) text-(--color-muted)">{g}</span>
+								{/each}
+							</div>
+						</div>
+
+						<!-- Chevron -->
+						<svg class="w-4 h-4 text-(--color-muted)/40 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+							<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"/>
+						</svg>
+					</button>
+				{/each}
+
+				<!-- "See all results" footer button -->
+				<button
+					type="button"
+					onclick={submitQuery}
+					class="w-full flex items-center justify-center gap-2 px-4 py-4 text-sm text-(--color-brand) hover:bg-(--color-surface-2) transition-colors"
+				>
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+					</svg>
+					See all results for "{query.trim()}"
+				</button>
+
+			<!-- ── No results ───────────────────────────────────────────────── -->
+			{:else if query.trim().length >= 2 && !loading}
+				<div class="px-5 py-10 text-center">
+					<p class="text-sm font-semibold text-(--color-text) mb-1">No results for "{query.trim()}"</p>
+					<p class="text-xs text-(--color-muted) mb-5">Try a different title, author, or browse by genre below.</p>
+					<div class="flex flex-wrap gap-2 justify-center">
+						{#each GENRE_SUGGESTIONS as genre}
+							<button
+								type="button"
+								onclick={() => searchGenre(genre)}
+								class="px-3 py-1.5 rounded-full border border-(--color-border) bg-(--color-surface-2) text-sm text-(--color-muted) hover:text-(--color-text) hover:border-(--color-brand)/50 transition-colors"
+							>
+								{genre}
+							</button>
+						{/each}
+					</div>
+				</div>
+
+			<!-- ── Empty state (query too short or empty) ───────────────────── -->
+			{:else if query.trim().length === 0}
+				<!-- Recent searches -->
+				{#if recents.length > 0}
+					<div class="px-4 pt-4 pb-2">
+						<div class="flex items-center justify-between mb-2">
+							<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider">Recent</p>
+							<button
+								type="button"
+								onclick={clearAllRecents}
+								class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors"
+							>
+								Clear all
+							</button>
+						</div>
+						{#each recents as r}
+							<div class="flex items-center gap-2 group">
+								<button
+									type="button"
+									onclick={() => applyRecent(r)}
+									class="flex-1 flex items-center gap-2.5 px-1 py-2 rounded-lg text-sm text-(--color-text) hover:bg-(--color-surface-2) transition-colors text-left"
+								>
+									<svg class="w-3.5 h-3.5 text-(--color-muted)/50 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+										<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
+									</svg>
+									{r}
+								</button>
+								<button
+									type="button"
+									onclick={() => removeRecent(r)}
+									class="shrink-0 p-1 rounded text-(--color-muted)/40 hover:text-(--color-muted) opacity-0 group-hover:opacity-100 transition-all"
+									aria-label="Remove"
+								>
+									<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+										<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+									</svg>
+								</button>
+							</div>
+						{/each}
+					</div>
+					<div class="mx-4 my-2 border-t border-(--color-border)/60"></div>
+				{/if}
+
+				<!-- Genre suggestions -->
+				<div class="px-4 pt-3 pb-5">
+					<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-wider mb-3">Browse by genre</p>
+					<div class="flex flex-wrap gap-2">
+						{#each GENRE_SUGGESTIONS as genre}
+							<button
+								type="button"
+								onclick={() => searchGenre(genre)}
+								class="px-3 py-1.5 rounded-full border border-(--color-border) bg-(--color-surface-2) text-sm text-(--color-muted) hover:text-(--color-text) hover:border-(--color-brand)/50 transition-colors"
+							>
+								{genre}
+							</button>
+						{/each}
+					</div>
+				</div>
+			{/if}
+		</div>
+	</div>
+</div>

ui/src/lib/paraglide/README.md

@@ -2,7 +2,7 @@
 
 > Auto-generated i18n message functions. Import `messages.js` to use translated strings.
 
-Compiled from: `/Users/kalekber/code/libnovel-v2/ui/project.inlang`
+Compiled from: `/opt/libnovel-v3/ui/project.inlang`
 
 
 ## What is this folder?

ui/src/lib/paraglide/messages/_index.js

@@ -150,6 +150,9 @@ export * from './profile_theme_label.js'
 export * from './profile_theme_amber.js'
 export * from './profile_theme_slate.js'
 export * from './profile_theme_rose.js'
+export * from './profile_theme_forest.js'
+export * from './profile_theme_mono.js'
+export * from './profile_theme_cyber.js'
 export * from './profile_theme_light.js'
 export * from './profile_theme_light_slate.js'
 export * from './profile_theme_light_rose.js'
@@ -370,11 +373,13 @@ export * from './admin_tools_label.js'
 export * from './admin_nav_scrape.js'
 export * from './admin_nav_audio.js'
 export * from './admin_nav_translation.js'
+export * from './admin_nav_import.js'
 export * from './admin_nav_changelog.js'
 export * from './admin_nav_image_gen.js'
 export * from './admin_nav_text_gen.js'
 export * from './admin_nav_catalogue_tools.js'
 export * from './admin_nav_ai_jobs.js'
+export * from './admin_nav_notifications.js'
 export * from './admin_nav_feedback.js'
 export * from './admin_nav_errors.js'
 export * from './admin_nav_analytics.js'
@@ -438,4 +443,16 @@ export * from './feed_not_logged_in.js'
 export * from './feed_reader_label.js'
 export * from './feed_chapters_label.js'
 export * from './feed_browse_cta.js'
-export * from './feed_find_users_cta.js'
+export * from './feed_find_users_cta.js'
+export * from './admin_translation_page_title.js'
+export * from './admin_translation_heading.js'
+export * from './admin_translation_tab_enqueue.js'
+export * from './admin_translation_tab_jobs.js'
+export * from './admin_translation_filter_placeholder.js'
+export * from './admin_translation_no_matching.js'
+export * from './admin_translation_no_jobs.js'
+export * from './admin_ai_jobs_page_title.js'
+export * from './admin_ai_jobs_heading.js'
+export * from './admin_ai_jobs_subheading.js'
+export * from './admin_text_gen_page_title.js'
+export * from './admin_text_gen_heading.js'

ui/src/lib/paraglide/messages/admin_ai_jobs_heading.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Ai_Jobs_HeadingInputs */
+
+const en_admin_ai_jobs_heading = /** @type {(inputs: Admin_Ai_Jobs_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs`)
+};
+
+const ru_admin_ai_jobs_heading = /** @type {(inputs: Admin_Ai_Jobs_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs`)
+};
+
+const id_admin_ai_jobs_heading = /** @type {(inputs: Admin_Ai_Jobs_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs`)
+};
+
+const pt_admin_ai_jobs_heading = /** @type {(inputs: Admin_Ai_Jobs_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs`)
+};
+
+const fr_admin_ai_jobs_heading = /** @type {(inputs: Admin_Ai_Jobs_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs`)
+};
+
+/**
+* | output |
+* | --- |
+* | "AI Jobs" |
+*
+* @param {Admin_Ai_Jobs_HeadingInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_ai_jobs_heading = /** @type {((inputs?: Admin_Ai_Jobs_HeadingInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Ai_Jobs_HeadingInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_ai_jobs_heading(inputs)
+	if (locale === "ru") return ru_admin_ai_jobs_heading(inputs)
+	if (locale === "id") return id_admin_ai_jobs_heading(inputs)
+	if (locale === "pt") return pt_admin_ai_jobs_heading(inputs)
+	return fr_admin_ai_jobs_heading(inputs)
+});

ui/src/lib/paraglide/messages/admin_ai_jobs_page_title.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Ai_Jobs_Page_TitleInputs */
+
+const en_admin_ai_jobs_page_title = /** @type {(inputs: Admin_Ai_Jobs_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs — Admin`)
+};
+
+const ru_admin_ai_jobs_page_title = /** @type {(inputs: Admin_Ai_Jobs_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs — Admin`)
+};
+
+const id_admin_ai_jobs_page_title = /** @type {(inputs: Admin_Ai_Jobs_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs — Admin`)
+};
+
+const pt_admin_ai_jobs_page_title = /** @type {(inputs: Admin_Ai_Jobs_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs — Admin`)
+};
+
+const fr_admin_ai_jobs_page_title = /** @type {(inputs: Admin_Ai_Jobs_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`AI Jobs — Admin`)
+};
+
+/**
+* | output |
+* | --- |
+* | "AI Jobs — Admin" |
+*
+* @param {Admin_Ai_Jobs_Page_TitleInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_ai_jobs_page_title = /** @type {((inputs?: Admin_Ai_Jobs_Page_TitleInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Ai_Jobs_Page_TitleInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_ai_jobs_page_title(inputs)
+	if (locale === "ru") return ru_admin_ai_jobs_page_title(inputs)
+	if (locale === "id") return id_admin_ai_jobs_page_title(inputs)
+	if (locale === "pt") return pt_admin_ai_jobs_page_title(inputs)
+	return fr_admin_ai_jobs_page_title(inputs)
+});

ui/src/lib/paraglide/messages/admin_ai_jobs_subheading.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Ai_Jobs_SubheadingInputs */
+
+const en_admin_ai_jobs_subheading = /** @type {(inputs: Admin_Ai_Jobs_SubheadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Background AI generation tasks`)
+};
+
+const ru_admin_ai_jobs_subheading = /** @type {(inputs: Admin_Ai_Jobs_SubheadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Background AI generation tasks`)
+};
+
+const id_admin_ai_jobs_subheading = /** @type {(inputs: Admin_Ai_Jobs_SubheadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Background AI generation tasks`)
+};
+
+const pt_admin_ai_jobs_subheading = /** @type {(inputs: Admin_Ai_Jobs_SubheadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Background AI generation tasks`)
+};
+
+const fr_admin_ai_jobs_subheading = /** @type {(inputs: Admin_Ai_Jobs_SubheadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Background AI generation tasks`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Background AI generation tasks" |
+*
+* @param {Admin_Ai_Jobs_SubheadingInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_ai_jobs_subheading = /** @type {((inputs?: Admin_Ai_Jobs_SubheadingInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Ai_Jobs_SubheadingInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_ai_jobs_subheading(inputs)
+	if (locale === "ru") return ru_admin_ai_jobs_subheading(inputs)
+	if (locale === "id") return id_admin_ai_jobs_subheading(inputs)
+	if (locale === "pt") return pt_admin_ai_jobs_subheading(inputs)
+	return fr_admin_ai_jobs_subheading(inputs)
+});

ui/src/lib/paraglide/messages/admin_nav_import.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Nav_ImportInputs */
+
+const en_admin_nav_import = /** @type {(inputs: Admin_Nav_ImportInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Import`)
+};
+
+const ru_admin_nav_import = /** @type {(inputs: Admin_Nav_ImportInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Import`)
+};
+
+const id_admin_nav_import = /** @type {(inputs: Admin_Nav_ImportInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Import`)
+};
+
+const pt_admin_nav_import = /** @type {(inputs: Admin_Nav_ImportInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Import`)
+};
+
+const fr_admin_nav_import = /** @type {(inputs: Admin_Nav_ImportInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Import`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Import" |
+*
+* @param {Admin_Nav_ImportInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_nav_import = /** @type {((inputs?: Admin_Nav_ImportInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Nav_ImportInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_nav_import(inputs)
+	if (locale === "ru") return ru_admin_nav_import(inputs)
+	if (locale === "id") return id_admin_nav_import(inputs)
+	if (locale === "pt") return pt_admin_nav_import(inputs)
+	return fr_admin_nav_import(inputs)
+});

ui/src/lib/paraglide/messages/admin_nav_notifications.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Nav_NotificationsInputs */
+
+const en_admin_nav_notifications = /** @type {(inputs: Admin_Nav_NotificationsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Notifications`)
+};
+
+const ru_admin_nav_notifications = /** @type {(inputs: Admin_Nav_NotificationsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Уведомления`)
+};
+
+const id_admin_nav_notifications = /** @type {(inputs: Admin_Nav_NotificationsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Notifikasi`)
+};
+
+const pt_admin_nav_notifications = /** @type {(inputs: Admin_Nav_NotificationsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Notificações`)
+};
+
+const fr_admin_nav_notifications = /** @type {(inputs: Admin_Nav_NotificationsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Notifications`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Notifications" |
+*
+* @param {Admin_Nav_NotificationsInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_nav_notifications = /** @type {((inputs?: Admin_Nav_NotificationsInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Nav_NotificationsInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_nav_notifications(inputs)
+	if (locale === "ru") return ru_admin_nav_notifications(inputs)
+	if (locale === "id") return id_admin_nav_notifications(inputs)
+	if (locale === "pt") return pt_admin_nav_notifications(inputs)
+	return fr_admin_nav_notifications(inputs)
+});

ui/src/lib/paraglide/messages/admin_text_gen_heading.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Text_Gen_HeadingInputs */
+
+const en_admin_text_gen_heading = /** @type {(inputs: Admin_Text_Gen_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Generation`)
+};
+
+const ru_admin_text_gen_heading = /** @type {(inputs: Admin_Text_Gen_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Generation`)
+};
+
+const id_admin_text_gen_heading = /** @type {(inputs: Admin_Text_Gen_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Generation`)
+};
+
+const pt_admin_text_gen_heading = /** @type {(inputs: Admin_Text_Gen_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Generation`)
+};
+
+const fr_admin_text_gen_heading = /** @type {(inputs: Admin_Text_Gen_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Generation`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Text Generation" |
+*
+* @param {Admin_Text_Gen_HeadingInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_text_gen_heading = /** @type {((inputs?: Admin_Text_Gen_HeadingInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Text_Gen_HeadingInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_text_gen_heading(inputs)
+	if (locale === "ru") return ru_admin_text_gen_heading(inputs)
+	if (locale === "id") return id_admin_text_gen_heading(inputs)
+	if (locale === "pt") return pt_admin_text_gen_heading(inputs)
+	return fr_admin_text_gen_heading(inputs)
+});

ui/src/lib/paraglide/messages/admin_text_gen_page_title.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Text_Gen_Page_TitleInputs */
+
+const en_admin_text_gen_page_title = /** @type {(inputs: Admin_Text_Gen_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Gen — Admin`)
+};
+
+const ru_admin_text_gen_page_title = /** @type {(inputs: Admin_Text_Gen_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Gen — Admin`)
+};
+
+const id_admin_text_gen_page_title = /** @type {(inputs: Admin_Text_Gen_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Gen — Admin`)
+};
+
+const pt_admin_text_gen_page_title = /** @type {(inputs: Admin_Text_Gen_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Gen — Admin`)
+};
+
+const fr_admin_text_gen_page_title = /** @type {(inputs: Admin_Text_Gen_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Text Gen — Admin`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Text Gen — Admin" |
+*
+* @param {Admin_Text_Gen_Page_TitleInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_text_gen_page_title = /** @type {((inputs?: Admin_Text_Gen_Page_TitleInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Text_Gen_Page_TitleInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_text_gen_page_title(inputs)
+	if (locale === "ru") return ru_admin_text_gen_page_title(inputs)
+	if (locale === "id") return id_admin_text_gen_page_title(inputs)
+	if (locale === "pt") return pt_admin_text_gen_page_title(inputs)
+	return fr_admin_text_gen_page_title(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_filter_placeholder.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_Filter_PlaceholderInputs */
+
+const en_admin_translation_filter_placeholder = /** @type {(inputs: Admin_Translation_Filter_PlaceholderInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Filter by slug, lang, or status…`)
+};
+
+const ru_admin_translation_filter_placeholder = /** @type {(inputs: Admin_Translation_Filter_PlaceholderInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Filter by slug, lang, or status…`)
+};
+
+const id_admin_translation_filter_placeholder = /** @type {(inputs: Admin_Translation_Filter_PlaceholderInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Filter by slug, lang, or status…`)
+};
+
+const pt_admin_translation_filter_placeholder = /** @type {(inputs: Admin_Translation_Filter_PlaceholderInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Filter by slug, lang, or status…`)
+};
+
+const fr_admin_translation_filter_placeholder = /** @type {(inputs: Admin_Translation_Filter_PlaceholderInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Filter by slug, lang, or status…`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Filter by slug, lang, or status…" |
+*
+* @param {Admin_Translation_Filter_PlaceholderInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_filter_placeholder = /** @type {((inputs?: Admin_Translation_Filter_PlaceholderInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_Filter_PlaceholderInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_filter_placeholder(inputs)
+	if (locale === "ru") return ru_admin_translation_filter_placeholder(inputs)
+	if (locale === "id") return id_admin_translation_filter_placeholder(inputs)
+	if (locale === "pt") return pt_admin_translation_filter_placeholder(inputs)
+	return fr_admin_translation_filter_placeholder(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_heading.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_HeadingInputs */
+
+const en_admin_translation_heading = /** @type {(inputs: Admin_Translation_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Machine Translation`)
+};
+
+const ru_admin_translation_heading = /** @type {(inputs: Admin_Translation_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Machine Translation`)
+};
+
+const id_admin_translation_heading = /** @type {(inputs: Admin_Translation_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Machine Translation`)
+};
+
+const pt_admin_translation_heading = /** @type {(inputs: Admin_Translation_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Machine Translation`)
+};
+
+const fr_admin_translation_heading = /** @type {(inputs: Admin_Translation_HeadingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Machine Translation`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Machine Translation" |
+*
+* @param {Admin_Translation_HeadingInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_heading = /** @type {((inputs?: Admin_Translation_HeadingInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_HeadingInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_heading(inputs)
+	if (locale === "ru") return ru_admin_translation_heading(inputs)
+	if (locale === "id") return id_admin_translation_heading(inputs)
+	if (locale === "pt") return pt_admin_translation_heading(inputs)
+	return fr_admin_translation_heading(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_no_jobs.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_No_JobsInputs */
+
+const en_admin_translation_no_jobs = /** @type {(inputs: Admin_Translation_No_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No translation jobs yet.`)
+};
+
+const ru_admin_translation_no_jobs = /** @type {(inputs: Admin_Translation_No_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No translation jobs yet.`)
+};
+
+const id_admin_translation_no_jobs = /** @type {(inputs: Admin_Translation_No_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No translation jobs yet.`)
+};
+
+const pt_admin_translation_no_jobs = /** @type {(inputs: Admin_Translation_No_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No translation jobs yet.`)
+};
+
+const fr_admin_translation_no_jobs = /** @type {(inputs: Admin_Translation_No_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No translation jobs yet.`)
+};
+
+/**
+* | output |
+* | --- |
+* | "No translation jobs yet." |
+*
+* @param {Admin_Translation_No_JobsInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_no_jobs = /** @type {((inputs?: Admin_Translation_No_JobsInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_No_JobsInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_no_jobs(inputs)
+	if (locale === "ru") return ru_admin_translation_no_jobs(inputs)
+	if (locale === "id") return id_admin_translation_no_jobs(inputs)
+	if (locale === "pt") return pt_admin_translation_no_jobs(inputs)
+	return fr_admin_translation_no_jobs(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_no_matching.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_No_MatchingInputs */
+
+const en_admin_translation_no_matching = /** @type {(inputs: Admin_Translation_No_MatchingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No matching jobs.`)
+};
+
+const ru_admin_translation_no_matching = /** @type {(inputs: Admin_Translation_No_MatchingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No matching jobs.`)
+};
+
+const id_admin_translation_no_matching = /** @type {(inputs: Admin_Translation_No_MatchingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No matching jobs.`)
+};
+
+const pt_admin_translation_no_matching = /** @type {(inputs: Admin_Translation_No_MatchingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No matching jobs.`)
+};
+
+const fr_admin_translation_no_matching = /** @type {(inputs: Admin_Translation_No_MatchingInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`No matching jobs.`)
+};
+
+/**
+* | output |
+* | --- |
+* | "No matching jobs." |
+*
+* @param {Admin_Translation_No_MatchingInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_no_matching = /** @type {((inputs?: Admin_Translation_No_MatchingInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_No_MatchingInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_no_matching(inputs)
+	if (locale === "ru") return ru_admin_translation_no_matching(inputs)
+	if (locale === "id") return id_admin_translation_no_matching(inputs)
+	if (locale === "pt") return pt_admin_translation_no_matching(inputs)
+	return fr_admin_translation_no_matching(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_page_title.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_Page_TitleInputs */
+
+const en_admin_translation_page_title = /** @type {(inputs: Admin_Translation_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Translation — Admin`)
+};
+
+const ru_admin_translation_page_title = /** @type {(inputs: Admin_Translation_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Translation — Admin`)
+};
+
+const id_admin_translation_page_title = /** @type {(inputs: Admin_Translation_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Translation — Admin`)
+};
+
+const pt_admin_translation_page_title = /** @type {(inputs: Admin_Translation_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Translation — Admin`)
+};
+
+const fr_admin_translation_page_title = /** @type {(inputs: Admin_Translation_Page_TitleInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Translation — Admin`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Translation — Admin" |
+*
+* @param {Admin_Translation_Page_TitleInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_page_title = /** @type {((inputs?: Admin_Translation_Page_TitleInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_Page_TitleInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_page_title(inputs)
+	if (locale === "ru") return ru_admin_translation_page_title(inputs)
+	if (locale === "id") return id_admin_translation_page_title(inputs)
+	if (locale === "pt") return pt_admin_translation_page_title(inputs)
+	return fr_admin_translation_page_title(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_tab_enqueue.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_Tab_EnqueueInputs */
+
+const en_admin_translation_tab_enqueue = /** @type {(inputs: Admin_Translation_Tab_EnqueueInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Enqueue`)
+};
+
+const ru_admin_translation_tab_enqueue = /** @type {(inputs: Admin_Translation_Tab_EnqueueInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Enqueue`)
+};
+
+const id_admin_translation_tab_enqueue = /** @type {(inputs: Admin_Translation_Tab_EnqueueInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Enqueue`)
+};
+
+const pt_admin_translation_tab_enqueue = /** @type {(inputs: Admin_Translation_Tab_EnqueueInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Enqueue`)
+};
+
+const fr_admin_translation_tab_enqueue = /** @type {(inputs: Admin_Translation_Tab_EnqueueInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Enqueue`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Enqueue" |
+*
+* @param {Admin_Translation_Tab_EnqueueInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_tab_enqueue = /** @type {((inputs?: Admin_Translation_Tab_EnqueueInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_Tab_EnqueueInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_tab_enqueue(inputs)
+	if (locale === "ru") return ru_admin_translation_tab_enqueue(inputs)
+	if (locale === "id") return id_admin_translation_tab_enqueue(inputs)
+	if (locale === "pt") return pt_admin_translation_tab_enqueue(inputs)
+	return fr_admin_translation_tab_enqueue(inputs)
+});

ui/src/lib/paraglide/messages/admin_translation_tab_jobs.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Admin_Translation_Tab_JobsInputs */
+
+const en_admin_translation_tab_jobs = /** @type {(inputs: Admin_Translation_Tab_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Jobs`)
+};
+
+const ru_admin_translation_tab_jobs = /** @type {(inputs: Admin_Translation_Tab_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Jobs`)
+};
+
+const id_admin_translation_tab_jobs = /** @type {(inputs: Admin_Translation_Tab_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Jobs`)
+};
+
+const pt_admin_translation_tab_jobs = /** @type {(inputs: Admin_Translation_Tab_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Jobs`)
+};
+
+const fr_admin_translation_tab_jobs = /** @type {(inputs: Admin_Translation_Tab_JobsInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Jobs`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Jobs" |
+*
+* @param {Admin_Translation_Tab_JobsInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const admin_translation_tab_jobs = /** @type {((inputs?: Admin_Translation_Tab_JobsInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Admin_Translation_Tab_JobsInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_admin_translation_tab_jobs(inputs)
+	if (locale === "ru") return ru_admin_translation_tab_jobs(inputs)
+	if (locale === "id") return id_admin_translation_tab_jobs(inputs)
+	if (locale === "pt") return pt_admin_translation_tab_jobs(inputs)
+	return fr_admin_translation_tab_jobs(inputs)
+});

ui/src/lib/paraglide/messages/profile_theme_cyber.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Profile_Theme_CyberInputs */
+
+const en_profile_theme_cyber = /** @type {(inputs: Profile_Theme_CyberInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Cyberpunk`)
+};
+
+const ru_profile_theme_cyber = /** @type {(inputs: Profile_Theme_CyberInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Киберпанк`)
+};
+
+const id_profile_theme_cyber = /** @type {(inputs: Profile_Theme_CyberInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Cyberpunk`)
+};
+
+const pt_profile_theme_cyber = /** @type {(inputs: Profile_Theme_CyberInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Cyberpunk`)
+};
+
+const fr_profile_theme_cyber = /** @type {(inputs: Profile_Theme_CyberInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Cyberpunk`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Cyberpunk" |
+*
+* @param {Profile_Theme_CyberInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const profile_theme_cyber = /** @type {((inputs?: Profile_Theme_CyberInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Profile_Theme_CyberInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_profile_theme_cyber(inputs)
+	if (locale === "ru") return ru_profile_theme_cyber(inputs)
+	if (locale === "id") return id_profile_theme_cyber(inputs)
+	if (locale === "pt") return pt_profile_theme_cyber(inputs)
+	return fr_profile_theme_cyber(inputs)
+});

ui/src/lib/paraglide/messages/profile_theme_forest.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Profile_Theme_ForestInputs */
+
+const en_profile_theme_forest = /** @type {(inputs: Profile_Theme_ForestInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Forest`)
+};
+
+const ru_profile_theme_forest = /** @type {(inputs: Profile_Theme_ForestInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Лес`)
+};
+
+const id_profile_theme_forest = /** @type {(inputs: Profile_Theme_ForestInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Hutan`)
+};
+
+const pt_profile_theme_forest = /** @type {(inputs: Profile_Theme_ForestInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Floresta`)
+};
+
+const fr_profile_theme_forest = /** @type {(inputs: Profile_Theme_ForestInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Forêt`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Forest" |
+*
+* @param {Profile_Theme_ForestInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const profile_theme_forest = /** @type {((inputs?: Profile_Theme_ForestInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Profile_Theme_ForestInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_profile_theme_forest(inputs)
+	if (locale === "ru") return ru_profile_theme_forest(inputs)
+	if (locale === "id") return id_profile_theme_forest(inputs)
+	if (locale === "pt") return pt_profile_theme_forest(inputs)
+	return fr_profile_theme_forest(inputs)
+});

ui/src/lib/paraglide/messages/profile_theme_mono.js

@@ -0,0 +1,44 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Profile_Theme_MonoInputs */
+
+const en_profile_theme_mono = /** @type {(inputs: Profile_Theme_MonoInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Mono`)
+};
+
+const ru_profile_theme_mono = /** @type {(inputs: Profile_Theme_MonoInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Моно`)
+};
+
+const id_profile_theme_mono = /** @type {(inputs: Profile_Theme_MonoInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Mono`)
+};
+
+const pt_profile_theme_mono = /** @type {(inputs: Profile_Theme_MonoInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Mono`)
+};
+
+const fr_profile_theme_mono = /** @type {(inputs: Profile_Theme_MonoInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Mono`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Mono" |
+*
+* @param {Profile_Theme_MonoInputs} inputs
+* @param {{ locale?: "en" | "ru" | "id" | "pt" | "fr" }} options
+* @returns {LocalizedString}
+*/
+export const profile_theme_mono = /** @type {((inputs?: Profile_Theme_MonoInputs, options?: { locale?: "en" | "ru" | "id" | "pt" | "fr" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Profile_Theme_MonoInputs, { locale?: "en" | "ru" | "id" | "pt" | "fr" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_profile_theme_mono(inputs)
+	if (locale === "ru") return ru_profile_theme_mono(inputs)
+	if (locale === "id") return id_profile_theme_mono(inputs)
+	if (locale === "pt") return pt_profile_theme_mono(inputs)
+	return fr_profile_theme_mono(inputs)
+});

ui/src/lib/server/pocketbase.ts

@@ -75,6 +75,8 @@ export interface PBUserSettings {
 	locale?: string;
 	font_family?: string;
 	font_size?: number;
+	announce_chapter?: boolean;
+	audio_mode?: string;
 	updated?: string;
 }
 
@@ -248,6 +250,14 @@ const RATINGS_CACHE_TTL = 5 * 60; // 5 minutes
 const HOME_STATS_CACHE_KEY = 'home:stats';
 const HOME_STATS_CACHE_TTL = 10 * 60; // 10 minutes — counts don't need to be exact
 
+const SCRAPING_TASKS_CACHE_KEY = 'admin:scraping_tasks';
+const AUDIO_JOBS_CACHE_KEY = 'admin:audio_jobs';
+const TRANSLATION_JOBS_CACHE_KEY = 'admin:translation_jobs';
+const ADMIN_JOBS_CACHE_TTL = 30; // 30 seconds — admin views poll frequently
+
+const BOOK_SLUGS_CACHE_KEY = 'books:slugs';
+const BOOK_SLUGS_CACHE_TTL = 10 * 60; // 10 minutes — slugs change rarely
+
 async function getAllRatings(): Promise<BookRating[]> {
 	const cached = await cache.get<BookRating[]>(RATINGS_CACHE_KEY);
 	if (cached) return cached;
@@ -272,6 +282,31 @@ export async function listBooks(): Promise<Book[]> {
 	return books;
 }
 
+export interface BookSlug {
+	slug: string;
+	title: string;
+}
+
+/**
+ * Returns only the slug and title of every book. Cheaper than listBooks() —
+ * used for datalist autocomplete in admin forms. Cached for 10 minutes.
+ */
+export async function listBookSlugs(): Promise<BookSlug[]> {
+	const cached = await cache.get<BookSlug[]>(BOOK_SLUGS_CACHE_KEY);
+	if (cached) return cached;
+	// Re-use full books cache if already warm — avoids a second PocketBase call.
+	const fullCached = await cache.get<Book[]>(BOOKS_CACHE_KEY);
+	if (fullCached) {
+		const slugs = fullCached.map((b) => ({ slug: b.slug, title: b.title }));
+		await cache.set(BOOK_SLUGS_CACHE_KEY, slugs, BOOK_SLUGS_CACHE_TTL);
+		return slugs;
+	}
+	const items = await listAll<BookSlug>('books', '', '+title').catch(() => [] as BookSlug[]);
+	const slugs = items.map((b) => ({ slug: b.slug, title: b.title }));
+	await cache.set(BOOK_SLUGS_CACHE_KEY, slugs, BOOK_SLUGS_CACHE_TTL);
+	return slugs;
+}
+
 /**
  * Fetch only the books whose slugs are in the given set.
  * Uses PocketBase filter `slug IN (...)` — a single request regardless of how
@@ -612,6 +647,7 @@ export interface UserLibraryEntry {
 	user_id?: string;
 	slug: string;
 	saved_at: string;
+	shelf?: string;
 }
 
 function libraryFilter(sessionId: string, userId?: string): string {
@@ -641,6 +677,19 @@ export async function isBookSaved(
 	return row !== null;
 }
 
+/** Returns the shelf the user has placed this book on, or '' if not saved / no shelf set. */
+export async function getBookShelf(
+	sessionId: string,
+	slug: string,
+	userId?: string
+): Promise<ShelfName> {
+	const filter = userId
+		? `user_id="${userId}"&&slug="${slug}"`
+		: `session_id="${sessionId}"&&slug="${slug}"`;
+	const row = await listOne<UserLibraryEntry>('user_library', filter).catch(() => null);
+	return (row?.shelf as ShelfName) || '';
+}
+
 /** Save a book to the user's library. No-op if already saved. */
 export async function saveBook(
 	sessionId: string,
@@ -965,7 +1014,7 @@ export async function getSettings(
 
 export async function saveSettings(
 	sessionId: string,
-	settings: { autoNext: boolean; voice: string; speed: number; theme?: string; locale?: string; fontFamily?: string; fontSize?: number },
+	settings: { autoNext: boolean; voice: string; speed: number; theme?: string; locale?: string; fontFamily?: string; fontSize?: number; announceChapter?: boolean; audioMode?: string },
 	userId?: string
 ): Promise<void> {
 	const existing = await listOne<PBUserSettings & { id: string }>(
@@ -984,6 +1033,8 @@ export async function saveSettings(
 	if (settings.locale !== undefined) payload.locale = settings.locale;
 	if (settings.fontFamily !== undefined) payload.font_family = settings.fontFamily;
 	if (settings.fontSize !== undefined) payload.font_size = settings.fontSize;
+	if (settings.announceChapter !== undefined) payload.announce_chapter = settings.announceChapter;
+	if (settings.audioMode !== undefined) payload.audio_mode = settings.audioMode;
 	if (userId) payload.user_id = userId;
 
 	if (existing) {
@@ -1052,16 +1103,6 @@ export interface AudioCacheEntry {
 	updated: string;
 }
 
-export async function listAudioCache(): Promise<AudioCacheEntry[]> {
-	const jobs = await listAll<AudioJob>('audio_jobs', 'status="done"', '-finished');
-	return jobs.map((j) => ({
-		id: j.id,
-		cache_key: j.cache_key,
-		filename: `${j.cache_key}.mp3`,
-		updated: j.finished
-	}));
-}
-
 // ─── Scraping tasks ───────────────────────────────────────────────────────────
 
 export interface ScrapingTask {
@@ -1081,7 +1122,11 @@ export interface ScrapingTask {
 }
 
 export async function listScrapingTasks(): Promise<ScrapingTask[]> {
-	return listAll<ScrapingTask>('scraping_tasks', '', '-started');
+	const cached = await cache.get<ScrapingTask[]>(SCRAPING_TASKS_CACHE_KEY);
+	if (cached) return cached;
+	const tasks = await listN<ScrapingTask>('scraping_tasks', 500, '', '-started');
+	await cache.set(SCRAPING_TASKS_CACHE_KEY, tasks, ADMIN_JOBS_CACHE_TTL);
+	return tasks;
 }
 
 export async function getScrapingTask(id: string): Promise<ScrapingTask | null> {
@@ -1103,7 +1148,11 @@ export interface AudioJob {
 }
 
 export async function listAudioJobs(): Promise<AudioJob[]> {
-	return listAll<AudioJob>('audio_jobs', '', '-started');
+	const cached = await cache.get<AudioJob[]>(AUDIO_JOBS_CACHE_KEY);
+	if (cached) return cached;
+	const jobs = await listN<AudioJob>('audio_jobs', 500, '', '-started');
+	await cache.set(AUDIO_JOBS_CACHE_KEY, jobs, ADMIN_JOBS_CACHE_TTL);
+	return jobs;
 }
 
 /**
@@ -1130,7 +1179,11 @@ export interface TranslationJob {
 }
 
 export async function listTranslationJobs(): Promise<TranslationJob[]> {
-	return listAll<TranslationJob>('translation_jobs', '', '-started');
+	const cached = await cache.get<TranslationJob[]>(TRANSLATION_JOBS_CACHE_KEY);
+	if (cached) return cached;
+	const jobs = await listN<TranslationJob>('translation_jobs', 500, '', '-started');
+	await cache.set(TRANSLATION_JOBS_CACHE_KEY, jobs, ADMIN_JOBS_CACHE_TTL);
+	return jobs;
 }
 
 export async function getAudioTime(
@@ -1332,6 +1385,20 @@ export async function revokeUserSession(recordId: string, userId: string): Promi
 	return del.ok || del.status === 204;
 }
 
+/**
+ * Delete a session by its auth session ID (the value stored in the cookie).
+ * Used on logout so the row doesn't linger as a phantom active session.
+ */
+export async function deleteSessionByAuthId(authSessionId: string): Promise<void> {
+	const row = await listOne<UserSession>('user_sessions', `session_id="${authSessionId}"`);
+	if (!row) return;
+	const token = await getToken();
+	await fetch(`${PB_URL}/api/collections/user_sessions/records/${row.id}`, {
+		method: 'DELETE',
+		headers: { Authorization: `Bearer ${token}` }
+	}).catch(() => {});
+}
+
 /**
  * Revoke all sessions for a user (used on password change etc).
  */
@@ -1479,6 +1546,7 @@ export async function createComment(
 		method: 'POST',
 		headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
 		body: JSON.stringify({
+			id: crypto.randomUUID().replace(/-/g, '').slice(0, 15),
 			slug,
 			chapter,
 			body,
@@ -2235,10 +2303,17 @@ export async function getUserStats(
 
 // ─── AI Jobs ──────────────────────────────────────────────────────────────────
 
+const AI_JOBS_CACHE_KEY = 'admin:ai_jobs';
+const AI_JOBS_CACHE_TTL = 30; // 30 seconds — same as other admin job lists
+
 /**
  * List all AI jobs from PocketBase, sorted by started descending.
- * No caching — admin views always want fresh data.
+ * Short-lived cache (30s) to avoid hammering PocketBase on every navigation.
  */
 export async function listAIJobs(): Promise<AIJob[]> {
-	return listAll<AIJob>('ai_jobs', '', '-started');
+	const cached = await cache.get<AIJob[]>(AI_JOBS_CACHE_KEY);
+	if (cached) return cached;
+	const jobs = await listAll<AIJob>('ai_jobs', '', '-started');
+	await cache.set(AI_JOBS_CACHE_KEY, jobs, AI_JOBS_CACHE_TTL);
+	return jobs;
 }

ui/src/routes/+layout.server.ts

@@ -17,7 +17,7 @@ export const load: LayoutServerLoad = async ({ locals, url, cookies }) => {
 		redirect(302, `/login`);
 	}
 
-	let settings = { autoNext: false, voice: 'af_bella', speed: 1.0, theme: 'amber', locale: 'en', fontFamily: 'system', fontSize: 1.0 };
+	let settings = { autoNext: false, voice: 'af_bella', speed: 1.0, theme: 'amber', locale: 'en', fontFamily: 'system', fontSize: 1.0, announceChapter: false, audioMode: 'stream' };
 	try {
 		const row = await getSettings(locals.sessionId, locals.user?.id);
 		if (row) {
@@ -28,7 +28,9 @@ export const load: LayoutServerLoad = async ({ locals, url, cookies }) => {
 				theme: row.theme ?? 'amber',
 				locale: row.locale ?? 'en',
 				fontFamily: row.font_family ?? 'system',
-				fontSize: row.font_size || 1.0
+				fontSize: row.font_size || 1.0,
+				announceChapter: row.announce_chapter ?? false,
+				audioMode: row.audio_mode ?? 'stream'
 			};
 		}
 	} catch (e) {

ui/src/routes/+layout.svelte

@@ -12,12 +12,69 @@
 	import * as m from '$lib/paraglide/messages.js';
 	import { locales, getLocale } from '$lib/paraglide/runtime.js';
 	import ListeningMode from '$lib/components/ListeningMode.svelte';
+	import SearchModal from '$lib/components/SearchModal.svelte';
+	import { fly, fade } from 'svelte/transition';
 
 	let { children, data }: { children: Snippet; data: LayoutData } = $props();
 
 	// Mobile nav drawer state
 	let menuOpen = $state(false);
 
+	// Universal search
+	let searchOpen = $state(false);
+
+	// Notifications
+	let notificationsOpen = $state(false);
+	let notifications = $state<{id: string; title: string; message: string; link: string; read: boolean}[]>([]);
+	let notifFilter = $state<'all' | 'unread'>('all');
+	async function loadNotifications() {
+		if (!data.user) return;
+		try {
+			const res = await fetch('/api/notifications?user_id=' + data.user.id);
+			if (res.ok) {
+				const d = await res.json();
+				notifications = d.notifications || [];
+			}
+		} catch (e) { console.error('load notifications:', e); }
+	}
+	async function markRead(id: string) {
+		try {
+			await fetch('/api/notifications/' + id, { method: 'PATCH' });
+			notifications = notifications.map(n => n.id === id ? {...n, read: true} : n);
+		} catch (e) { console.error('mark read:', e); }
+	}
+	async function markAllRead() {
+		if (!data.user) return;
+		try {
+			await fetch('/api/notifications?user_id=' + data.user.id, { method: 'PATCH' });
+			notifications = notifications.map(n => ({ ...n, read: true }));
+		} catch (e) { console.error('mark all read:', e); }
+	}
+	async function dismissNotification(id: string) {
+		try {
+			await fetch('/api/notifications/' + id, { method: 'DELETE' });
+			notifications = notifications.filter(n => n.id !== id);
+		} catch (e) { console.error('dismiss notification:', e); }
+	}
+	async function clearAllNotifications() {
+		if (!data.user) return;
+		try {
+			await fetch('/api/notifications?user_id=' + data.user.id, { method: 'DELETE' });
+			notifications = [];
+		} catch (e) { console.error('clear notifications:', e); }
+	}
+	$effect(() => { if (data.user) loadNotifications(); });
+	const unreadCount = $derived(notifications.filter(n => !n.read).length);
+	const filteredNotifications = $derived(
+		notifFilter === 'unread' ? notifications.filter(n => !n.read) : notifications
+	);
+
+	// Close search on navigation
+	$effect(() => {
+		void page.url.pathname;
+		searchOpen = false;
+	});
+
 	// Desktop dropdown menus
 	let userMenuOpen = $state(false);
 	let langMenuOpen = $state(false);
@@ -27,6 +84,9 @@
 		{ id: 'amber',       color: '#f59e0b' },
 		{ id: 'slate',       color: '#818cf8' },
 		{ id: 'rose',        color: '#fb7185' },
+		{ id: 'forest',      color: '#4ade80' },
+		{ id: 'mono',        color: '#f4f4f5' },
+		{ id: 'cyber',       color: '#22d3ee' },
 		{ id: 'light',       color: '#d97706', light: true },
 		{ id: 'light-slate', color: '#4f46e5', light: true },
 		{ id: 'light-rose',  color: '#e11d48', light: true },
@@ -96,6 +156,8 @@
 				audioStore.autoNext = data.settings.autoNext;
 				audioStore.voice = data.settings.voice;
 				audioStore.speed = data.settings.speed;
+				audioStore.announceChapter = data.settings.announceChapter ?? false;
+				audioStore.audioMode = (data.settings.audioMode === 'generate' ? 'generate' : 'stream');
 			}
 			// Always sync theme + font (profile page calls invalidateAll after saving)
 			currentTheme = data.settings.theme ?? 'amber';
@@ -117,6 +179,8 @@
 		const theme = currentTheme;
 		const fontFamily = currentFontFamily;
 		const fontSize = currentFontSize;
+		const announceChapter = audioStore.announceChapter;
+		const audioMode = audioStore.audioMode;
 
 		// Skip saving until settings have been applied from the server AND
 		// at least one user-driven change has occurred after that.
@@ -127,7 +191,7 @@
 			fetch('/api/settings', {
 				method: 'PUT',
 				headers: { 'Content-Type': 'application/json' },
-				body: JSON.stringify({ autoNext, voice, speed, theme, fontFamily, fontSize })
+				body: JSON.stringify({ autoNext, voice, speed, theme, fontFamily, fontSize, announceChapter, audioMode })
 			}).catch(() => {});
 		}, 800) as unknown as number;
 	});
@@ -244,6 +308,11 @@
 		navigator.mediaSession.playbackState = audioStore.isPlaying ? 'playing' : 'paused';
 	});
 
+	// ── Announce-chapter safety timeout ──────────────────────────────────────
+	// Module-level so the onended handler can clear it if the clip completes
+	// before the timeout fires.
+	let announceTimeout = 0;
+
 	// ── Save audio time on pause/end (debounced 2s) ─────────────────────────
 	let audioTimeSaveTimer = 0;
 	function saveAudioTime() {
@@ -350,7 +419,36 @@
 	}}
 	onended={() => {
 		audioStore.isPlaying = false;
-		saveAudioTime();
+
+		// ── If we just finished playing an announcement clip, navigate now ──
+		if (audioStore.announceNavigatePending) {
+			audioStore.announceNavigatePending = false;
+			clearTimeout(announceTimeout);
+			announceTimeout = 0;
+			const slug    = audioStore.announcePendingSlug;
+			const chapter = audioStore.announcePendingChapter;
+			audioStore.announcePendingSlug    = '';
+			audioStore.announcePendingChapter = 0;
+			goto(`/books/${slug}/chapters/${chapter}`).catch(() => {
+				audioStore.autoStartChapter = null;
+			});
+			return;
+		}
+
+		// Cancel any pending debounced save and reset the position to 0 for
+		// the chapter that just finished. Without this, the 2s debounce fires
+		// after navigation and saves currentTime≈duration, causing resume to
+		// start at the very end next time the user returns to this chapter.
+		clearTimeout(audioTimeSaveTimer);
+		if (audioStore.slug && audioStore.chapter) {
+			const slug = audioStore.slug;
+			const chapter = audioStore.chapter;
+			fetch('/api/progress/audio-time', {
+				method: 'PATCH',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify({ slug, chapter, audioTime: 0 })
+			}).catch(() => {});
+		}
 		// If sleep-after-chapter is set, just pause instead of navigating
 		if (audioStore.sleepAfterChapter) {
 			audioStore.sleepAfterChapter = false;
@@ -361,14 +459,56 @@
 			// Capture values synchronously before any async work — the AudioPlayer
 			// component will unmount during navigation, but we've already read what
 			// we need.
-			const targetSlug = audioStore.slug;
+			const targetSlug    = audioStore.slug;
 			const targetChapter = audioStore.nextChapter;
 			// Store the target chapter number so only the newly-mounted AudioPlayer
 			// for that chapter reacts — not the outgoing chapter's component.
 			audioStore.autoStartChapter = targetChapter;
-			goto(`/books/${targetSlug}/chapters/${targetChapter}`).catch(() => {
-				audioStore.autoStartChapter = null;
-			});
+
+			const doNavigate = () => {
+				goto(`/books/${targetSlug}/chapters/${targetChapter}`).catch(() => {
+					audioStore.autoStartChapter = null;
+				});
+			};
+
+			// Announce via a real audio clip so the audio session stays alive on
+			// iOS Safari / Chrome Android (speechSynthesis is silently muted after
+			// onended because the audio session has been released).
+			if (audioStore.announceChapter) {
+				const nextInfo  = audioStore.chapters.find((c) => c.number === targetChapter);
+				const titlePart = nextInfo?.title ? ` — ${nextInfo.title}` : '';
+				const text      = `Chapter ${targetChapter}${titlePart}`;
+
+				// Always request MP3 — universally supported and the backend
+				// auto-selects the right TTS engine from the voice ID.
+				const qs       = new URLSearchParams({ text, voice: audioStore.voice, format: 'mp3' });
+				const announceUrl = `/api/announce?${qs}`;
+
+				// Store pending navigation target so the next onended (from the
+				// announcement clip) knows where to go.
+				audioStore.announcePendingSlug    = targetSlug;
+				audioStore.announcePendingChapter = targetChapter;
+				audioStore.announceNavigatePending = true;
+
+				// Safety timeout: if the clip never loads/ends (network issue,
+				// browser policy, unsupported codec), navigate anyway after 10s.
+				clearTimeout(announceTimeout);
+				announceTimeout = setTimeout(() => {
+					if (audioStore.announceNavigatePending) {
+						audioStore.announceNavigatePending = false;
+						audioStore.announcePendingSlug    = '';
+						audioStore.announcePendingChapter = 0;
+						doNavigate();
+					}
+				}, 10_000) as unknown as number;
+
+				// Point the persistent <audio> element at the announcement clip.
+				// The $effect in the layout that watches audioStore.audioUrl will
+				// pick this up, set audioEl.src, and call play().
+				audioStore.audioUrl = announceUrl;
+			} else {
+				doNavigate();
+			}
 		}
 	}}
 	preload="metadata"
@@ -389,9 +529,12 @@
 			</a>
 
 			{#if page.data.book?.title && /\/books\/[^/]+\/chapters\//.test(page.url.pathname)}
-				<span class="text-(--color-muted) text-sm truncate min-w-0 flex-1 sm:flex-none sm:max-w-xs">
+				<a
+					href="/books/{page.data.book.slug}"
+					class="text-(--color-muted) hover:text-(--color-text) text-sm truncate min-w-0 flex-1 sm:flex-none sm:max-w-xs transition-colors"
+				>
 					{page.data.book.title}
-				</span>
+				</a>
 			{/if}
 
 			{#if data.user}
@@ -430,6 +573,120 @@
 		</a>
 		{/if}
 			<div class="ml-auto flex items-center gap-2">
+				<!-- Universal search button (hidden on chapter/reader pages) -->
+				{#if !/\/books\/[^/]+\/chapters\//.test(page.url.pathname)}
+					<button
+						type="button"
+						onclick={() => { searchOpen = true; userMenuOpen = false; langMenuOpen = false; themeMenuOpen = false; menuOpen = false; notificationsOpen = false; }}
+						title="Search (/ or ⌘K)"
+						aria-label="Search books"
+						class="flex items-center justify-center w-8 h-8 rounded transition-colors text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2)"
+					>
+						<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+							<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+						</svg>
+					</button>
+				{/if}
+
+				<!-- Notifications bell -->
+				{#if data.user?.role === 'admin'}
+					<div class="relative">
+						<button
+							type="button"
+							onclick={() => { notificationsOpen = !notificationsOpen; searchOpen = false; userMenuOpen = false; langMenuOpen = false; themeMenuOpen = false; }}
+							title="Notifications"
+							class="flex items-center justify-center w-8 h-8 rounded transition-colors {notificationsOpen ? 'bg-(--color-surface-2)' : 'hover:bg-(--color-surface-2)'} relative"
+						>
+							<svg class="w-4 h-4 text-(--color-muted)" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+								<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9"/>
+							</svg>
+							{#if unreadCount > 0}
+								<span class="absolute top-1 right-1 w-2 h-2 bg-red-500 rounded-full"></span>
+							{/if}
+						</button>
+						{#if notificationsOpen}
+							<div class="absolute right-0 top-full mt-1 w-80 bg-(--color-surface-2) border border-(--color-border) rounded-lg shadow-xl z-50 flex flex-col max-h-[28rem]">
+								<!-- Header -->
+								<div class="flex items-center justify-between px-3 pt-3 pb-2 shrink-0">
+									<span class="text-sm font-semibold">Notifications</span>
+									<div class="flex items-center gap-1">
+										{#if unreadCount > 0}
+											<button
+												type="button"
+												onclick={markAllRead}
+												class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors px-1.5 py-0.5 rounded hover:bg-(--color-surface-3)"
+											>Mark all read</button>
+										{/if}
+										{#if notifications.length > 0}
+											<button
+												type="button"
+												onclick={clearAllNotifications}
+												class="text-xs text-(--color-muted) hover:text-red-400 transition-colors px-1.5 py-0.5 rounded hover:bg-(--color-surface-3)"
+											>Clear all</button>
+										{/if}
+									</div>
+								</div>
+								<!-- Filter tabs -->
+								<div class="flex gap-0 px-3 pb-2 shrink-0">
+									<button
+										type="button"
+										onclick={() => notifFilter = 'all'}
+										class="text-xs px-2.5 py-1 rounded-l border border-(--color-border) transition-colors {notifFilter === 'all' ? 'bg-(--color-brand) text-black border-(--color-brand)' : 'text-(--color-muted) hover:text-(--color-text)'}"
+									>All ({notifications.length})</button>
+									<button
+										type="button"
+										onclick={() => notifFilter = 'unread'}
+										class="text-xs px-2.5 py-1 rounded-r border border-l-0 border-(--color-border) transition-colors {notifFilter === 'unread' ? 'bg-(--color-brand) text-black border-(--color-brand)' : 'text-(--color-muted) hover:text-(--color-text)'}"
+									>Unread ({unreadCount})</button>
+								</div>
+								<!-- List -->
+								<div class="overflow-y-auto flex-1 min-h-0">
+									{#if filteredNotifications.length === 0}
+										<div class="p-4 text-center text-(--color-muted) text-sm">
+											{notifFilter === 'unread' ? 'No unread notifications' : 'No notifications'}
+										</div>
+									{:else}
+										{#each filteredNotifications as n (n.id)}
+											<div class="flex items-start gap-1 border-b border-(--color-border)/40 hover:bg-(--color-surface-3) group {n.read ? 'opacity-60' : ''}">
+												<a
+													href={n.link || '/admin'}
+													onclick={() => { markRead(n.id); notificationsOpen = false; }}
+													class="flex-1 p-3 min-w-0"
+												>
+													<div class="flex items-center gap-1.5">
+														{#if !n.read}
+															<span class="w-1.5 h-1.5 rounded-full bg-(--color-brand) shrink-0"></span>
+														{/if}
+														<span class="text-sm font-medium truncate">{n.title}</span>
+													</div>
+													<div class="text-xs text-(--color-muted) mt-0.5 line-clamp-2">{n.message}</div>
+												</a>
+												<button
+													type="button"
+													onclick={() => dismissNotification(n.id)}
+													class="shrink-0 p-2.5 text-(--color-muted) hover:text-red-400 opacity-0 group-hover:opacity-100 transition-all"
+													title="Dismiss"
+												>
+													<svg class="w-3 h-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+														<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+													</svg>
+												</button>
+											</div>
+										{/each}
+									{/if}
+								</div>
+								<!-- Footer -->
+								<div class="px-3 py-2 border-t border-(--color-border)/40 shrink-0">
+									<a
+										href="/admin/notifications"
+										onclick={() => notificationsOpen = false}
+										class="block text-center text-xs text-(--color-muted) hover:text-(--color-brand) transition-colors"
+									>View all notifications</a>
+								</div>
+							</div>
+						{/if}
+					</div>
+				{/if}
 				<!-- Theme dropdown (desktop) -->
 				<div class="hidden sm:block relative">
 					<button
@@ -714,11 +971,15 @@
 
 	<main class="flex-1 max-w-6xl mx-auto w-full px-4 py-8">
 		{#key page.url.pathname + page.url.search}
-			{@render children()}
+			<div in:fade={{ duration: 180, delay: 60 }} out:fade={{ duration: 100 }}>
+				{@render children()}
+			</div>
 		{/key}
 	</main>
 
-	<footer class="border-t border-(--color-border) mt-auto">
+	<footer class="border-t border-(--color-border) mt-auto"
+		class:hidden={/\/books\/[^/]+\/chapters\//.test(page.url.pathname)}
+	>
 		<div class="max-w-6xl mx-auto px-4 py-6 flex flex-col items-center gap-4 text-xs text-(--color-muted)">
 			<!-- Top row: site links -->
 			<nav class="flex flex-wrap items-center justify-center gap-x-5 gap-y-2">
@@ -948,8 +1209,29 @@
 <!-- Listening mode — mounted at root level, independent of audioStore.active,
      so closing/pausing audio never tears it down and loses context. -->
 {#if listeningModeOpen}
-	<ListeningMode
-		onclose={() => { listeningModeOpen = false; listeningModeChapters = false; }}
-		openChapters={listeningModeChapters}
-	/>
+	<div transition:fly={{ y: '100%', duration: 320, opacity: 1 }} style="pointer-events: none;">
+		<ListeningMode
+			onclose={() => { listeningModeOpen = false; listeningModeChapters = false; }}
+			openChapters={listeningModeChapters}
+		/>
+	</div>
 {/if}
+
+<!-- Universal search modal — shown from anywhere except focus mode / listening mode -->
+{#if searchOpen && !listeningModeOpen}
+	<SearchModal onclose={() => { searchOpen = false; }} />
+{/if}
+
+<svelte:window onkeydown={(e) => {
+	// Don't intercept when typing in an input/textarea
+	const tag = (e.target as HTMLElement).tagName;
+	if (tag === 'INPUT' || tag === 'TEXTAREA' || (e.target as HTMLElement).isContentEditable) return;
+	// Don't open on chapter reader pages
+	if (/\/books\/[^/]+\/chapters\//.test(page.url.pathname)) return;
+	if (searchOpen) return;
+	// `/` key or Cmd/Ctrl+K
+	if (e.key === '/' || ((e.metaKey || e.ctrlKey) && e.key === 'k')) {
+		e.preventDefault();
+		searchOpen = true;
+	}
+}} />

ui/src/routes/+page.svelte

@@ -73,44 +73,56 @@
 	];
 
 	// ── Hero carousel ────────────────────────────────────────────────────────
+	const CAROUSEL_INTERVAL = 6000; // ms
 	const heroBooks  = $derived(data.continueInProgress);
 	let heroIndex    = $state(0);
 	const heroBook   = $derived(heroBooks[heroIndex] ?? null);
-	// Shelf shows remaining books not in the hero
-	const shelfBooks = $derived(
-		heroBooks.length > 1 ? heroBooks.filter((_, i) => i !== heroIndex) : []
-	);
+	// Shelf always shows books at positions 1…n — stable regardless of heroIndex
+	// so that navigating the carousel doesn't reshuffle the shelf below.
+	const shelfBooks = $derived(heroBooks.length > 1 ? heroBooks.slice(1) : []);
 	const streak     = $derived(data.stats.streak ?? 0);
 
-	function heroPrev() {
-		heroIndex = (heroIndex - 1 + heroBooks.length) % heroBooks.length;
-		resetAutoAdvance();
-	}
-	function heroNext() {
-		heroIndex = (heroIndex + 1) % heroBooks.length;
-		resetAutoAdvance();
-	}
 	function heroDot(i: number) {
 		heroIndex = i;
 		resetAutoAdvance();
 	}
 
-	let autoAdvanceTimer = $state<ReturnType<typeof setInterval> | null>(null);
-
-	function resetAutoAdvance() {
-		if (autoAdvanceTimer) clearInterval(autoAdvanceTimer);
-		if (heroBooks.length > 1) {
-			autoAdvanceTimer = setInterval(() => {
-				heroIndex = (heroIndex + 1) % heroBooks.length;
-			}, 6000);
-		}
-	}
+	// Auto-advance carousel every CAROUSEL_INTERVAL ms when there are multiple books.
+	// autoAdvanceSeed is bumped on manual swipe/dot to restart the interval.
+	let autoAdvanceSeed = $state(0);
 
 	$effect(() => {
-		resetAutoAdvance();
-		return () => { if (autoAdvanceTimer) clearInterval(autoAdvanceTimer); };
+		if (heroBooks.length <= 1) return;
+		const len = heroBooks.length;
+		void autoAdvanceSeed; // restart when seed changes
+		const id = setInterval(() => {
+			heroIndex = (heroIndex + 1) % len;
+		}, CAROUSEL_INTERVAL);
+		return () => clearInterval(id);
 	});
 
+	function resetAutoAdvance() {
+		autoAdvanceSeed++;
+	}
+
+	// ── Swipe handling ───────────────────────────────────────────────────────
+	let swipeStartX = 0;
+	function onSwipeStart(e: TouchEvent) {
+		swipeStartX = e.touches[0].clientX;
+	}
+	function onSwipeEnd(e: TouchEvent) {
+		const dx = e.changedTouches[0].clientX - swipeStartX;
+		if (Math.abs(dx) < 40) return; // ignore tiny movements
+		if (dx < 0) {
+			// swipe left → next
+			heroIndex = (heroIndex + 1) % heroBooks.length;
+		} else {
+			// swipe right → prev
+			heroIndex = (heroIndex - 1 + heroBooks.length) % heroBooks.length;
+		}
+		resetAutoAdvance();
+	}
+
 	function playChapter(slug: string, chapter: number) {
 		audioStore.autoStartChapter = chapter;
 		goto(`/books/${slug}/chapters/${chapter}`);
@@ -125,8 +137,13 @@
 {#if heroBook}
 <section class="mb-6">
 	<div class="relative">
-		<!-- Card -->
-		<div class="group relative flex gap-0 rounded-xl overflow-hidden bg-(--color-surface-2) border border-(--color-border) hover:border-(--color-brand)/50 transition-all">
+		<!-- Card — swipe to navigate -->
+		<!-- svelte-ignore a11y_no_static_element_interactions -->
+		<div
+			class="group relative flex gap-0 rounded-xl overflow-hidden bg-(--color-surface-2) border border-(--color-border) hover:border-(--color-brand)/50 transition-all"
+			ontouchstart={onSwipeStart}
+			ontouchend={onSwipeEnd}
+		>
 			<!-- Cover -->
 			<a href="/books/{heroBook.book.slug}/chapters/{heroBook.chapter}"
 				class="w-32 sm:w-44 shrink-0 aspect-[2/3] overflow-hidden block">
@@ -173,53 +190,26 @@
 						</svg>
 						Listen
 					</button>
-					{#if heroBook.book.total_chapters > 0 && heroBook.chapter < heroBook.book.total_chapters}
-						{@const ahead = heroBook.book.total_chapters - heroBook.chapter}
-						<span class="text-xs text-(--color-muted) hidden sm:inline">{ahead} chapters ahead</span>
-					{/if}
 					{#each parseGenres(heroBook.book.genres).slice(0, 2) as genre}
 						<span class="text-xs px-2 py-1 rounded-full bg-(--color-surface-3) text-(--color-muted)">{genre}</span>
 					{/each}
 				</div>
 			</div>
-
-			<!-- Prev / Next arrow buttons (only when multiple books) -->
-			{#if heroBooks.length > 1}
-				<button
-					type="button"
-					onclick={heroPrev}
-					class="absolute left-2 top-1/2 -translate-y-1/2 w-8 h-8 rounded-full bg-(--color-surface)/80 border border-(--color-border) text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors flex items-center justify-center backdrop-blur-sm z-10"
-					aria-label="Previous book"
-				>
-					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 19l-7-7 7-7"/>
-					</svg>
-				</button>
-				<button
-					type="button"
-					onclick={heroNext}
-					class="absolute right-2 top-1/2 -translate-y-1/2 w-8 h-8 rounded-full bg-(--color-surface)/80 border border-(--color-border) text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors flex items-center justify-center backdrop-blur-sm z-10"
-					aria-label="Next book"
-				>
-					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"/>
-					</svg>
-				</button>
-			{/if}
 		</div>
 
 		<!-- Dot indicators -->
 		{#if heroBooks.length > 1}
-			<div class="flex items-center justify-center gap-1.5 mt-2.5">
+			<div class="flex items-center justify-center gap-2 mt-2.5">
 				{#each heroBooks as _, i}
 					<button
 						type="button"
 						onclick={() => heroDot(i)}
 						aria-label="Go to book {i + 1}"
-						class="rounded-full transition-all duration-300 {i === heroIndex
+					>
+						<span class="block rounded-full transition-all duration-300 {i === heroIndex
 							? 'w-4 h-1.5 bg-(--color-brand)'
-							: 'w-1.5 h-1.5 bg-(--color-border) hover:bg-(--color-muted)'}"
-					></button>
+							: 'w-1.5 h-1.5 bg-(--color-border) hover:bg-(--color-muted)'}"></span>
+					</button>
 				{/each}
 			</div>
 		{/if}
@@ -231,9 +221,6 @@
 {#if streak > 0}
 <div class="mb-6 flex items-center gap-3 flex-wrap text-sm">
 	<span class="inline-flex items-center gap-1.5 px-3 py-1.5 rounded-lg bg-(--color-surface-2) border border-(--color-border)">
-		<svg class="w-4 h-4 text-orange-400" fill="currentColor" viewBox="0 0 24 24">
-			<path d="M13.5 0.67s.74 2.65.74 4.8c0 2.06-1.35 3.73-3.41 3.73-2.07 0-3.63-1.67-3.63-3.73l.03-.36C5.21 7.51 4 10.62 4 14c0 4.42 3.58 8 8 8s8-3.58 8-8C20 8.61 17.41 3.8 13.5.67zM11.71 19c-1.78 0-3.22-1.4-3.22-3.14 0-1.62 1.05-2.76 2.81-3.12 1.77-.36 3.6-1.21 4.62-2.58.39 1.29.59 2.65.59 4.04 0 2.65-2.15 4.8-4.8 4.8z"/>
-		</svg>
 		<span class="font-semibold text-(--color-text)">{streak}</span>
 		<span class="text-(--color-muted)">day{streak !== 1 ? 's' : ''} reading</span>
 	</span>
@@ -268,12 +255,6 @@
 						<span class="absolute bottom-1.5 right-1.5 text-xs bg-(--color-brand) text-(--color-surface) font-bold px-1.5 py-0.5 rounded">
 							{m.home_chapter_badge({ n: String(chapter) })}
 						</span>
-						<!-- Chapters ahead badge -->
-						{#if book.total_chapters > 0 && chapter < book.total_chapters}
-							<span class="absolute top-1.5 left-1.5 text-xs bg-black/60 text-white font-medium px-1.5 py-0.5 rounded">
-								{book.total_chapters - chapter} left
-							</span>
-						{/if}
 					</div>
 				</a>
 				<!-- Listen button (hover overlay) -->
@@ -313,7 +294,7 @@
 							<svg class="w-8 h-8 text-(--color-muted)" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253"/></svg>
 						</div>
 					{/if}
-					<span class="absolute top-1.5 right-1.5 text-xs bg-green-600/90 text-white font-bold px-1.5 py-0.5 rounded">✓ Done</span>
+					<span class="absolute top-1.5 right-1.5 text-xs bg-green-600/90 text-white font-bold px-1.5 py-0.5 rounded">Done</span>
 				</div>
 				<div class="p-2">
 					<h3 class="text-xs font-semibold text-(--color-text) line-clamp-2 leading-snug">{book.title ?? ''}</h3>
@@ -572,6 +553,6 @@
 	<span><span class="font-semibold text-(--color-text)">{data.stats.totalChapters.toLocaleString()}</span> {m.home_stat_chapters()}</span>
 	{#if streak > 0}
 		<span class="w-px h-4 bg-(--color-border)"></span>
-		<span><span class="font-semibold text-(--color-text)">{streak}</span> day streak 🔥</span>
+		<span><span class="font-semibold text-(--color-text)">{streak}</span> day streak</span>
 	{/if}
 </div>

ui/src/routes/admin/+layout.svelte

@@ -3,25 +3,99 @@
 	import * as m from '$lib/paraglide/messages.js';
 
 	const internalLinks = [
-		{ href: '/admin/scrape', label: () => m.admin_nav_scrape() },
-		{ href: '/admin/audio', label: () => m.admin_nav_audio() },
-		{ href: '/admin/translation', label: () => m.admin_nav_translation() },
-		{ href: '/admin/changelog', label: () => m.admin_nav_changelog() },
-		{ href: '/admin/image-gen', label: () => m.admin_nav_image_gen() },
-		{ href: '/admin/text-gen', label: () => m.admin_nav_text_gen() },
-		{ href: '/admin/catalogue-tools', label: () => m.admin_nav_catalogue_tools() },
-		{ href: '/admin/ai-jobs', label: () => m.admin_nav_ai_jobs() }
+		{
+			href: '/admin/scrape',
+			label: () => m.admin_nav_scrape(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />`
+		},
+		{
+			href: '/admin/audio',
+			label: () => m.admin_nav_audio(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19V6l12-3v13M9 19c0 1.105-1.343 2-3 2s-3-.895-3-2 1.343-2 3-2 3 .895 3 2zm12-3c0 1.105-1.343 2-3 2s-3-.895-3-2 1.343-2 3-2 3 .895 3 2zM9 10l12-3" />`
+		},
+		{
+			href: '/admin/translation',
+			label: () => m.admin_nav_translation(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 5h12M9 3v2m1.048 9.5A18.022 18.022 0 016.412 9m6.088 9h7M11 21l5-10 5 10M12.751 5C11.783 10.77 8.07 15.61 3 18.129" />`
+		},
+		{
+			href: '/admin/import',
+			label: () => m.admin_nav_import(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />`
+		},
+		{
+			href: '/admin/image-gen',
+			label: () => m.admin_nav_image_gen(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z" />`
+		},
+		{
+			href: '/admin/text-gen',
+			label: () => m.admin_nav_text_gen(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />`
+		},
+		{
+			href: '/admin/ai-jobs',
+			label: () => m.admin_nav_ai_jobs(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4" />`
+		},
+		{
+			href: '/admin/notifications',
+			label: () => m.admin_nav_notifications(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" />`
+		},
+		{
+			href: '/admin/catalogue-tools',
+			label: () => m.admin_nav_catalogue_tools(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />`
+		},
+		{
+			href: '/admin/changelog',
+			label: () => m.admin_nav_changelog(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" /><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 4h10a2 2 0 012 2v12a2 2 0 01-2 2H7a2 2 0 01-2-2V6a2 2 0 012-2z" />`
+		}
 	];
 
 	const externalLinks = [
-		{ href: 'https://feedback.libnovel.cc', label: () => m.admin_nav_feedback() },
-		{ href: 'https://errors.libnovel.cc', label: () => m.admin_nav_errors() },
-		{ href: 'https://analytics.libnovel.cc', label: () => m.admin_nav_analytics() },
-		{ href: 'https://logs.libnovel.cc', label: () => m.admin_nav_logs() },
-		{ href: 'https://uptime.libnovel.cc', label: () => m.admin_nav_uptime() },
-		{ href: 'https://push.libnovel.cc', label: () => m.admin_nav_push() },
-		{ href: 'https://grafana.libnovel.cc', label: () => m.admin_nav_grafana() },
-		{ href: 'https://gitea.kalekber.cc/kamil/libnovel', label: () => m.admin_nav_gitea() }
+		{
+			href: 'https://feedback.libnovel.cc',
+			label: () => m.admin_nav_feedback(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 10h.01M12 10h.01M16 10h.01M9 16H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-5l-5 5v-5z" />`
+		},
+		{
+			href: 'https://errors.libnovel.cc',
+			label: () => m.admin_nav_errors(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />`
+		},
+		{
+			href: 'https://analytics.libnovel.cc',
+			label: () => m.admin_nav_analytics(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />`
+		},
+		{
+			href: 'https://logs.libnovel.cc',
+			label: () => m.admin_nav_logs(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 10h16M4 14h10" />`
+		},
+		{
+			href: 'https://grafana.libnovel.cc',
+			label: () => m.admin_nav_grafana(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M16 8v8m-4-5v5m-4-2v2m-2 4h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z" />`
+		},
+		{
+			href: 'https://uptime.libnovel.cc',
+			label: () => m.admin_nav_uptime(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />`
+		},
+		{
+			href: 'https://push.libnovel.cc',
+			label: () => m.admin_nav_push(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" />`
+		},
+		{
+			href: 'https://gitea.kalekber.cc/kamil/libnovel',
+			label: () => m.admin_nav_gitea(),
+			icon: `<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4" />`
+		}
 	];
 
 	interface Props {
@@ -45,44 +119,53 @@
 	<!-- Sidebar -->
 	<aside
 		class="
-			fixed top-0 left-0 h-full z-50 w-56 shrink-0 border-r border-(--color-border) px-3 py-6 flex flex-col gap-6
+			fixed top-0 left-0 h-full z-50 w-56 shrink-0 border-r border-(--color-border) px-2 py-5 flex flex-col gap-5
 			bg-(--color-surface) transition-transform duration-200
 			{sidebarOpen ? 'translate-x-0' : '-translate-x-full'}
-			md:relative md:translate-x-0 md:w-48 md:z-auto md:top-auto md:h-auto
+			md:relative md:translate-x-0 md:w-52 md:z-auto md:top-auto md:h-auto
 		"
 	>
 		<!-- Internal pages -->
 		<div>
-			<p class="px-2 mb-2 text-xs font-semibold text-(--color-muted) uppercase tracking-widest">{m.admin_pages_label()}</p>
+			<p class="px-3 mb-1.5 text-[10px] font-semibold text-(--color-muted) uppercase tracking-widest">{m.admin_pages_label()}</p>
 			<nav class="flex flex-col gap-0.5">
 				{#each internalLinks as link}
+					{@const active = page.url.pathname.startsWith(link.href)}
 					<a
 						href={link.href}
 						onclick={() => (sidebarOpen = false)}
-						class="px-2 py-1.5 rounded-md text-sm font-medium transition-colors
-							{page.url.pathname.startsWith(link.href)
+						class="px-3 py-1.5 rounded-md text-sm font-medium transition-colors flex items-center gap-2.5
+							{active
 								? 'bg-(--color-surface-2) text-(--color-text)'
 								: 'text-(--color-muted) hover:bg-(--color-surface-2)/60 hover:text-(--color-text)'}"
 					>
-					{link.label()}
+						<svg class="w-3.5 h-3.5 shrink-0 {active ? 'text-(--color-brand)' : 'opacity-50'}" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+							{@html link.icon}
+						</svg>
+						{link.label()}
 					</a>
 				{/each}
 			</nav>
 		</div>
 
+		<div class="border-t border-(--color-border)"></div>
+
 		<!-- External tools -->
 		<div>
-			<p class="px-2 mb-2 text-xs font-semibold text-(--color-muted) uppercase tracking-widest">{m.admin_tools_label()}</p>
+			<p class="px-3 mb-1.5 text-[10px] font-semibold text-(--color-muted) uppercase tracking-widest">{m.admin_tools_label()}</p>
 			<nav class="flex flex-col gap-0.5">
 				{#each externalLinks as link}
 					<a
 						href={link.href}
 						target="_blank"
 						rel="noopener noreferrer"
-						class="px-2 py-1.5 rounded-md text-sm font-medium text-(--color-muted) hover:bg-(--color-surface-2)/60 hover:text-(--color-text) transition-colors flex items-center justify-between"
+						class="px-3 py-1.5 rounded-md text-sm font-medium text-(--color-muted) hover:bg-(--color-surface-2)/60 hover:text-(--color-text) transition-colors flex items-center gap-2.5"
 					>
-						{link.label()}
-						<svg class="w-3 h-3 shrink-0 opacity-50" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<svg class="w-3.5 h-3.5 shrink-0 opacity-40" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+							{@html link.icon}
+						</svg>
+						<span class="flex-1">{link.label()}</span>
+						<svg class="w-2.5 h-2.5 shrink-0 opacity-30" fill="none" stroke="currentColor" viewBox="0 0 24 24">
 							<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
 								d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
 						</svg>

ui/src/routes/admin/ai-jobs/+page.server.ts

@@ -6,7 +6,8 @@ export type { AIJob };
 
 export const load: PageServerLoad = async () => {
 	// Parent layout already guards admin role.
-	const jobs = await listAIJobs().catch((e): AIJob[] => {
+	// Stream jobs so navigation is instant; list populates a moment later.
+	const jobs = listAIJobs().catch((e): AIJob[] => {
 		log.warn('admin/ai-jobs', 'failed to load ai jobs', { err: String(e) });
 		return [];
 	});

ui/src/routes/admin/ai-jobs/+page.svelte

@@ -1,17 +1,17 @@
 <script lang="ts">
-	import { untrack } from 'svelte';
 	import { invalidateAll } from '$app/navigation';
 	import type { PageData } from './$types';
 	import type { AIJob } from '$lib/server/pocketbase';
 	import { cn } from '$lib/utils';
+	import * as m from '$lib/paraglide/messages.js';
 
 	let { data }: { data: PageData } = $props();
 
-	let jobs = $state<AIJob[]>(untrack(() => data.jobs));
+	let jobs = $state<AIJob[]>([]);
 
-	// Keep in sync on server reloads
+	// Resolve streamed promise on load and on server reloads (invalidateAll)
 	$effect(() => {
-		jobs = data.jobs;
+		data.jobs.then((resolved) => { jobs = resolved; });
 	});
 
 	// ── Live-poll while any job is in-flight ─────────────────────────────────────
@@ -55,25 +55,25 @@
 	});
 
 	// ── Cancel ────────────────────────────────────────────────────────────────────
-	let cancellingId = $state<string | null>(null);
-	let cancelError = $state('');
+	let cancellingIds = $state(new Set<string>());
+	let cancelErrors: Record<string, string> = $state({});
 
 	async function cancelJob(id: string) {
-		if (cancellingId) return;
-		cancellingId = id;
-		cancelError = '';
+		if (cancellingIds.has(id)) return;
+		cancellingIds = new Set([...cancellingIds, id]);
+		delete cancelErrors[id];
 		try {
 			const res = await fetch(`/api/admin/ai-jobs/${id}/cancel`, { method: 'POST' });
 			if (!res.ok) {
 				const body = await res.json().catch(() => ({}));
-				cancelError = body.error ?? `Error ${res.status}`;
+				cancelErrors = { ...cancelErrors, [id]: body.error ?? `Error ${res.status}` };
 			} else {
-				await invalidateAll();
+				jobs = jobs.map((j) => j.id === id ? { ...j, status: 'cancelled' as AIJob['status'] } : j);
 			}
 		} catch {
-			cancelError = 'Network error.';
+			cancelErrors = { ...cancelErrors, [id]: 'Network error.' };
 		} finally {
-			cancellingId = null;
+			cancellingIds = new Set([...cancellingIds].filter((x) => x !== id));
 		}
 	}
 
@@ -85,7 +85,8 @@
 		new_title: string;
 	}
 
-	interface ReviewState {
+	interface ChapterNamesReview {
+		kind: 'chapter-names';
 		jobId: string;
 		slug: string;
 		pattern: string;
@@ -97,20 +98,62 @@
 		applyDone: boolean;
 	}
 
+	// ── Review (image-gen jobs) ───────────────────────────────────────────────────
+
+	interface ImageGenReview {
+		kind: 'image-gen';
+		jobId: string;
+		slug: string;
+		imageType: string;
+		chapter: number;
+		prompt: string;
+		imageSrc: string;
+		contentType: string;
+		bytes: number;
+		loading: boolean;
+		error: string;
+		saving: boolean;
+		saveError: string;
+		savedUrl: string;
+	}
+
+	// ── Review (description jobs) ─────────────────────────────────────────────────
+
+	interface DescriptionReview {
+		kind: 'description';
+		jobId: string;
+		slug: string;
+		instructions: string;
+		oldDescription: string;
+		newDescription: string;
+		loading: boolean;
+		error: string;
+		applying: boolean;
+		applyError: string;
+		applyDone: boolean;
+	}
+
+	type ReviewState = ChapterNamesReview | ImageGenReview | DescriptionReview;
+
 	let review = $state<ReviewState | null>(null);
 
+	// ── Open review ───────────────────────────────────────────────────────────────
+
 	async function openReview(job: AIJob) {
-		review = {
-			jobId: job.id,
-			slug: job.slug,
-			pattern: '',
-			titles: [],
-			loading: true,
-			error: '',
-			applying: false,
-			applyError: '',
-			applyDone: false
-		};
+		if (job.kind === 'chapter-names') {
+			const r: ChapterNamesReview = {
+				kind: 'chapter-names',
+				jobId: job.id,
+				slug: job.slug,
+				pattern: '',
+				titles: [],
+				loading: true,
+				error: '',
+				applying: false,
+				applyError: '',
+				applyDone: false
+			};
+			review = r;
 
 		try {
 			const res = await fetch(`/api/admin/ai-jobs/${job.id}`);
@@ -118,27 +161,118 @@
 			const data = await res.json();
 
 			let payload: { pattern?: string; slug?: string; results?: ProposedTitle[] } = {};
-			try {
-				payload = JSON.parse(data.payload ?? '{}');
-			} catch {
-				// ignore
-			}
+			try { payload = JSON.parse(data.payload ?? '{}'); } catch { /* ignore */ }
 
-			review.pattern = payload.pattern ?? '';
-			review.titles = (payload.results ?? []).map((t: ProposedTitle) => ({ ...t }));
-			review.loading = false;
+			review = {
+				...r,
+				pattern: payload.pattern ?? '',
+				titles: (payload.results ?? []).map((t: ProposedTitle) => ({ ...t })),
+				loading: false
+			};
 		} catch (e) {
-			review.loading = false;
-			review.error = String(e);
+			review = { ...r, loading: false, error: String(e) };
+		}
+	} else if (job.kind === 'image-gen') {
+			const r: ImageGenReview = {
+				kind: 'image-gen',
+				jobId: job.id,
+				slug: job.slug,
+				imageType: '',
+				chapter: 0,
+				prompt: '',
+				imageSrc: '',
+				contentType: 'image/png',
+				bytes: 0,
+				loading: true,
+				error: '',
+				saving: false,
+				saveError: '',
+				savedUrl: ''
+			};
+			review = r;
+
+		try {
+			const res = await fetch(`/api/admin/ai-jobs/${job.id}`);
+			if (!res.ok) throw new Error(`HTTP ${res.status}`);
+			const data = await res.json();
+
+			let payload: {
+				prompt?: string;
+				type?: string;
+				chapter?: number;
+				content_type?: string;
+				image_b64?: string;
+				bytes?: number;
+			} = {};
+			try { payload = JSON.parse(data.payload ?? '{}'); } catch { /* ignore */ }
+
+			if (!payload.image_b64) {
+				review = { ...r, error: 'No image in job payload.', loading: false };
+				return;
+			}
+			const contentType = payload.content_type ?? 'image/png';
+			review = {
+				...r,
+				imageType: payload.type ?? 'cover',
+				chapter: payload.chapter ?? 0,
+				prompt: payload.prompt ?? '',
+				contentType,
+				bytes: payload.bytes ?? 0,
+				imageSrc: `data:${contentType};base64,${payload.image_b64}`,
+				loading: false
+			};
+		} catch (e) {
+			review = { ...r, loading: false, error: String(e) };
+		}
+	} else if (job.kind === 'description') {
+			const r: DescriptionReview = {
+				kind: 'description',
+				jobId: job.id,
+				slug: job.slug,
+				instructions: '',
+				oldDescription: '',
+				newDescription: '',
+				loading: true,
+				error: '',
+				applying: false,
+				applyError: '',
+				applyDone: false
+			};
+			review = r;
+
+		try {
+			const res = await fetch(`/api/admin/ai-jobs/${job.id}`);
+			if (!res.ok) throw new Error(`HTTP ${res.status}`);
+			const data = await res.json();
+
+			let payload: {
+				instructions?: string;
+				old_description?: string;
+				new_description?: string;
+			} = {};
+			try { payload = JSON.parse(data.payload ?? '{}'); } catch { /* ignore */ }
+
+			review = {
+				...r,
+				instructions: payload.instructions ?? '',
+				oldDescription: payload.old_description ?? '',
+				newDescription: payload.new_description ?? '',
+				loading: false
+			};
+		} catch (e) {
+			review = { ...r, loading: false, error: String(e) };
 		}
 	}
+}
 
 	function closeReview() {
 		review = null;
 	}
 
-	async function applyReview() {
-		if (!review || review.applying) return;
+	// ── Apply chapter names ───────────────────────────────────────────────────────
+
+	async function applyChapterNames() {
+		if (review?.kind !== 'chapter-names' || review.applying) return;
 		review.applying = true;
 		review.applyError = '';
 		review.applyDone = false;
@@ -163,16 +297,97 @@
 		}
 	}
 
-	// ── Helpers ───────────────────────────────────────────────────────────────────
-	function statusColor(status: string) {
-		if (status === 'done') return 'text-green-400';
-		if (status === 'running') return 'text-(--color-brand) animate-pulse';
-		if (status === 'pending') return 'text-sky-400 animate-pulse';
-		if (status === 'failed') return 'text-(--color-danger)';
-		if (status === 'cancelled') return 'text-(--color-muted)';
-		return 'text-(--color-text)';
+	// ── Save image as cover ───────────────────────────────────────────────────────
+
+	async function saveImageAsCover() {
+		if (review?.kind !== 'image-gen' || review.saving) return;
+		review.saving = true;
+		review.saveError = '';
+
+		const b64 = review.imageSrc.split(',')[1];
+		try {
+			const res = await fetch('/api/admin/image-gen/save-cover', {
+				method: 'POST',
+				headers: { 'content-type': 'application/json' },
+				body: JSON.stringify({ slug: review.slug, image_b64: b64 })
+			});
+			const body = await res.json().catch(() => ({}));
+			if (!res.ok) {
+				review.saveError = body.error ?? `Error ${res.status}`;
+			} else {
+				review.savedUrl = body.cover_url ?? `/api/cover/novelfire.net/${review.slug}`;
+			}
+		} catch {
+			review.saveError = 'Network error.';
+		} finally {
+			review.saving = false;
+		}
 	}
 
+	// ── Save image as chapter illustration ───────────────────────────────────────
+
+	async function saveImageAsChapterImage() {
+		if (review?.kind !== 'image-gen' || review.saving) return;
+		review.saving = true;
+		review.saveError = '';
+
+		const b64 = review.imageSrc.split(',')[1];
+		try {
+			const res = await fetch('/api/admin/image-gen/save-chapter-image', {
+				method: 'POST',
+				headers: { 'content-type': 'application/json' },
+				body: JSON.stringify({ slug: review.slug, chapter: review.chapter, image_b64: b64 })
+			});
+			const body = await res.json().catch(() => ({}));
+			if (!res.ok) {
+				review.saveError = body.error ?? `Error ${res.status}`;
+			} else {
+				review.savedUrl = body.image_url ?? `/api/chapter-image/novelfire.net/${review.slug}/${review.chapter}`;
+			}
+		} catch {
+			review.saveError = 'Network error.';
+		} finally {
+			review.saving = false;
+		}
+	}
+
+	function downloadImage() {
+		if (review?.kind !== 'image-gen') return;
+		const a = document.createElement('a');
+		a.href = review.imageSrc;
+		const ext = review.contentType === 'image/jpeg' ? 'jpg' : 'png';
+		a.download = `${review.slug}-${review.imageType}.${ext}`;
+		a.click();
+	}
+
+	// ── Apply description ─────────────────────────────────────────────────────────
+
+	async function applyDescription() {
+		if (review?.kind !== 'description' || review.applying) return;
+		review.applying = true;
+		review.applyError = '';
+		review.applyDone = false;
+
+		try {
+			const res = await fetch('/api/admin/text-gen/description/apply', {
+				method: 'POST',
+				headers: { 'content-type': 'application/json' },
+				body: JSON.stringify({ slug: review.slug, description: review.newDescription })
+			});
+			if (!res.ok) {
+				const body = await res.json().catch(() => ({}));
+				review.applyError = body.error ?? `Error ${res.status}`;
+			} else {
+				review.applyDone = true;
+			}
+		} catch {
+			review.applyError = 'Network error.';
+		} finally {
+			review.applying = false;
+		}
+	}
+
+	// ── Helpers ───────────────────────────────────────────────────────────────────
 	function statusBg(status: string) {
 		if (status === 'done') return 'bg-green-400/10 text-green-400';
 		if (status === 'running') return 'bg-(--color-brand)/10 text-(--color-brand)';
@@ -185,6 +400,8 @@
 	function kindLabel(kind: string) {
 		const labels: Record<string, string> = {
 			'chapter-names': 'Chapter Names',
+			'image-gen': 'Image Gen',
+			'description': 'Description',
 			'batch-covers': 'Batch Covers',
 			'chapter-covers': 'Chapter Covers',
 			'refresh-metadata': 'Refresh Metadata'
@@ -216,14 +433,26 @@
 		if (!job.items_total) return null;
 		return Math.round((job.items_done / job.items_total) * 100);
 	}
+
+	function fmtBytes(b: number) {
+		if (b < 1024) return `${b} B`;
+		if (b < 1024 * 1024) return `${(b / 1024).toFixed(1)} KB`;
+		return `${(b / 1024 / 1024).toFixed(2)} MB`;
+	}
+
+	const REVIEWABLE_KINDS = new Set(['chapter-names', 'image-gen', 'description']);
 </script>
 
+<svelte:head>
+	<title>{m.admin_ai_jobs_page_title()}</title>
+</svelte:head>
+
 <div class="max-w-6xl mx-auto space-y-6">
 	<!-- Header -->
 	<div class="flex items-center justify-between gap-4">
 		<div>
-			<h1 class="text-2xl font-bold text-(--color-text)">AI Jobs</h1>
-			<p class="text-sm text-(--color-muted) mt-0.5">Background AI generation tasks</p>
+			<h1 class="text-2xl font-bold text-(--color-text)">{m.admin_ai_jobs_heading()}</h1>
+			<p class="text-sm text-(--color-muted) mt-0.5">{m.admin_ai_jobs_subheading()}</p>
 		</div>
 		<button
 			onclick={() => invalidateAll()}
@@ -278,11 +507,6 @@
 		</div>
 	</div>
 
-	<!-- Cancel error -->
-	{#if cancelError}
-		<p class="text-sm text-(--color-danger) bg-(--color-danger)/10 rounded-lg px-3 py-2">{cancelError}</p>
-	{/if}
-
 	<!-- Jobs table -->
 	{#if filteredJobs.length === 0}
 		<div class="rounded-lg border border-(--color-border) bg-(--color-surface-2) px-6 py-12 text-center">
@@ -291,7 +515,8 @@
 			</p>
 		</div>
 	{:else}
-		<div class="rounded-lg border border-(--color-border) overflow-hidden">
+		<!-- Desktop table -->
+		<div class="hidden sm:block rounded-lg border border-(--color-border) overflow-hidden">
 			<table class="w-full text-sm">
 				<thead>
 					<tr class="border-b border-(--color-border) bg-(--color-surface-2)">
@@ -320,19 +545,26 @@
 								{kindLabel(job.kind)}
 							</td>
 
-							<!-- Slug -->
-							<td class="px-4 py-3 max-w-[12rem]">
-								{#if job.slug}
+						<!-- Slug -->
+						<td class="px-4 py-3 max-w-[12rem]">
+							{#if job.slug}
+								<div class="flex flex-col gap-0.5">
 									<a
-										href="/admin/image-gen?slug={job.slug}"
+										href="/books/{job.slug}"
 										class="text-(--color-brand) hover:underline truncate block font-mono text-xs"
 									>
 										{job.slug}
 									</a>
-								{:else}
-									<span class="text-(--color-muted) text-xs">—</span>
-								{/if}
-							</td>
+									{#if job.kind === 'image-gen'}
+										<a href="/admin/image-gen?slug={job.slug}" class="text-[10px] text-(--color-muted) hover:text-(--color-text) transition-colors">↗ image editor</a>
+									{:else if job.kind === 'chapter-names' || job.kind === 'description'}
+										<a href="/admin/text-gen" class="text-[10px] text-(--color-muted) hover:text-(--color-text) transition-colors">↗ text editor</a>
+									{/if}
+								</div>
+							{:else}
+								<span class="text-(--color-muted) text-xs">—</span>
+							{/if}
+						</td>
 
 							<!-- Model -->
 							<td class="px-4 py-3 hidden sm:table-cell">
@@ -381,16 +613,16 @@
 							<!-- Actions -->
 							<td class="px-4 py-3 text-right">
 								<div class="flex items-center justify-end gap-2">
-									{#if job.status === 'pending' || job.status === 'running'}
+								{#if job.status === 'pending' || job.status === 'running'}
 										<button
 											onclick={() => cancelJob(job.id)}
-											disabled={cancellingId === job.id}
+											disabled={cancellingIds.has(job.id)}
 											class="px-2 py-1 rounded text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
 										>
-											{cancellingId === job.id ? 'Cancelling…' : 'Cancel'}
+											{cancellingIds.has(job.id) ? 'Cancelling…' : 'Cancel'}
 										</button>
 									{/if}
-									{#if job.kind === 'chapter-names' && job.status === 'done'}
+									{#if REVIEWABLE_KINDS.has(job.kind) && job.status === 'done'}
 										<button
 											onclick={() => openReview(job)}
 											class="px-2 py-1 rounded text-xs font-medium bg-green-400/10 text-green-400 hover:bg-green-400/20 transition-colors"
@@ -406,6 +638,11 @@
 											{job.error_message}
 										</span>
 									{/if}
+									{#if cancelErrors[job.id]}
+										<span class="text-xs text-(--color-danger)" title={cancelErrors[job.id]}>
+											{cancelErrors[job.id]}
+										</span>
+									{/if}
 								</div>
 							</td>
 						</tr>
@@ -413,13 +650,81 @@
 				</tbody>
 			</table>
 		</div>
+
+		<!-- Mobile cards -->
+		<div class="sm:hidden space-y-3">
+			{#each filteredJobs as job (job.id)}
+				<div class="bg-(--color-surface) rounded-xl border border-(--color-border) p-4 space-y-3">
+					<!-- Row 1: status + kind -->
+					<div class="flex items-center justify-between gap-2">
+						<span class={cn('inline-flex items-center px-2 py-0.5 rounded text-xs font-medium', statusBg(job.status))}>
+							{job.status}
+						</span>
+						<span class="text-sm font-medium text-(--color-text)">{kindLabel(job.kind)}</span>
+					</div>
+					<!-- Slug + links -->
+					{#if job.slug}
+						<div class="flex flex-col gap-0.5">
+							<a href="/books/{job.slug}" class="text-(--color-brand) hover:underline font-mono text-xs truncate">
+								{job.slug}
+							</a>
+							{#if job.kind === 'image-gen'}
+								<a href="/admin/image-gen?slug={job.slug}" class="text-[10px] text-(--color-muted) hover:text-(--color-text) transition-colors">↗ image editor</a>
+							{:else if job.kind === 'chapter-names' || job.kind === 'description'}
+								<a href="/admin/text-gen" class="text-[10px] text-(--color-muted) hover:text-(--color-text) transition-colors">↗ text editor</a>
+							{/if}
+						</div>
+					{/if}
+					<!-- Meta grid -->
+					<div class="grid grid-cols-2 gap-1 text-xs">
+						<span class="text-(--color-muted)">Model</span>
+						<span class="text-(--color-muted) font-mono text-right truncate" title={job.model}>{job.model || '—'}</span>
+						{#if job.items_total > 0}
+							<span class="text-(--color-muted)">Progress</span>
+							<span class="text-(--color-muted) text-right tabular-nums">{job.items_done}/{job.items_total}</span>
+						{/if}
+						<span class="text-(--color-muted)">Started</span>
+						<span class="text-(--color-muted) text-right">{fmtDate(job.started)}</span>
+						<span class="text-(--color-muted)">Duration</span>
+						<span class="text-(--color-muted) text-right tabular-nums">{duration(job.started, job.finished)}</span>
+					</div>
+					<!-- Actions -->
+					<div class="flex items-center gap-2 flex-wrap">
+						{#if job.status === 'pending' || job.status === 'running'}
+							<button
+								onclick={() => cancelJob(job.id)}
+								disabled={cancellingIds.has(job.id)}
+								class="px-2.5 py-1 rounded text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
+							>
+								{cancellingIds.has(job.id) ? 'Cancelling…' : 'Cancel'}
+							</button>
+						{/if}
+						{#if REVIEWABLE_KINDS.has(job.kind) && job.status === 'done'}
+							<button
+								onclick={() => openReview(job)}
+								class="px-2.5 py-1 rounded text-xs font-medium bg-green-400/10 text-green-400 hover:bg-green-400/20 transition-colors"
+							>
+								Review
+							</button>
+						{/if}
+					</div>
+					{#if job.error_message}
+						<p class="text-xs text-(--color-danger) font-mono break-all">{job.error_message}</p>
+					{/if}
+					{#if cancelErrors[job.id]}
+						<p class="text-xs text-(--color-danger)">{cancelErrors[job.id]}</p>
+					{/if}
+				</div>
+			{/each}
+		</div>
+
 		<p class="text-xs text-(--color-muted)">
 			Showing {filteredJobs.length} of {jobs.length} jobs
 		</p>
 	{/if}
 </div>
 
-<!-- ── Review & Apply panel ──────────────────────────────────────────────────── -->
+<!-- ── Review panel (shared backdrop + modal shell) ─────────────────────────── -->
 {#if review}
 	<!-- Backdrop -->
 	<div
@@ -428,102 +733,249 @@
 		role="presentation"
 	></div>
 
-	<!-- Panel -->
-	<div class="fixed inset-x-0 bottom-0 z-50 max-h-[85vh] overflow-hidden flex flex-col rounded-t-2xl bg-(--color-surface) border-t border-(--color-border) shadow-2xl sm:inset-auto sm:top-1/2 sm:left-1/2 sm:-translate-x-1/2 sm:-translate-y-1/2 sm:w-[min(900px,95vw)] sm:max-h-[85vh] sm:rounded-xl sm:border sm:shadow-2xl">
-		<!-- Panel header -->
-		<div class="flex items-center justify-between gap-4 px-5 py-4 border-b border-(--color-border) shrink-0">
-			<div>
-				<h2 class="text-base font-semibold text-(--color-text)">Review Chapter Names</h2>
-				<p class="text-xs text-(--color-muted) mt-0.5">
-					<span class="font-mono">{review.slug}</span>
-					{#if review.pattern}
-						· pattern: <span class="font-mono">{review.pattern}</span>
-					{/if}
-				</p>
-			</div>
-			<button
-				onclick={closeReview}
-				class="p-1.5 rounded-md text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
-				aria-label="Close"
-			>
-				<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-					<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
-				</svg>
-			</button>
-		</div>
+	<!-- Modal -->
+	<div class="fixed inset-x-0 bottom-0 z-50 max-h-[90vh] overflow-hidden flex flex-col rounded-t-2xl bg-(--color-surface) border-t border-(--color-border) shadow-2xl sm:inset-auto sm:top-1/2 sm:left-1/2 sm:-translate-x-1/2 sm:-translate-y-1/2 sm:w-[min(960px,95vw)] sm:max-h-[88vh] sm:rounded-xl sm:border sm:shadow-2xl">
 
-		<!-- Body -->
-		<div class="flex-1 overflow-y-auto">
-			{#if review.loading}
-				<div class="flex items-center justify-center py-16 text-(--color-muted) text-sm">
-					Loading results…
+		<!-- ── Chapter names review ─────────────────────────────────────────────── -->
+		{#if review.kind === 'chapter-names'}
+			<!-- Header -->
+			<div class="flex items-center justify-between gap-4 px-5 py-4 border-b border-(--color-border) shrink-0">
+				<div>
+					<h2 class="text-base font-semibold text-(--color-text)">Review Chapter Names</h2>
+					<p class="text-xs text-(--color-muted) mt-0.5">
+						<span class="font-mono">{review.slug}</span>
+						{#if review.pattern}
+							· pattern: <span class="font-mono">{review.pattern}</span>
+						{/if}
+					</p>
 				</div>
-			{:else if review.error}
-				<div class="px-5 py-8 text-center">
-					<p class="text-(--color-danger) text-sm">{review.error}</p>
-				</div>
-			{:else if review.titles.length === 0}
-				<div class="px-5 py-8 text-center">
-					<p class="text-(--color-muted) text-sm">No results found in this job's payload.</p>
-				</div>
-			{:else}
-				<table class="w-full text-sm">
-					<thead class="sticky top-0 bg-(--color-surface) border-b border-(--color-border)">
-						<tr>
-							<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider w-16">#</th>
-							<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider w-1/2">Old Title</th>
-							<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider">New Title (editable)</th>
-						</tr>
-					</thead>
-					<tbody class="divide-y divide-(--color-border)">
-						{#each review.titles as title (title.number)}
-							<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/40 transition-colors">
-								<td class="px-4 py-2 text-xs text-(--color-muted) tabular-nums">{title.number}</td>
-								<td class="px-4 py-2 text-xs text-(--color-muted) max-w-0">
-									<span class="block truncate" title={title.old_title}>{title.old_title || '—'}</span>
-								</td>
-								<td class="px-4 py-2">
-									<input
-										type="text"
-										bind:value={title.new_title}
-										class="w-full px-2 py-1 rounded bg-(--color-surface-2) border border-(--color-border) text-xs text-(--color-text) focus:outline-none focus:ring-1 focus:ring-(--color-brand)"
-									/>
-								</td>
+				<button onclick={closeReview} class="p-1.5 rounded-md text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors" aria-label="Close">
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+					</svg>
+				</button>
+			</div>
+
+			<!-- Body -->
+			<div class="flex-1 overflow-y-auto">
+				{#if review.loading}
+					<div class="flex items-center justify-center py-16 text-(--color-muted) text-sm">Loading results…</div>
+				{:else if review.error}
+					<div class="px-5 py-8 text-center"><p class="text-(--color-danger) text-sm">{review.error}</p></div>
+				{:else if review.titles.length === 0}
+					<div class="px-5 py-8 text-center"><p class="text-(--color-muted) text-sm">No results found in this job's payload.</p></div>
+				{:else}
+					<table class="w-full text-sm">
+						<thead class="sticky top-0 bg-(--color-surface) border-b border-(--color-border)">
+							<tr>
+								<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider w-16">#</th>
+								<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider w-1/2">Old Title</th>
+								<th class="px-4 py-2.5 text-left text-xs font-semibold text-(--color-muted) uppercase tracking-wider">New Title (editable)</th>
 							</tr>
-						{/each}
-					</tbody>
-				</table>
+						</thead>
+						<tbody class="divide-y divide-(--color-border)">
+							{#each review.titles as title (title.number)}
+								<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/40 transition-colors">
+									<td class="px-4 py-2 text-xs text-(--color-muted) tabular-nums">{title.number}</td>
+									<td class="px-4 py-2 text-xs text-(--color-muted) max-w-0">
+										<span class="block truncate" title={title.old_title}>{title.old_title || '—'}</span>
+									</td>
+									<td class="px-4 py-2">
+										<input
+											type="text"
+											bind:value={title.new_title}
+											class="w-full px-2 py-1 rounded bg-(--color-surface-2) border border-(--color-border) text-xs text-(--color-text) focus:outline-none focus:ring-1 focus:ring-(--color-brand)"
+										/>
+									</td>
+								</tr>
+							{/each}
+						</tbody>
+					</table>
+				{/if}
+			</div>
+
+			<!-- Footer -->
+			{#if !review.loading && !review.error && review.titles.length > 0}
+				<div class="px-5 py-4 border-t border-(--color-border) shrink-0 flex items-center justify-between gap-4">
+					<div class="text-xs text-(--color-muted)">{review.titles.length} chapters</div>
+					<div class="flex items-center gap-3">
+						{#if review.applyError}<p class="text-xs text-(--color-danger)">{review.applyError}</p>{/if}
+						{#if review.applyDone}<p class="text-xs text-green-400">Applied successfully.</p>{/if}
+						<button onclick={closeReview} class="px-3 py-1.5 rounded-md text-sm text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors">Close</button>
+						<button
+							onclick={applyChapterNames}
+							disabled={review.applying || review.applyDone}
+							class="px-4 py-1.5 rounded-md text-sm font-medium bg-(--color-brand) text-black hover:bg-amber-300 disabled:opacity-50 transition-colors"
+						>
+							{review.applying ? 'Applying…' : review.applyDone ? 'Applied' : 'Apply All'}
+						</button>
+					</div>
+				</div>
 			{/if}
-		</div>
+
+		<!-- ── Image-gen review ─────────────────────────────────────────────────── -->
+		{:else if review.kind === 'image-gen'}
+			<!-- Header -->
+			<div class="flex items-center justify-between gap-4 px-5 py-4 border-b border-(--color-border) shrink-0">
+				<div>
+					<h2 class="text-base font-semibold text-(--color-text)">Review Generated Image</h2>
+					<p class="text-xs text-(--color-muted) mt-0.5">
+						<span class="font-mono">{review.slug}</span>
+						{#if review.imageType} · {review.imageType}{/if}
+					</p>
+				</div>
+				<button onclick={closeReview} class="p-1.5 rounded-md text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors" aria-label="Close">
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+					</svg>
+				</button>
+			</div>
+
+			<!-- Body -->
+			<div class="flex-1 overflow-y-auto p-5">
+				{#if review.loading}
+					<div class="flex items-center justify-center py-16 text-(--color-muted) text-sm">Loading image…</div>
+				{:else if review.error}
+					<div class="text-center py-8"><p class="text-(--color-danger) text-sm">{review.error}</p></div>
+				{:else if review.imageSrc}
+					<div class="flex flex-col sm:flex-row gap-5 items-start">
+						<!-- Image -->
+						<div class="flex-shrink-0 w-full sm:w-64">
+							<img
+								src={review.imageSrc}
+								alt="Generated"
+								class="w-full rounded-lg border border-(--color-border) object-contain max-h-80 bg-zinc-950"
+							/>
+						</div>
+						<!-- Meta -->
+						<div class="flex-1 space-y-3 text-sm">
+							{#if review.prompt}
+								<div>
+									<p class="text-xs text-(--color-muted) mb-1">Prompt</p>
+									<p class="text-(--color-text) leading-relaxed">{review.prompt}</p>
+								</div>
+							{/if}
+							{#if review.bytes > 0}
+								<div>
+									<p class="text-xs text-(--color-muted)">Size</p>
+									<p class="text-(--color-text)">{fmtBytes(review.bytes)}</p>
+								</div>
+							{/if}
+						{#if review.savedUrl}
+							<p class="text-xs text-green-400">
+								Saved →
+								<a href={review.savedUrl} target="_blank" rel="noopener noreferrer" class="underline hover:text-green-300">{review.savedUrl}</a>
+							</p>
+						{/if}
+						</div>
+					</div>
+				{/if}
+			</div>
 
 		<!-- Footer -->
-		{#if !review.loading && !review.error && review.titles.length > 0}
-			<div class="px-5 py-4 border-t border-(--color-border) shrink-0 flex items-center justify-between gap-4">
-				<div class="text-xs text-(--color-muted)">
-					{review.titles.length} chapters
-				</div>
+		{#if !review.loading && !review.error && review.imageSrc}
+			<div class="px-5 py-4 border-t border-(--color-border) shrink-0 flex items-center justify-between gap-4 flex-wrap">
+				<button onclick={closeReview} class="px-3 py-1.5 rounded-md text-sm text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors">Discard</button>
 				<div class="flex items-center gap-3">
-					{#if review.applyError}
-						<p class="text-xs text-(--color-danger)">{review.applyError}</p>
-					{/if}
-					{#if review.applyDone}
-						<p class="text-xs text-green-400">Applied successfully.</p>
-					{/if}
 					<button
-						onclick={closeReview}
-						class="px-3 py-1.5 rounded-md text-sm text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors"
+						onclick={downloadImage}
+						class="px-3 py-1.5 rounded-md text-sm bg-(--color-surface-3) text-(--color-text) hover:bg-zinc-600 transition-colors"
 					>
-						Close
-					</button>
-					<button
-						onclick={applyReview}
-						disabled={review.applying || review.applyDone}
-						class="px-4 py-1.5 rounded-md text-sm font-medium bg-(--color-brand) text-black hover:bg-amber-300 disabled:opacity-50 transition-colors"
-					>
-						{review.applying ? 'Applying…' : review.applyDone ? 'Applied' : 'Apply All'}
+						Download
 					</button>
+					{#if review.savedUrl}
+						<span class="text-sm text-green-400 font-medium">Saved ✓</span>
+					{:else if review.imageType === 'cover'}
+						<button
+							onclick={saveImageAsCover}
+							disabled={review.saving}
+							class="px-4 py-1.5 rounded-md text-sm font-medium bg-(--color-brand) text-black hover:bg-amber-300 disabled:opacity-50 transition-colors"
+						>
+							{review.saving ? 'Saving…' : 'Save as cover'}
+						</button>
+					{:else if review.imageType === 'chapter' && review.chapter > 0}
+						<button
+							onclick={saveImageAsChapterImage}
+							disabled={review.saving}
+							class="px-4 py-1.5 rounded-md text-sm font-medium bg-(--color-brand) text-black hover:bg-amber-300 disabled:opacity-50 transition-colors"
+						>
+							{review.saving ? 'Saving…' : `Save as chapter ${review.chapter} image`}
+						</button>
+					{/if}
+					{#if review.saveError}
+						<p class="text-xs text-(--color-danger)">{review.saveError}</p>
+					{/if}
 				</div>
 			</div>
 		{/if}
+
+		<!-- ── Description review ──────────────────────────────────────────────── -->
+		{:else if review.kind === 'description'}
+			<!-- Header -->
+			<div class="flex items-center justify-between gap-4 px-5 py-4 border-b border-(--color-border) shrink-0">
+				<div>
+					<h2 class="text-base font-semibold text-(--color-text)">Review Description</h2>
+					<p class="text-xs text-(--color-muted) mt-0.5">
+						<span class="font-mono">{review.slug}</span>
+					</p>
+				</div>
+				<button onclick={closeReview} class="p-1.5 rounded-md text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors" aria-label="Close">
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+					</svg>
+				</button>
+			</div>
+
+			<!-- Body -->
+			<div class="flex-1 overflow-y-auto p-5 space-y-5">
+				{#if review.loading}
+					<div class="flex items-center justify-center py-16 text-(--color-muted) text-sm">Loading…</div>
+				{:else if review.error}
+					<div class="text-center py-8"><p class="text-(--color-danger) text-sm">{review.error}</p></div>
+				{:else}
+					<!-- Old description -->
+					<div class="space-y-1">
+						<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-wide">Current description</p>
+						<p class="text-sm text-(--color-muted) leading-relaxed bg-(--color-surface-2) rounded-lg px-4 py-3 border border-(--color-border)">
+							{review.oldDescription || '—'}
+						</p>
+					</div>
+
+					<!-- New description (editable) -->
+					<div class="space-y-1">
+						<p class="text-xs font-semibold text-(--color-text) uppercase tracking-wide">Proposed description <span class="normal-case font-normal text-(--color-muted)">(editable)</span></p>
+						<textarea
+							bind:value={review.newDescription}
+							rows="6"
+							class="w-full px-4 py-3 rounded-lg bg-(--color-surface-2) border border-(--color-brand)/50 text-sm text-(--color-text) leading-relaxed resize-y focus:outline-none focus:ring-1 focus:ring-(--color-brand)"
+						></textarea>
+					</div>
+
+					{#if review.instructions}
+						<p class="text-xs text-(--color-muted)">
+							<span class="font-medium text-(--color-text)">Instructions:</span> {review.instructions}
+						</p>
+					{/if}
+				{/if}
+			</div>
+
+			<!-- Footer -->
+			{#if !review.loading && !review.error}
+				<div class="px-5 py-4 border-t border-(--color-border) shrink-0 flex items-center justify-between gap-4">
+					<button onclick={closeReview} class="px-3 py-1.5 rounded-md text-sm text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors">Discard</button>
+					<div class="flex items-center gap-3">
+						{#if review.applyError}<p class="text-xs text-(--color-danger)">{review.applyError}</p>{/if}
+						{#if review.applyDone}<p class="text-xs text-green-400">Applied successfully.</p>{/if}
+						<button
+							onclick={applyDescription}
+							disabled={review.applying || review.applyDone || !review.newDescription.trim()}
+							class="px-4 py-1.5 rounded-md text-sm font-medium bg-(--color-brand) text-black hover:bg-amber-300 disabled:opacity-50 transition-colors"
+						>
+							{review.applying ? 'Applying…' : review.applyDone ? 'Applied' : 'Apply'}
+						</button>
+					</div>
+				</div>
+			{/if}
+		{/if}
 	</div>
 {/if}

ui/src/routes/admin/audio/+page.server.ts

@@ -1,6 +1,6 @@
 import { redirect } from '@sveltejs/kit';
 import type { PageServerLoad } from './$types';
-import { listAudioCache, listAudioJobs, type AudioCacheEntry, type AudioJob } from '$lib/server/pocketbase';
+import { listAudioJobs, type AudioCacheEntry, type AudioJob } from '$lib/server/pocketbase';
 import { log } from '$lib/server/logger';
 
 export const load: PageServerLoad = async ({ locals }) => {
@@ -8,16 +8,20 @@ export const load: PageServerLoad = async ({ locals }) => {
 		redirect(302, '/');
 	}
 
-	const [entries, jobs] = await Promise.all([
-		listAudioCache().catch((e): AudioCacheEntry[] => {
-			log.warn('admin/audio', 'failed to load audio cache', { err: String(e) });
-			return [];
-		}),
-		listAudioJobs().catch((e): AudioJob[] => {
-			log.warn('admin/audio', 'failed to load audio jobs', { err: String(e) });
-			return [];
-		})
-	]);
+	const jobs = await listAudioJobs().catch((e): AudioJob[] => {
+		log.warn('admin/audio', 'failed to load audio jobs', { err: String(e) });
+		return [];
+	});
+
+	// Derive cache entries from done jobs — no second query needed.
+	const entries: AudioCacheEntry[] = jobs
+		.filter((j) => j.status === 'done')
+		.map((j) => ({
+			id: j.id,
+			cache_key: j.cache_key,
+			filename: `${j.cache_key}.mp3`,
+			updated: j.finished
+		}));
 
 	return { entries, jobs };
 };

ui/src/routes/admin/audio/+page.svelte

@@ -1,6 +1,5 @@
 <script lang="ts">
 	import { untrack } from 'svelte';
-	import { invalidateAll } from '$app/navigation';
 	import type { PageData } from './$types';
 	import type { AudioJob, AudioCacheEntry } from '$lib/server/pocketbase';
 	import * as m from '$lib/paraglide/messages.js';
@@ -21,8 +20,17 @@
 
 	$effect(() => {
 		if (!hasInFlight) return;
-		const id = setInterval(() => {
-			invalidateAll();
+		const id = setInterval(async () => {
+			const res = await fetch('/api/admin/audio-jobs').catch(() => null);
+			if (res?.ok) {
+				const body = await res.json().catch(() => null);
+				if (body?.jobs) {
+					jobs = body.jobs;
+					entries = (body.jobs as AudioJob[])
+						.filter((j) => j.status === 'done')
+						.map((j) => ({ id: j.id, cache_key: j.cache_key, filename: `${j.cache_key}.mp3`, updated: j.finished }));
+				}
+			}
 		}, 3000);
 		return () => clearInterval(id);
 	});
@@ -65,24 +73,81 @@
 
 	// ── Audio jobs stats + filter ────────────────────────────────────────────────
 	let jobsQ = $state('');
+	let jobsStatusFilter = $state('all');
+	const JOB_STATUS_OPTIONS = ['all', 'generating', 'pending', 'done', 'failed'] as const;
+
 	let filteredJobs = $derived(
-		jobsQ.trim()
-			? jobs.filter(
-					(j) =>
-						j.slug.toLowerCase().includes(jobsQ.toLowerCase().trim()) ||
-						j.voice.toLowerCase().includes(jobsQ.toLowerCase().trim()) ||
-						j.status.toLowerCase().includes(jobsQ.toLowerCase().trim())
-				)
-			: jobs
+		jobs.filter((j: AudioJob) => {
+			const qLower = jobsQ.trim().toLowerCase();
+			const matchesQ =
+				!qLower ||
+				j.slug.toLowerCase().includes(qLower) ||
+				j.voice.toLowerCase().includes(qLower) ||
+				j.status.toLowerCase().includes(qLower);
+			const matchesStatus = jobsStatusFilter === 'all' || j.status === jobsStatusFilter;
+			return matchesQ && matchesStatus;
+		})
 	);
 
 	let stats = $derived({
 		total: jobs.length,
-		done: jobs.filter((j) => j.status === 'done').length,
-		failed: jobs.filter((j) => j.status === 'failed').length,
-		inFlight: jobs.filter((j) => j.status === 'pending' || j.status === 'generating').length
+		done: jobs.filter((j: AudioJob) => j.status === 'done').length,
+		failed: jobs.filter((j: AudioJob) => j.status === 'failed').length,
+		pending: jobs.filter((j: AudioJob) => j.status === 'pending').length,
+		generating: jobs.filter((j: AudioJob) => j.status === 'generating').length,
+		inFlight: jobs.filter((j: AudioJob) => j.status === 'pending' || j.status === 'generating').length
 	});
 
+	// ── Cancel single job ────────────────────────────────────────────────────────
+	let cancellingJobIds = $state(new Set<string>());
+	let cancelJobErrors: Record<string, string> = $state({});
+
+	async function cancelJob(id: string) {
+		if (cancellingJobIds.has(id)) return;
+		cancellingJobIds = new Set([...cancellingJobIds, id]);
+		delete cancelJobErrors[id];
+		try {
+			const res = await fetch(`/api/admin/ai-jobs/${encodeURIComponent(id)}/cancel`, { method: 'POST' });
+			if (!res.ok) {
+				const body = await res.json().catch(() => ({}));
+				cancelJobErrors = { ...cancelJobErrors, [id]: body.error ?? `Error ${res.status}` };
+			} else {
+				jobs = jobs.map((j: AudioJob) => j.id === id ? { ...j, status: 'cancelled' } : j);
+			}
+		} catch {
+			cancelJobErrors = { ...cancelJobErrors, [id]: 'Network error.' };
+		} finally {
+			cancellingJobIds = new Set([...cancellingJobIds].filter((x) => x !== id));
+		}
+	}
+
+	// ── Retry failed job ─────────────────────────────────────────────────────────
+	let retryingJobIds = $state(new Set<string>());
+	let retryJobErrors: Record<string, string> = $state({});
+
+	async function retryJob(job: AudioJob) {
+		if (retryingJobIds.has(job.id)) return;
+		retryingJobIds = new Set([...retryingJobIds, job.id]);
+		delete retryJobErrors[job.id];
+		try {
+			const res = await fetch('/api/admin/audio/bulk', {
+				method: 'POST',
+				headers: { 'content-type': 'application/json' },
+				body: JSON.stringify({ slug: job.slug, voice: job.voice, from: job.chapter, to: job.chapter, force: true })
+			});
+			if (!res.ok) {
+				const body = await res.json().catch(() => ({}));
+				retryJobErrors = { ...retryJobErrors, [job.id]: body.error ?? `Error ${res.status}` };
+			} else {
+				jobs = jobs.map((j: AudioJob) => j.id === job.id ? { ...j, status: 'pending', error_message: '' } : j);
+			}
+		} catch {
+			retryJobErrors = { ...retryJobErrors, [job.id]: 'Network error.' };
+		} finally {
+			retryingJobIds = new Set([...retryingJobIds].filter((x) => x !== job.id));
+		}
+	}
+
 	// ── Audio cache filter ───────────────────────────────────────────────────────
 	function parseCacheKey(key: string) {
 		const parts = key.split('/');
@@ -146,12 +211,29 @@
 
 	<!-- ── Audio Jobs tab ─────────────────────────────────────────────────────── -->
 	{#if activeTab === 'jobs'}
-		<input
-			type="search"
-			bind:value={jobsQ}
-			placeholder={m.admin_audio_filter_jobs()}
-			class="w-full max-w-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg px-3 py-2 text-(--color-text) text-sm placeholder-zinc-500 focus:outline-none focus:ring-2 focus:ring-(--color-brand)"
-		/>
+		<div class="flex flex-wrap gap-3 items-center">
+			<input
+				type="search"
+				bind:value={jobsQ}
+				placeholder={m.admin_audio_filter_jobs()}
+				class="flex-1 min-w-48 max-w-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg px-3 py-2 text-(--color-text) text-sm placeholder-zinc-500 focus:outline-none focus:ring-2 focus:ring-(--color-brand)"
+			/>
+			<!-- Status pills -->
+			<div class="flex gap-1 flex-wrap">
+				{#each JOB_STATUS_OPTIONS as s}
+					{@const count = s === 'all' ? stats.total : (s === 'generating' ? stats.generating : s === 'pending' ? stats.pending : s === 'done' ? stats.done : stats.failed)}
+					<button
+						onclick={() => (jobsStatusFilter = s)}
+						class="px-2.5 py-1 rounded-md text-xs font-medium transition-colors capitalize
+							{jobsStatusFilter === s
+								? 'bg-(--color-brand) text-black'
+								: 'bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'}"
+					>
+						{s}{count > 0 ? ` ${count}` : ''}
+					</button>
+				{/each}
+			</div>
+		</div>
 
 		{#if filteredJobs.length === 0}
 			<p class="text-(--color-muted) text-sm py-8 text-center">
@@ -161,65 +243,116 @@
 			<!-- Desktop table -->
 			<div class="hidden sm:block overflow-x-auto rounded-xl border border-(--color-border)">
 				<table class="w-full text-sm">
-					<thead class="bg-(--color-surface-2) text-(--color-muted) text-xs uppercase tracking-wide">
-						<tr>
-							<th class="px-4 py-3 text-left">Book</th>
-							<th class="px-4 py-3 text-right">Ch.</th>
-							<th class="px-4 py-3 text-left">Voice</th>
-							<th class="px-4 py-3 text-left">Engine</th>
-							<th class="px-4 py-3 text-left">Status</th>
-							<th class="px-4 py-3 text-left">Started</th>
-							<th class="px-4 py-3 text-left">Duration</th>
-						</tr>
-					</thead>
-					<tbody class="divide-y divide-(--color-border)/50">
-						{#each filteredJobs as job}
-							<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/50 transition-colors">
-								<td class="px-4 py-3 text-(--color-text) font-medium">
-									<a href="/books/{job.slug}" class="hover:text-(--color-brand) transition-colors">{job.slug}</a>
-								</td>
-								<td class="px-4 py-3 text-right text-(--color-muted)">{job.chapter}</td>
-								<td class="px-4 py-3 text-(--color-muted) font-mono text-xs">{job.voice}</td>
-								<td class="px-4 py-3 text-(--color-muted) text-xs">{engineLabel(job.voice)}</td>
-								<td class="px-4 py-3">
-									<span class="font-medium {jobStatusColor(job.status)}">{job.status}</span>
-								</td>
-								<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{fmtDate(job.started)}</td>
-								<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{duration(job.started, job.finished)}</td>
-							</tr>
-							{#if job.error_message}
-								<tr class="bg-(--color-danger)/10">
-									<td colspan="7" class="px-4 py-2 text-xs text-(--color-danger) font-mono">{job.error_message}</td>
-								</tr>
+				<thead class="bg-(--color-surface-2) text-(--color-muted) text-xs uppercase tracking-wide">
+					<tr>
+						<th class="px-4 py-3 text-left">Book</th>
+						<th class="px-4 py-3 text-right">Ch.</th>
+						<th class="px-4 py-3 text-left">Voice</th>
+						<th class="px-4 py-3 text-left">Engine</th>
+						<th class="px-4 py-3 text-left">Status</th>
+						<th class="px-4 py-3 text-left">Started</th>
+						<th class="px-4 py-3 text-left">Duration</th>
+						<th class="px-4 py-3 text-left">Actions</th>
+					</tr>
+				</thead>
+				<tbody class="divide-y divide-(--color-border)/50">
+					{#each filteredJobs as job}
+						<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/50 transition-colors">
+							<td class="px-4 py-3 text-(--color-text) font-medium">
+								<a href="/books/{job.slug}" class="hover:text-(--color-brand) transition-colors">{job.slug}</a>
+							</td>
+							<td class="px-4 py-3 text-right text-(--color-muted)">{job.chapter}</td>
+							<td class="px-4 py-3 text-(--color-muted) font-mono text-xs">{job.voice}</td>
+							<td class="px-4 py-3 text-(--color-muted) text-xs">{engineLabel(job.voice)}</td>
+							<td class="px-4 py-3">
+								<span class="font-medium {jobStatusColor(job.status)}">{job.status}</span>
+							</td>
+							<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{fmtDate(job.started)}</td>
+							<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{duration(job.started, job.finished)}</td>
+						<td class="px-4 py-3">
+							{#if job.status === 'pending' || job.status === 'generating'}
+								<button
+									onclick={() => cancelJob(job.id)}
+									disabled={cancellingJobIds.has(job.id)}
+									class="px-2 py-1 rounded text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
+								>
+									{cancellingJobIds.has(job.id) ? 'Cancelling…' : 'Cancel'}
+								</button>
 							{/if}
-						{/each}
-					</tbody>
+							{#if job.status === 'failed'}
+								<button
+									onclick={() => retryJob(job)}
+									disabled={retryingJobIds.has(job.id)}
+									class="px-2 py-1 rounded text-xs font-medium bg-sky-400/10 text-sky-400 hover:bg-sky-400/20 disabled:opacity-50 transition-colors"
+								>
+									{retryingJobIds.has(job.id) ? 'Retrying…' : 'Retry ↺'}
+								</button>
+							{/if}
+							{#if cancelJobErrors[job.id]}
+								<p class="text-xs text-(--color-danger) mt-1">{cancelJobErrors[job.id]}</p>
+							{/if}
+							{#if retryJobErrors[job.id]}
+								<p class="text-xs text-(--color-danger) mt-1">{retryJobErrors[job.id]}</p>
+							{/if}
+						</td>
+						</tr>
+						{#if job.error_message}
+							<tr class="bg-(--color-danger)/10">
+								<td colspan="8" class="px-4 py-2 text-xs text-(--color-danger) font-mono">{job.error_message}</td>
+							</tr>
+						{/if}
+					{/each}
+				</tbody>
 				</table>
 			</div>
 
-			<!-- Mobile cards -->
-			<div class="sm:hidden space-y-3">
-				{#each filteredJobs as job}
-					<div class="bg-(--color-surface) rounded-xl border border-(--color-border) p-4 space-y-2">
-						<div class="flex items-start justify-between gap-2">
-							<a href="/books/{job.slug}" class="text-(--color-text) font-medium hover:text-(--color-brand) transition-colors truncate">
-								{job.slug}
-							</a>
-							<span class="shrink-0 text-xs font-semibold {jobStatusColor(job.status)}">{job.status}</span>
-						</div>
-						<div class="grid grid-cols-2 gap-1 text-xs">
-							<span class="text-(--color-muted)">Chapter</span><span class="text-(--color-muted) text-right">{job.chapter}</span>
-							<span class="text-(--color-muted)">Voice</span><span class="text-(--color-muted) font-mono text-right truncate">{job.voice}</span>
-							<span class="text-(--color-muted)">Engine</span><span class="text-(--color-muted) text-right">{engineLabel(job.voice)}</span>
-							<span class="text-(--color-muted)">Started</span><span class="text-(--color-muted) text-right">{fmtDate(job.started)}</span>
-							<span class="text-(--color-muted)">Duration</span><span class="text-(--color-muted) text-right">{duration(job.started, job.finished)}</span>
-						</div>
-						{#if job.error_message}
-							<p class="text-xs text-(--color-danger) font-mono break-all">{job.error_message}</p>
-						{/if}
+		<!-- Mobile cards -->
+		<div class="sm:hidden space-y-3">
+			{#each filteredJobs as job}
+				<div class="bg-(--color-surface) rounded-xl border border-(--color-border) p-4 space-y-2">
+					<div class="flex items-start justify-between gap-2">
+						<a href="/books/{job.slug}" class="text-(--color-text) font-medium hover:text-(--color-brand) transition-colors truncate">
+							{job.slug}
+						</a>
+						<span class="shrink-0 text-xs font-semibold {jobStatusColor(job.status)}">{job.status}</span>
 					</div>
-				{/each}
-			</div>
+					<div class="grid grid-cols-2 gap-1 text-xs">
+						<span class="text-(--color-muted)">Chapter</span><span class="text-(--color-muted) text-right">{job.chapter}</span>
+						<span class="text-(--color-muted)">Voice</span><span class="text-(--color-muted) font-mono text-right truncate">{job.voice}</span>
+						<span class="text-(--color-muted)">Engine</span><span class="text-(--color-muted) text-right">{engineLabel(job.voice)}</span>
+						<span class="text-(--color-muted)">Started</span><span class="text-(--color-muted) text-right">{fmtDate(job.started)}</span>
+						<span class="text-(--color-muted)">Duration</span><span class="text-(--color-muted) text-right">{duration(job.started, job.finished)}</span>
+					</div>
+					{#if job.error_message}
+						<p class="text-xs text-(--color-danger) font-mono break-all">{job.error_message}</p>
+					{/if}
+				{#if job.status === 'pending' || job.status === 'generating'}
+					<button
+						onclick={() => cancelJob(job.id)}
+						disabled={cancellingJobIds.has(job.id)}
+						class="w-full px-3 py-1.5 rounded-lg text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
+					>
+						{cancellingJobIds.has(job.id) ? 'Cancelling…' : 'Cancel job'}
+					</button>
+				{/if}
+				{#if job.status === 'failed'}
+					<button
+						onclick={() => retryJob(job)}
+						disabled={retryingJobIds.has(job.id)}
+						class="w-full px-3 py-1.5 rounded-lg text-xs font-medium bg-sky-400/10 text-sky-400 hover:bg-sky-400/20 disabled:opacity-50 transition-colors"
+					>
+						{retryingJobIds.has(job.id) ? 'Retrying…' : 'Retry ↺'}
+					</button>
+				{/if}
+				{#if cancelJobErrors[job.id]}
+					<p class="text-xs text-(--color-danger)">{cancelJobErrors[job.id]}</p>
+				{/if}
+				{#if retryJobErrors[job.id]}
+					<p class="text-xs text-(--color-danger)">{retryJobErrors[job.id]}</p>
+				{/if}
+				</div>
+			{/each}
+		</div>
 		{/if}
 	{/if}
 

ui/src/routes/admin/changelog/+page.server.ts

@@ -18,23 +18,27 @@ const CACHE_KEY = 'admin:changelog:releases';
 const CACHE_TTL = 5 * 60; // 5 minutes
 
 export const load: PageServerLoad = async ({ fetch }) => {
+	// Return cached data synchronously (no streaming needed — already fast).
 	const cached = await cache.get<Release[]>(CACHE_KEY);
 	if (cached) {
-		return { releases: cached };
+		return { releases: cached, error: undefined as string | undefined };
 	}
 
-	try {
-		const res = await fetch(GITEA_RELEASES_URL, {
-			headers: { Accept: 'application/json' }
-		});
-		if (!res.ok) {
-			return { releases: [], error: `Gitea API returned ${res.status}` };
+	// Cache miss: stream the external Gitea request so navigation isn't blocked.
+	const releasesPromise = (async () => {
+		try {
+			const res = await fetch(GITEA_RELEASES_URL, {
+				headers: { Accept: 'application/json' }
+			});
+			if (!res.ok) return [] as Release[];
+			const releases: Release[] = await res.json();
+			const filtered = releases.filter((r) => !r.draft);
+			await cache.set(CACHE_KEY, filtered, CACHE_TTL);
+			return filtered;
+		} catch {
+			return [] as Release[];
 		}
-		const releases: Release[] = await res.json();
-		const filtered = releases.filter((r) => !r.draft);
-		await cache.set(CACHE_KEY, filtered, CACHE_TTL);
-		return { releases: filtered };
-	} catch (e) {
-		return { releases: [], error: String(e) };
-	}
+	})();
+
+	return { releases: releasesPromise, error: undefined as string | undefined };
 };

ui/src/routes/admin/changelog/+page.svelte

@@ -32,29 +32,33 @@
 		</a>
 	</div>
 
-	{#if data.error}
-		<p class="text-sm text-(--color-danger)">{m.admin_changelog_load_error({ error: data.error })}</p>
-	{:else if data.releases.length === 0}
-		<p class="text-sm text-(--color-muted) py-8 text-center">{m.admin_changelog_no_releases()}</p>
-	{:else}
-		<div class="space-y-0 divide-y divide-(--color-border) border border-(--color-border) rounded-xl overflow-hidden">
-			{#each data.releases as release}
-				<div class="px-5 py-4 bg-(--color-surface) space-y-2">
-					<div class="flex items-baseline gap-3 flex-wrap">
-						<span class="font-mono text-sm font-semibold text-(--color-brand)">{release.tag_name}</span>
-						{#if release.name && release.name !== release.tag_name}
-							<span class="text-sm text-(--color-text)">{release.name}</span>
+	{#await data.releases}
+		<p class="text-sm text-(--color-muted) py-8 text-center">Loading releases…</p>
+	{:then releases}
+		{#if releases.length === 0}
+			<p class="text-sm text-(--color-muted) py-8 text-center">{m.admin_changelog_no_releases()}</p>
+		{:else}
+			<div class="space-y-0 divide-y divide-(--color-border) border border-(--color-border) rounded-xl overflow-hidden">
+				{#each releases as release}
+					<div class="px-5 py-4 bg-(--color-surface) space-y-2">
+						<div class="flex items-baseline gap-3 flex-wrap">
+							<span class="font-mono text-sm font-semibold text-(--color-brand)">{release.tag_name}</span>
+							{#if release.name && release.name !== release.tag_name}
+								<span class="text-sm text-(--color-text)">{release.name}</span>
+							{/if}
+							{#if release.prerelease}
+								<span class="text-xs px-1.5 py-0.5 rounded bg-(--color-surface-3) text-(--color-muted)">pre-release</span>
+							{/if}
+							<span class="text-xs text-(--color-muted) ml-auto">{fmtDate(release.published_at)}</span>
+						</div>
+						{#if release.body.trim()}
+							<p class="text-sm text-(--color-muted) leading-relaxed whitespace-pre-wrap">{release.body.trim()}</p>
 						{/if}
-						{#if release.prerelease}
-							<span class="text-xs px-1.5 py-0.5 rounded bg-(--color-surface-3) text-(--color-muted)">pre-release</span>
-						{/if}
-						<span class="text-xs text-(--color-muted) ml-auto">{fmtDate(release.published_at)}</span>
 					</div>
-					{#if release.body.trim()}
-						<p class="text-sm text-(--color-muted) leading-relaxed whitespace-pre-wrap">{release.body.trim()}</p>
-					{/if}
-				</div>
-			{/each}
-		</div>
-	{/if}
+				{/each}
+			</div>
+		{/if}
+	{:catch}
+		<p class="text-sm text-(--color-danger)">{m.admin_changelog_load_error({ error: 'Failed to load releases' })}</p>
+	{/await}
 </div>

ui/src/routes/admin/image-gen/+page.server.ts

@@ -20,23 +20,29 @@ export interface BookSummary {
 }
 
 export const load: PageServerLoad = async () => {
-	// parent layout already guards admin role
-	const [models, booksResult] = await Promise.allSettled([
-		listImageModels<ImageModelInfo>(),
-		listBooks()
-	]);
+	// Await models immediately — the page is unusable without them and the
+	// backend returns this list instantly (in-memory, no I/O).
+	// Books are streamed: the page renders at once and the book selector
+	// populates a moment later without blocking navigation.
+	const modelsResult = await listImageModels<ImageModelInfo>().catch((e) => {
+		log.warn('admin/image-gen', 'failed to load models', { err: String(e) });
+		return [] as ImageModelInfo[];
+	});
 
-	if (models.status === 'rejected') {
-		log.warn('admin/image-gen', 'failed to load models', { err: String(models.reason) });
-	}
+	const booksPromise = listBooks()
+		.then((all) =>
+			all.map((b) => ({
+				slug: b.slug,
+				title: b.title,
+				summary: b.summary ?? '',
+				cover: b.cover ?? ''
+			})) as BookSummary[]
+		)
+		.catch(() => [] as BookSummary[]);
 
 	return {
-		models: models.status === 'fulfilled' ? models.value : ([] as ImageModelInfo[]),
-		books: (booksResult.status === 'fulfilled' ? booksResult.value : []).map((b) => ({
-			slug: b.slug,
-			title: b.title,
-			summary: b.summary ?? '',
-			cover: b.cover ?? ''
-		})) as BookSummary[]
+		models: modelsResult,
+		// Streamed — SvelteKit resolves this after the initial HTML is sent.
+		books: booksPromise
 	};
 };

ui/src/routes/admin/image-gen/+page.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import { browser } from '$app/environment';
+	import { goto } from '$app/navigation';
 	import type { PageData } from './$types';
 	import type { ImageModelInfo, BookSummary } from './+page.server';
 
@@ -61,8 +62,11 @@
 	});
 
 	// ── Book autocomplete ────────────────────────────────────────────────────────
-	// svelte-ignore state_referenced_locally
-	const books: BookSummary[] = data.books ?? [];
+	// Books arrive as a streamed promise — start empty and populate on resolve.
+	let books = $state<BookSummary[]>([]);
+	$effect(() => {
+		data.books.then((resolved) => { books = resolved; });
+	});
 	let slugInput = $state('');
 	let slugFocused = $state(false);
 	let selectedBook = $state<BookSummary | null>(null);
@@ -120,30 +124,58 @@
 	// ── Generation state ─────────────────────────────────────────────────────────
 	let generating = $state(false);
 	let genError = $state('');
-	let elapsedMs = $state(0);
-	let elapsedInterval: ReturnType<typeof setInterval> | null = null;
 
-	// ── Result state ─────────────────────────────────────────────────────────────
-	interface GenResult {
-		imageSrc: string;
-		model: string;
-		bytes: number;
-		contentType: string;
-		saved: boolean;
-		coverUrl: string;
-		elapsedMs: number;
-		slug: string;
-		imageType: ImageType;
-		chapter: number;
+	// ── Generate (async: fire-and-forget → redirect to ai-jobs) ─────────────────
+	let canGenerate = $derived(prompt.trim().length > 0 && slug.trim().length > 0 && !generating);
+
+	async function generate() {
+		if (!canGenerate) return;
+		generating = true;
+		genError = '';
+
+		try {
+			const payload = {
+				prompt: prompt.trim(),
+				model: selectedModel,
+				type: imageType,
+				slug: slug.trim(),
+				chapter: imageType === 'chapter' ? chapter : 0,
+				num_steps: numSteps,
+				guidance,
+				strength,
+				width,
+				height
+			};
+
+			let res: Response;
+			if (referenceFile && selectedModelInfo?.supports_ref) {
+				const fd = new FormData();
+				fd.append('json', JSON.stringify(payload));
+				fd.append('reference', referenceFile);
+				res = await fetch('/api/admin/image-gen/async', { method: 'POST', body: fd });
+			} else {
+				res = await fetch('/api/admin/image-gen/async', {
+					method: 'POST',
+					headers: { 'Content-Type': 'application/json' },
+					body: JSON.stringify(payload)
+				});
+			}
+
+			const body = await res.json().catch(() => ({}));
+			if (!res.ok) {
+				genError = body.error ?? body.message ?? `Error ${res.status}`;
+				return;
+			}
+
+		// Navigate to ai-jobs so the admin can monitor progress and review.
+		await goto('/admin/ai-jobs');
+		} catch {
+			genError = 'Network error.';
+		} finally {
+			generating = false;
+		}
 	}
 
-	let result = $state<GenResult | null>(null);
-	let history = $state<GenResult[]>([]);
-
-	let saving = $state(false);
-	let saveError = $state('');
-	let saveSuccess = $state(false);
-
 	// ── Model helpers ────────────────────────────────────────────────────────────
 	// svelte-ignore state_referenced_locally
 	const models: ImageModelInfo[] = data.models ?? [];
@@ -300,6 +332,12 @@
 		if (input) input.value = '';
 	}
 
+	function fmtBytes(bytes: number): string {
+		if (bytes < 1024) return `${bytes} B`;
+		if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+		return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+	}
+
 	// ── Selected model info ──────────────────────────────────────────────────────
 	let selectedModelInfo = $derived(models.find((m) => m.id === selectedModel) ?? null);
 	let refWarning = $derived(
@@ -307,147 +345,6 @@
 			? `${selectedModelInfo.label} does not support reference images. The reference will be ignored.`
 			: ''
 	);
-
-	// ── Generate ────────────────────────────────────────────────────────────────
-	let canGenerate = $derived(prompt.trim().length > 0 && slug.trim().length > 0 && !generating);
-
-	async function generate() {
-		if (!canGenerate) return;
-		generating = true;
-		genError = '';
-		result = null;
-		elapsedMs = 0;
-		saveSuccess = false;
-		saveError = '';
-
-		const startTs = Date.now();
-		elapsedInterval = setInterval(() => {
-			elapsedMs = Date.now() - startTs;
-		}, 200);
-
-		try {
-			const payload = {
-				prompt: prompt.trim(),
-				model: selectedModel,
-				type: imageType,
-				slug: slug.trim(),
-				chapter: imageType === 'chapter' ? chapter : 0,
-				num_steps: numSteps,
-				guidance,
-				strength,
-				width,
-				height
-			};
-
-			let res: Response;
-			if (referenceFile && selectedModelInfo?.supports_ref) {
-				const fd = new FormData();
-				fd.append('json', JSON.stringify(payload));
-				fd.append('reference', referenceFile);
-				res = await fetch('/api/admin/image-gen', { method: 'POST', body: fd });
-			} else {
-				res = await fetch('/api/admin/image-gen', {
-					method: 'POST',
-					headers: { 'Content-Type': 'application/json' },
-					body: JSON.stringify(payload)
-				});
-			}
-
-			const body = await res.json().catch(() => ({}));
-			if (!res.ok) {
-				if (res.status === 502 || res.status === 504) {
-					genError =
-						body.error ??
-						`Generation timed out (${res.status}). FLUX models can take 60–120 s on Cloudflare Workers AI — try reducing steps or switching to a faster model.`;
-				} else {
-					genError = body.error ?? body.message ?? `Error ${res.status}`;
-				}
-				return;
-			}
-
-			const totalMs = Date.now() - startTs;
-			const newResult: GenResult = {
-				imageSrc: `data:${body.content_type};base64,${body.image_b64}`,
-				model: body.model,
-				bytes: body.bytes,
-				contentType: body.content_type,
-				saved: body.saved ?? false,
-				coverUrl: body.cover_url ?? '',
-				elapsedMs: totalMs,
-				slug: slug.trim(),
-				imageType,
-				chapter
-			};
-
-			result = newResult;
-			history = [newResult, ...history].slice(0, 5);
-		} catch {
-			genError = 'Network error.';
-		} finally {
-			generating = false;
-			if (elapsedInterval) {
-				clearInterval(elapsedInterval);
-				elapsedInterval = null;
-			}
-		}
-	}
-
-	// ── Save as cover ────────────────────────────────────────────────────────────
-	async function saveAsCover() {
-		if (!result || saving) return;
-		saving = true;
-		saveError = '';
-		saveSuccess = false;
-
-		try {
-			const b64 = result.imageSrc.split(',')[1];
-			const res = await fetch('/api/admin/image-gen/save-cover', {
-				method: 'POST',
-				headers: { 'Content-Type': 'application/json' },
-				body: JSON.stringify({ slug: result.slug, image_b64: b64 })
-			});
-			const body = await res.json().catch(() => ({}));
-			if (!res.ok) {
-				saveError = body.error ?? body.message ?? `Error ${res.status}`;
-				return;
-			}
-			if (body.saved) {
-				saveSuccess = true;
-				result = { ...result, saved: true, coverUrl: body.cover_url ?? result.coverUrl };
-			} else {
-				saveError = 'Backend did not save the cover.';
-			}
-		} catch {
-			saveError = 'Network error.';
-		} finally {
-			saving = false;
-		}
-	}
-
-	// ── Download ─────────────────────────────────────────────────────────────────
-	function download() {
-		if (!result) return;
-		const a = document.createElement('a');
-		a.href = result.imageSrc;
-		const ext = result.contentType === 'image/jpeg' ? 'jpg' : 'png';
-		a.download =
-			result.imageType === 'cover'
-				? `${result.slug}-cover.${ext}`
-				: `${result.slug}-ch${result.chapter}.${ext}`;
-		a.click();
-	}
-
-	// ── Formatting helpers ───────────────────────────────────────────────────────
-	function fmtElapsed(ms: number) {
-		if (ms < 1000) return `${ms}ms`;
-		return `${(ms / 1000).toFixed(1)}s`;
-	}
-
-	function fmtBytes(b: number) {
-		if (b < 1024) return `${b} B`;
-		if (b < 1024 * 1024) return `${(b / 1024).toFixed(1)} KB`;
-		return `${(b / 1024 / 1024).toFixed(2)} MB`;
-	}
 </script>
 
 <svelte:head>
@@ -830,9 +727,9 @@
 						<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
 						<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
 					</svg>
-					Generating… {fmtElapsed(elapsedMs)}
+					Queuing…
 				{:else}
-					Generate
+					Generate (async)
 				{/if}
 			</button>
 
@@ -841,116 +738,37 @@
 			{/if}
 		</div>
 
-		<!-- ── Right: Result panel ────────────────────────────────────────────────── -->
+		<!-- ── Right: Info panel ──────────────────────────────────────────────────── -->
 		<div class="space-y-4">
-			{#if result}
-				<div class="bg-(--color-surface) border border-(--color-border) rounded-xl overflow-hidden">
-					<!-- Image -->
-					<img
-						src={result.imageSrc}
-						alt=""
-						aria-label="Generated cover"
-						class="w-full object-contain max-h-[36rem] bg-zinc-950"
-					/>
+			<div class="bg-(--color-surface) border border-(--color-border) rounded-xl p-5 space-y-3">
+				<h2 class="text-sm font-semibold text-(--color-text)">How it works</h2>
+				<ol class="space-y-2 text-sm text-(--color-muted) list-decimal list-inside">
+					<li>Fill in the form and click <strong class="text-(--color-text)">Generate (async)</strong>.</li>
+					<li>The job is queued in the background — no waiting on this page.</li>
+					<li>You'll be taken to <strong class="text-(--color-text)">AI Jobs</strong> to monitor progress.</li>
+					<li>When done, click <strong class="text-(--color-text)">Review</strong> to see the image and approve or discard it.</li>
+				</ol>
+				<a
+					href="/admin/ai-jobs"
+					class="mt-3 flex items-center gap-1.5 text-sm text-(--color-brand) hover:underline"
+				>
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
+							d="M9 5l7 7-7 7" />
+					</svg>
+					Go to AI Jobs
+				</a>
+			</div>
 
-					<!-- Meta bar -->
-					<div class="px-4 py-3 border-t border-(--color-border) space-y-3">
-						<div class="grid grid-cols-3 gap-2 text-xs">
-							<div>
-								<p class="text-(--color-muted)">Model</p>
-								<p class="text-(--color-text) font-mono truncate" title={result.model}>
-									{models.find((m) => m.id === result!.model)?.label ?? result.model}
-								</p>
-							</div>
-							<div>
-								<p class="text-(--color-muted)">Size</p>
-								<p class="text-(--color-text)">{fmtBytes(result.bytes)}</p>
-							</div>
-							<div>
-								<p class="text-(--color-muted)">Time</p>
-								<p class="text-(--color-text)">{fmtElapsed(result.elapsedMs)}</p>
-							</div>
-						</div>
-
-						{#if result.saved}
-							<p class="text-xs text-green-400">
-								Cover saved &rarr;
-								<a href={result.coverUrl} target="_blank" rel="noopener noreferrer"
-									class="underline hover:text-green-300">{result.coverUrl}</a>
-							</p>
-						{/if}
-
-						{#if saveSuccess && !result.saved}
-							<p class="text-xs text-green-400">Cover saved successfully.</p>
-						{/if}
-						{#if saveError}
-							<p class="text-xs text-(--color-danger)">{saveError}</p>
-						{/if}
-
-						<!-- Actions -->
-						<div class="flex gap-2 flex-wrap">
-							<button
-								onclick={download}
-								class="flex-1 px-3 py-1.5 rounded-md bg-(--color-surface-3) text-(--color-text) text-xs font-medium hover:bg-zinc-600 transition-colors"
-							>
-								Download
-							</button>
-
-							{#if result.imageType === 'cover'}
-								<button
-									onclick={saveAsCover}
-									disabled={saving || result.saved}
-									class="flex-1 px-3 py-1.5 rounded-md bg-(--color-brand) text-(--color-surface) text-xs font-semibold
-										hover:bg-(--color-brand-dim) transition-colors disabled:opacity-50"
-								>
-									{saving ? 'Saving…' : result.saved ? 'Saved ✓' : 'Save as cover'}
-								</button>
-							{/if}
-						</div>
-					</div>
-				</div>
-			{:else if generating}
-				<!-- Placeholder while generating -->
-				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) rounded-xl h-80">
-					<div class="text-center space-y-3">
-						<svg class="w-8 h-8 animate-spin mx-auto text-(--color-brand)" fill="none" viewBox="0 0 24 24">
-							<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
-							<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
-						</svg>
-						<p class="text-sm text-(--color-muted)">Generating… {fmtElapsed(elapsedMs)}</p>
-					</div>
-				</div>
-			{:else}
-				<!-- Empty state -->
-				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) border-dashed rounded-xl h-80">
-					<p class="text-sm text-(--color-muted)">Generated image will appear here</p>
-				</div>
-			{/if}
-
-			<!-- History thumbnails -->
-			{#if history.length > 0}
-				<div class="space-y-2">
-					<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-widest">Session history</p>
-					<div class="flex gap-2 flex-wrap">
-						{#each history as h, i}
-							<button
-								onclick={() => result = h}
-								class="relative rounded-md overflow-hidden border transition-colors shrink-0
-									{result === h ? 'border-(--color-brand)' : 'border-(--color-border) hover:border-(--color-brand)/50'}"
-							>
-								<img
-									src={h.imageSrc}
-									alt="History {i + 1}"
-									class="w-16 h-16 object-cover"
-								/>
-								{#if h.saved}
-									<span class="absolute bottom-0.5 right-0.5 w-2.5 h-2.5 rounded-full bg-green-500 border border-(--color-surface)"></span>
-								{/if}
-							</button>
-						{/each}
-					</div>
-				</div>
-			{/if}
+			<div class="bg-(--color-surface) border border-(--color-border) rounded-xl p-5 space-y-2">
+				<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-wide">Tips</p>
+				<ul class="space-y-1.5 text-xs text-(--color-muted)">
+					<li>• Use <strong class="text-(--color-text)">Auto-prompt</strong> to generate a prompt from the book's description.</li>
+					<li>• FLUX models produce high-quality covers but take 60–120 s — the async path prevents timeouts.</li>
+					<li>• Keep steps ≤ 20 on Cloudflare Workers AI to stay within the ~100 s limit.</li>
+					<li>• Reference images (img2img) only work with models that show ★ref.</li>
+				</ul>
+			</div>
 		</div>
 	</div>
 </div>

ui/src/routes/admin/import/+page.svelte

@@ -0,0 +1,479 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import { goto } from '$app/navigation';
+
+	interface ImportTask {
+		id: string;
+		slug: string;
+		title: string;
+		file_name: string;
+		file_type: string;
+		author: string;
+		cover_url: string;
+		genres: string[];
+		summary: string;
+		book_status: string;
+		status: string;
+		chapters_done: number;
+		chapters_total: number;
+		error_message: string;
+		started: string;
+		finished: string;
+	}
+
+	interface PendingImport {
+		file: File;
+		title: string;
+		author: string;
+		coverUrl: string;
+		genres: string;
+		summary: string;
+		bookStatus: string;
+		preview: { chapters: number; firstLines: string[] };
+	}
+
+	let tasks = $state<ImportTask[]>([]);
+	let loading = $state(true);
+	let uploading = $state(false);
+	let analyzing = $state(false);
+	let error = $state('');
+
+	// Form fields
+	let selectedFile = $state<File | null>(null);
+	let title = $state('');
+	let author = $state('');
+	let coverUrl = $state('');
+	let genres = $state('');
+	let summary = $state('');
+	let bookStatus = $state('completed');
+
+	let pendingImport = $state<PendingImport | null>(null);
+
+	// AI panel: slug of recently completed import
+	let aiSlug = $state('');
+	let aiTitle = $state('');
+	let showAiPanel = $state(false);
+
+	async function loadTasks() {
+		loading = true;
+		try {
+			const res = await fetch('/api/admin/import');
+			if (res.ok) {
+				const data = await res.json();
+				tasks = data.tasks || [];
+			}
+		} catch (e) {
+			console.error('Failed to load tasks:', e);
+		} finally {
+			loading = false;
+		}
+	}
+
+	function handleFileSelect(e: Event) {
+		const input = e.target as HTMLInputElement;
+		if (!input.files?.length) return;
+		const file = input.files[0];
+		const ext = file.name.split('.').pop()?.toLowerCase() || '';
+		if (ext !== 'pdf' && ext !== 'epub') {
+			error = 'Please select a PDF or EPUB file';
+			return;
+		}
+		error = '';
+		selectedFile = file;
+		// Auto-fill title from filename if empty
+		if (!title.trim()) {
+			title = file.name.replace(/\.(pdf|epub)$/i, '').replace(/[-_]/g, ' ');
+		}
+	}
+
+	async function analyzeFile() {
+		if (!selectedFile || !title.trim()) return;
+		analyzing = true;
+		error = '';
+		try {
+			const formData = new FormData();
+			formData.append('file', selectedFile);
+			formData.append('title', title.trim());
+			formData.append('analyze', 'true');
+			const res = await fetch('/api/admin/import', { method: 'POST', body: formData });
+			if (res.ok) {
+				const data = await res.json();
+				pendingImport = {
+					file: selectedFile,
+					title: title.trim(),
+					author: author.trim(),
+					coverUrl: coverUrl.trim(),
+					genres: genres.trim(),
+					summary: summary.trim(),
+					bookStatus,
+					preview: data.preview || { chapters: 0, firstLines: [] }
+				};
+			} else {
+				const d = await res.json().catch(() => ({}));
+				error = d.error || 'Failed to analyze file';
+			}
+		} catch {
+			error = 'Failed to analyze file';
+		} finally {
+			analyzing = false;
+		}
+	}
+
+	async function startImport() {
+		if (!pendingImport) return;
+		uploading = true;
+		error = '';
+		try {
+			const formData = new FormData();
+			formData.append('file', pendingImport.file);
+			formData.append('title', pendingImport.title);
+			formData.append('author', pendingImport.author);
+			formData.append('cover_url', pendingImport.coverUrl);
+			formData.append('genres', pendingImport.genres);
+			formData.append('summary', pendingImport.summary);
+			formData.append('book_status', pendingImport.bookStatus);
+			const res = await fetch('/api/admin/import', { method: 'POST', body: formData });
+			if (res.ok) {
+				const data = await res.json();
+				// Save for AI panel before clearing state
+				const importedSlug = data.slug || '';
+				const importedTitle = pendingImport.title;
+				// Reset form
+				pendingImport = null;
+				selectedFile = null;
+				title = '';
+				author = '';
+				coverUrl = '';
+				genres = '';
+				summary = '';
+				bookStatus = 'completed';
+				// Show AI panel for this slug
+				aiSlug = importedSlug;
+				aiTitle = importedTitle;
+				showAiPanel = !!aiSlug;
+				await loadTasks();
+			} else {
+				const d = await res.json().catch(() => ({}));
+				error = d.error || 'Import failed';
+			}
+		} catch {
+			error = 'Import failed';
+		} finally {
+			uploading = false;
+		}
+	}
+
+	function cancelReview() {
+		pendingImport = null;
+	}
+
+	function formatDate(dateStr: string) {
+		if (!dateStr) return '-';
+		return new Date(dateStr).toLocaleString();
+	}
+
+	function statusColor(status: string) {
+		switch (status) {
+			case 'pending': return 'text-yellow-400';
+			case 'running': return 'text-blue-400';
+			case 'done': return 'text-green-400';
+			case 'failed': return 'text-red-400';
+			default: return 'text-(--color-muted)';
+		}
+	}
+
+	onMount(() => { loadTasks(); });
+
+	// Poll every 3s while any task is active
+	$effect(() => {
+		const hasActive = tasks.some((t) => t.status === 'running' || t.status === 'pending');
+		if (!hasActive) return;
+		const timer = setInterval(() => { loadTasks(); }, 3000);
+		return () => clearInterval(timer);
+	});
+
+	// When a running task finishes, surface the AI panel for it
+	$effect(() => {
+		if (!showAiPanel) {
+			const done = tasks.find((t) => t.status === 'done');
+			if (done && !aiSlug) {
+				aiSlug = done.slug;
+				aiTitle = done.title;
+				showAiPanel = true;
+			}
+		}
+	});
+</script>
+
+<div class="max-w-3xl space-y-8">
+	<h1 class="text-2xl font-bold">Import PDF/EPUB</h1>
+
+	{#if pendingImport}
+		<!-- ── Review step ── -->
+		<div class="p-6 bg-(--color-surface-2) rounded-lg border border-(--color-brand)/30 space-y-4">
+			<h2 class="text-lg font-semibold">Review Import</h2>
+			<dl class="space-y-2 text-sm">
+				<div class="flex justify-between gap-4">
+					<dt class="text-(--color-muted) shrink-0">Title</dt>
+					<dd class="font-medium text-right">{pendingImport.title}</dd>
+				</div>
+				{#if pendingImport.author}
+					<div class="flex justify-between gap-4">
+						<dt class="text-(--color-muted) shrink-0">Author</dt>
+						<dd class="text-right">{pendingImport.author}</dd>
+					</div>
+				{/if}
+				{#if pendingImport.genres}
+					<div class="flex justify-between gap-4">
+						<dt class="text-(--color-muted) shrink-0">Genres</dt>
+						<dd class="text-right">{pendingImport.genres}</dd>
+					</div>
+				{/if}
+				<div class="flex justify-between gap-4">
+					<dt class="text-(--color-muted) shrink-0">Status</dt>
+					<dd class="capitalize text-right">{pendingImport.bookStatus}</dd>
+				</div>
+				<div class="flex justify-between gap-4">
+					<dt class="text-(--color-muted) shrink-0">File</dt>
+					<dd class="text-right truncate max-w-xs">{pendingImport.file.name}</dd>
+				</div>
+				<div class="flex justify-between gap-4">
+					<dt class="text-(--color-muted) shrink-0">Size</dt>
+					<dd>{(pendingImport.file.size / 1024 / 1024).toFixed(2)} MB</dd>
+				</div>
+				{#if pendingImport.preview.chapters > 0}
+					<div class="flex justify-between gap-4">
+						<dt class="text-(--color-muted) shrink-0">Detected chapters</dt>
+						<dd class="text-green-400 font-semibold">{pendingImport.preview.chapters}</dd>
+					</div>
+				{/if}
+			</dl>
+			{#if pendingImport.preview.firstLines?.length}
+				<div class="mt-2 space-y-1">
+					<p class="text-xs text-(--color-muted) mb-1">First lines preview:</p>
+					{#each pendingImport.preview.firstLines as line}
+						<p class="text-xs text-(--color-muted) italic truncate">{line}</p>
+					{/each}
+				</div>
+			{/if}
+			<div class="flex gap-3 pt-2">
+				<button
+					onclick={startImport}
+					disabled={uploading}
+					class="px-4 py-2 bg-green-600 hover:bg-green-500 text-white rounded font-medium disabled:opacity-50 transition-colors"
+				>
+					{uploading ? 'Starting…' : 'Start Import'}
+				</button>
+				<button
+					onclick={cancelReview}
+					class="px-4 py-2 border border-(--color-border) rounded font-medium hover:bg-(--color-surface-3) transition-colors"
+				>
+					Cancel
+				</button>
+			</div>
+		</div>
+
+	{:else}
+		<!-- ── Upload form ── -->
+		<form
+			onsubmit={(e) => { e.preventDefault(); analyzeFile(); }}
+			class="p-6 bg-(--color-surface-2) rounded-lg space-y-4"
+		>
+			<!-- File picker -->
+			<div>
+				<label for="import-file" class="block text-sm font-medium mb-1">File (PDF or EPUB)</label>
+				<input
+					id="import-file"
+					type="file"
+					accept=".pdf,.epub"
+					onchange={handleFileSelect}
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				/>
+			</div>
+
+			<!-- Title -->
+			<div>
+				<label for="import-title" class="block text-sm font-medium mb-1">Title <span class="text-red-400">*</span></label>
+				<input
+					id="import-title"
+					type="text"
+					bind:value={title}
+					placeholder="Book title"
+					required
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				/>
+			</div>
+
+			<!-- Author -->
+			<div>
+				<label for="import-author" class="block text-sm font-medium mb-1">Author</label>
+				<input
+					id="import-author"
+					type="text"
+					bind:value={author}
+					placeholder="Author name"
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				/>
+			</div>
+
+			<!-- Cover URL -->
+			<div>
+				<label for="import-cover" class="block text-sm font-medium mb-1">Cover image URL</label>
+				<input
+					id="import-cover"
+					type="url"
+					bind:value={coverUrl}
+					placeholder="https://…"
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				/>
+			</div>
+
+			<!-- Genres -->
+			<div>
+				<label for="import-genres" class="block text-sm font-medium mb-1">Genres <span class="text-xs text-(--color-muted)">(comma-separated)</span></label>
+				<input
+					id="import-genres"
+					type="text"
+					bind:value={genres}
+					placeholder="Fantasy, Action, Romance"
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				/>
+			</div>
+
+			<!-- Summary -->
+			<div>
+				<label for="import-summary" class="block text-sm font-medium mb-1">Summary</label>
+				<textarea
+					id="import-summary"
+					bind:value={summary}
+					rows={3}
+					placeholder="Short description of the book…"
+					class="w-full px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm resize-y"
+				></textarea>
+			</div>
+
+			<!-- Status -->
+			<div>
+				<label for="import-status" class="block text-sm font-medium mb-1">Book status</label>
+				<select
+					id="import-status"
+					bind:value={bookStatus}
+					class="px-3 py-2 rounded bg-(--color-surface) border border-(--color-border) text-(--color-text) text-sm"
+				>
+					<option value="completed">Completed</option>
+					<option value="ongoing">Ongoing</option>
+					<option value="hiatus">Hiatus</option>
+				</select>
+			</div>
+
+			{#if error}
+				<p class="text-sm text-red-400">{error}</p>
+			{/if}
+
+			<button
+				type="submit"
+				disabled={analyzing || !selectedFile || !title.trim()}
+				class="px-5 py-2 bg-(--color-brand) text-(--color-surface) rounded font-semibold disabled:opacity-50 hover:brightness-110 transition-all"
+			>
+				{analyzing ? 'Analyzing…' : 'Review & Import'}
+			</button>
+			<p class="text-xs text-(--color-muted)">Detects chapter structure before committing.</p>
+		</form>
+	{/if}
+
+	<!-- ── AI Tasks panel (shown after successful import) ── -->
+	{#if showAiPanel && aiSlug}
+		<div class="p-5 bg-(--color-surface-2) rounded-lg border border-(--color-brand)/20 space-y-3">
+			<div class="flex items-center justify-between">
+				<h2 class="text-base font-semibold">AI Tasks for <span class="text-(--color-brand)">{aiTitle || aiSlug}</span></h2>
+				<button
+					onclick={() => { showAiPanel = false; }}
+					class="text-(--color-muted) hover:text-(--color-text) text-lg leading-none"
+					aria-label="Dismiss"
+				>&times;</button>
+			</div>
+			<p class="text-sm text-(--color-muted)">Run AI tasks on the imported book to enrich it:</p>
+			<div class="flex flex-wrap gap-2">
+				<a
+					href="/admin/text-gen?slug={aiSlug}&tab=chapters"
+					class="px-3 py-1.5 text-sm rounded bg-(--color-surface-3) hover:bg-(--color-brand)/20 border border-(--color-border) transition-colors"
+				>
+					Generate chapter names
+				</a>
+				<a
+					href="/admin/text-gen?slug={aiSlug}&tab=description"
+					class="px-3 py-1.5 text-sm rounded bg-(--color-surface-3) hover:bg-(--color-brand)/20 border border-(--color-border) transition-colors"
+				>
+					Generate description
+				</a>
+				<a
+					href="/admin/image-gen?slug={aiSlug}"
+					class="px-3 py-1.5 text-sm rounded bg-(--color-surface-3) hover:bg-(--color-brand)/20 border border-(--color-border) transition-colors"
+				>
+					Generate cover image
+				</a>
+				<a
+					href="/admin/text-gen?slug={aiSlug}&tab=tagline"
+					class="px-3 py-1.5 text-sm rounded bg-(--color-surface-3) hover:bg-(--color-brand)/20 border border-(--color-border) transition-colors"
+				>
+					Generate tagline
+				</a>
+			</div>
+		</div>
+	{/if}
+
+	<!-- ── Task list ── -->
+	<div>
+		<h2 class="text-lg font-semibold mb-3">Import Tasks</h2>
+
+		{#if loading}
+			<p class="text-(--color-muted) text-sm">Loading…</p>
+		{:else if tasks.length === 0}
+			<p class="text-(--color-muted) text-sm">No import tasks yet.</p>
+		{:else}
+			<div class="overflow-x-auto rounded-lg border border-(--color-border)">
+				<table class="w-full text-sm">
+					<thead>
+						<tr class="text-left text-(--color-muted) border-b border-(--color-border) bg-(--color-surface-2)">
+							<th class="px-3 py-2 font-medium">Title</th>
+							<th class="px-3 py-2 font-medium">Type</th>
+							<th class="px-3 py-2 font-medium">Status</th>
+							<th class="px-3 py-2 font-medium">Chapters</th>
+							<th class="px-3 py-2 font-medium">Started</th>
+							<th class="px-3 py-2 font-medium">AI</th>
+						</tr>
+					</thead>
+					<tbody>
+						{#each tasks as task}
+							<tr class="border-b border-(--color-border)/50 hover:bg-(--color-surface-2)/50">
+								<td class="px-3 py-2">
+									<div class="font-medium">{task.title}</div>
+									<div class="text-xs text-(--color-muted)">{task.slug}</div>
+									{#if task.error_message}
+										<div class="text-xs text-red-400 mt-0.5 truncate max-w-xs" title={task.error_message}>{task.error_message}</div>
+									{/if}
+								</td>
+								<td class="px-3 py-2 uppercase text-xs">{task.file_type}</td>
+								<td class="px-3 py-2 {statusColor(task.status)} font-medium">{task.status}</td>
+								<td class="px-3 py-2 text-(--color-muted)">
+									{task.chapters_done}/{task.chapters_total}
+								</td>
+								<td class="px-3 py-2 text-(--color-muted) text-xs whitespace-nowrap">{formatDate(task.started)}</td>
+								<td class="px-3 py-2">
+									{#if task.status === 'done'}
+										<button
+											onclick={() => { aiSlug = task.slug; aiTitle = task.title; showAiPanel = true; }}
+											class="text-xs px-2 py-1 rounded bg-(--color-brand)/20 hover:bg-(--color-brand)/40 text-(--color-brand) transition-colors"
+										>
+											AI tasks
+										</button>
+									{/if}
+								</td>
+							</tr>
+						{/each}
+					</tbody>
+				</table>
+			</div>
+		{/if}
+	</div>
+</div>

ui/src/routes/admin/notifications/+page.server.ts

@@ -0,0 +1,16 @@
+import type { PageServerLoad } from './$types';
+import { backendFetch } from '$lib/server/scraper';
+
+export const load: PageServerLoad = async ({ locals }) => {
+	const userId = locals.user!.id;
+	try {
+		const res = await backendFetch('/api/notifications?user_id=' + userId);
+		const data = await res.json().catch(() => ({ notifications: [] }));
+		return {
+			userId,
+			notifications: (data.notifications ?? []) as Array<{id: string; title: string; message: string; link: string; read: boolean}>
+		};
+	} catch {
+		return { userId, notifications: [] };
+	}
+};

ui/src/routes/admin/notifications/+page.svelte

@@ -0,0 +1,127 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+
+	let { data }: { data: PageData } = $props();
+
+	type Notification = { id: string; title: string; message: string; link: string; read: boolean };
+
+	let notifications = $state<Notification[]>(data.notifications);
+	let filter = $state<'all' | 'unread'>('all');
+	let busy = $state(false);
+
+	const filtered = $derived(
+		filter === 'unread' ? notifications.filter(n => !n.read) : notifications
+	);
+	const unreadCount = $derived(notifications.filter(n => !n.read).length);
+
+	async function markRead(id: string) {
+		await fetch('/api/notifications/' + id, { method: 'PATCH' }).catch(() => {});
+		notifications = notifications.map(n => n.id === id ? { ...n, read: true } : n);
+	}
+
+	async function dismiss(id: string) {
+		await fetch('/api/notifications/' + id, { method: 'DELETE' }).catch(() => {});
+		notifications = notifications.filter(n => n.id !== id);
+	}
+
+	async function markAllRead() {
+		busy = true;
+		try {
+			await fetch('/api/notifications?user_id=' + data.userId, { method: 'PATCH' });
+			notifications = notifications.map(n => ({ ...n, read: true }));
+		} finally { busy = false; }
+	}
+
+	async function clearAll() {
+		if (!confirm('Clear all notifications?')) return;
+		busy = true;
+		try {
+			await fetch('/api/notifications?user_id=' + data.userId, { method: 'DELETE' });
+			notifications = [];
+		} finally { busy = false; }
+	}
+</script>
+
+<svelte:head>
+	<title>Notifications — Admin</title>
+</svelte:head>
+
+<div class="max-w-2xl mx-auto px-4 py-8">
+	<div class="flex items-center justify-between mb-6">
+		<div>
+			<h1 class="text-xl font-semibold">Notifications</h1>
+			{#if unreadCount > 0}
+				<p class="text-sm text-(--color-muted) mt-0.5">{unreadCount} unread</p>
+			{/if}
+		</div>
+		<div class="flex gap-2">
+			{#if unreadCount > 0}
+				<button
+					type="button"
+					onclick={markAllRead}
+					disabled={busy}
+					class="text-sm px-3 py-1.5 rounded border border-(--color-border) text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2) transition-colors disabled:opacity-50"
+				>Mark all read</button>
+			{/if}
+			{#if notifications.length > 0}
+				<button
+					type="button"
+					onclick={clearAll}
+					disabled={busy}
+					class="text-sm px-3 py-1.5 rounded border border-(--color-border) text-red-400 hover:bg-(--color-surface-2) transition-colors disabled:opacity-50"
+				>Clear all</button>
+			{/if}
+		</div>
+	</div>
+
+	<!-- Filter tabs -->
+	<div class="flex gap-0 mb-4">
+		<button
+			type="button"
+			onclick={() => filter = 'all'}
+			class="text-sm px-4 py-1.5 rounded-l border border-(--color-border) transition-colors {filter === 'all' ? 'bg-(--color-brand) text-black border-(--color-brand) font-medium' : 'text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2)'}"
+		>All ({notifications.length})</button>
+		<button
+			type="button"
+			onclick={() => filter = 'unread'}
+			class="text-sm px-4 py-1.5 rounded-r border border-l-0 border-(--color-border) transition-colors {filter === 'unread' ? 'bg-(--color-brand) text-black border-(--color-brand) font-medium' : 'text-(--color-muted) hover:text-(--color-text) hover:bg-(--color-surface-2)'}"
+		>Unread ({unreadCount})</button>
+	</div>
+
+	<!-- List -->
+	{#if filtered.length === 0}
+		<div class="py-16 text-center text-(--color-muted)">
+			{filter === 'unread' ? 'No unread notifications' : 'No notifications'}
+		</div>
+	{:else}
+		<div class="rounded-lg border border-(--color-border) overflow-hidden">
+			{#each filtered as n (n.id)}
+				<div class="flex items-start gap-2 border-b border-(--color-border)/40 last:border-b-0 hover:bg-(--color-surface-2) group transition-colors {n.read ? 'opacity-60' : ''}">
+					<a
+						href={n.link || '/admin'}
+						onclick={() => markRead(n.id)}
+						class="flex-1 p-4 min-w-0"
+					>
+						<div class="flex items-center gap-2">
+							{#if !n.read}
+								<span class="w-2 h-2 rounded-full bg-(--color-brand) shrink-0"></span>
+							{/if}
+							<span class="font-medium text-sm">{n.title}</span>
+						</div>
+						<p class="text-sm text-(--color-muted) mt-1">{n.message}</p>
+					</a>
+					<button
+						type="button"
+						onclick={() => dismiss(n.id)}
+						class="shrink-0 p-3 text-(--color-muted) hover:text-red-400 opacity-0 group-hover:opacity-100 transition-all"
+						title="Dismiss"
+					>
+						<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+							<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+						</svg>
+					</button>
+				</div>
+			{/each}
+		</div>
+	{/if}
+</div>

ui/src/routes/admin/scrape/+page.svelte

@@ -178,17 +178,32 @@
 		}
 	}
 
+	// ── Stats ────────────────────────────────────────────────────────────────────
+	let stats = $derived({
+		total: tasks.length,
+		running: tasks.filter((t: ScrapingTask) => t.status === 'running').length,
+		pending: tasks.filter((t: ScrapingTask) => t.status === 'pending').length,
+		done: tasks.filter((t: ScrapingTask) => t.status === 'done').length,
+		failed: tasks.filter((t: ScrapingTask) => t.status === 'failed').length,
+		cancelled: tasks.filter((t: ScrapingTask) => t.status === 'cancelled').length,
+	});
+
 	// ── Table filter ────────────────────────────────────────────────────────────
 	let q = $state('');
+	let statusFilter = $state('all');
+	const STATUS_OPTIONS = ['all', 'running', 'pending', 'done', 'failed', 'cancelled'] as const;
+
 	let filtered = $derived(
-		q.trim()
-			? tasks.filter(
-					(t: ScrapingTask) =>
-						t.kind.toLowerCase().includes(q.toLowerCase()) ||
-						t.status.toLowerCase().includes(q.toLowerCase()) ||
-						(t.target_url ?? '').toLowerCase().includes(q.toLowerCase())
-				)
-			: tasks
+		tasks.filter((t: ScrapingTask) => {
+			const qLower = q.trim().toLowerCase();
+			const matchesQ =
+				!qLower ||
+				t.kind.toLowerCase().includes(qLower) ||
+				t.status.toLowerCase().includes(qLower) ||
+				(t.target_url ?? '').toLowerCase().includes(qLower);
+			const matchesStatus = statusFilter === 'all' || t.status === statusFilter;
+			return matchesQ && matchesStatus;
+		})
 	);
 
 	// ── Helpers ─────────────────────────────────────────────────────────────────
@@ -226,6 +241,15 @@
 		{ label: 'Isekai', url: 'https://novelfire.net/genre/isekai' },
 		{ label: 'Martial Arts', url: 'https://novelfire.net/genre/martial-arts' },
 	];
+
+	function statusPillColor(s: string) {
+		if (s === 'running') return 'text-(--color-brand)';
+		if (s === 'pending') return 'text-sky-400';
+		if (s === 'done') return 'text-green-400';
+		if (s === 'failed') return 'text-(--color-danger)';
+		if (s === 'cancelled') return 'text-(--color-muted)';
+		return 'text-(--color-text)';
+	}
 </script>
 
 <svelte:head>
@@ -344,6 +368,27 @@
 			/>
 		</div>
 
+		<!-- Status filter pills -->
+		<div class="flex gap-1.5 flex-wrap">
+			{#each STATUS_OPTIONS as s}
+				{@const count = s === 'all' ? stats.total : stats[s as keyof typeof stats]}
+				<button
+					onclick={() => (statusFilter = s)}
+					class="px-2.5 py-1 rounded-md text-xs font-medium transition-colors capitalize flex items-center gap-1.5
+						{statusFilter === s
+							? 'bg-(--color-brand) text-black'
+							: 'bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'}"
+				>
+					{s}
+					{#if count > 0 && s !== 'all'}
+						<span class="tabular-nums {statusFilter === s ? 'text-black/70' : statusPillColor(s)}">{count}</span>
+					{:else if s === 'all'}
+						<span class="tabular-nums opacity-60">{count}</span>
+					{/if}
+				</button>
+			{/each}
+		</div>
+
 		{#if filtered.length === 0}
 			<p class="text-(--color-muted) text-sm py-8 text-center">
 				{q.trim() ? m.admin_scrape_no_matching() : m.admin_tasks_empty()}

ui/src/routes/admin/text-gen/+page.server.ts

@@ -17,21 +17,23 @@ export interface TextModelInfo {
 }
 
 export const load: PageServerLoad = async () => {
-	// Parent layout already guards admin role.
-	const [models, booksResult] = await Promise.allSettled([
-		listTextModels<TextModelInfo>(),
-		listBooks()
-	]);
+	// Await models immediately — in-memory list, no I/O, returns instantly.
+	// Books are streamed so the page renders at once and the selector
+	// populates a moment later without blocking navigation.
+	const modelsResult = await listTextModels<TextModelInfo>().catch((e) => {
+		log.warn('admin/text-gen', 'failed to load models', { err: String(e) });
+		return [] as TextModelInfo[];
+	});
 
-	if (models.status === 'rejected') {
-		log.warn('admin/text-gen', 'failed to load models', { err: String(models.reason) });
-	}
+	const booksPromise = listBooks()
+		.then((all) =>
+			all.map((b) => ({ slug: b.slug, title: b.title })) as BookSummary[]
+		)
+		.catch(() => [] as BookSummary[]);
 
 	return {
-		models: models.status === 'fulfilled' ? models.value : ([] as TextModelInfo[]),
-		books: (booksResult.status === 'fulfilled' ? booksResult.value : []).map((b) => ({
-			slug: b.slug,
-			title: b.title
-		})) as BookSummary[]
+		models: modelsResult,
+		// Streamed — SvelteKit resolves this after the initial HTML is sent.
+		books: booksPromise
 	};
 };

ui/src/routes/admin/text-gen/+page.svelte

@@ -2,14 +2,18 @@
 	import { browser } from '$app/environment';
 	import type { PageData } from './$types';
 	import type { TextModelInfo, BookSummary } from './+page.server';
+	import * as m from '$lib/paraglide/messages.js';
 
 	let { data }: { data: PageData } = $props();
 
 	// Server data is static per page load — intentional one-time snapshot.
 	// svelte-ignore state_referenced_locally
 	const models: TextModelInfo[] = data.models ?? [];
-	// svelte-ignore state_referenced_locally
-	const books: BookSummary[] = data.books ?? [];
+	// Books arrive as a streamed promise — start empty and populate on resolve.
+	let books = $state<BookSummary[]>([]);
+	$effect(() => {
+		data.books.then((resolved) => { books = resolved; });
+	});
 
 	// ── Config persistence ───────────────────────────────────────────────────────
 	const CONFIG_KEY = 'admin_text_gen_config_v2';
@@ -345,7 +349,9 @@
 	let tGenerating = $state(false);
 	let tError = $state('');
 	let tResult = $state('');
+	let tEdited = $state('');
 	let tUsedModel = $state('');
+	let tCopied = $state(false);
 
 	let tCanGenerate = $derived(tSlug.trim().length > 0 && !tGenerating);
 
@@ -354,7 +360,7 @@
 
 	async function generateTagline() {
 		if (!tCanGenerate) return;
-		tGenerating = true; tError = ''; tResult = '';
+		tGenerating = true; tError = ''; tResult = ''; tEdited = ''; tCopied = false;
 		try {
 			const res = await fetch('/api/admin/text-gen/tagline', {
 				method: 'POST', headers: { 'Content-Type': 'application/json' },
@@ -363,10 +369,17 @@
 			const body = await res.json().catch(() => ({}));
 			if (!res.ok) { tError = body.error ?? `Error ${res.status}`; return; }
 			tResult = body.new_tagline ?? '';
+			tEdited = tResult;
 			tUsedModel = body.model ?? '';
 		} catch { tError = 'Network error.'; } finally { tGenerating = false; }
 	}
 
+	async function copyTagline() {
+		await navigator.clipboard.writeText(tEdited || tResult);
+		tCopied = true;
+		setTimeout(() => { tCopied = false; }, 2000);
+	}
+
 	// ── Genres state ──────────────────────────────────────────────────────────────
 	let gAC = makeBookAC();
 	let gSlug = $state('');
@@ -424,6 +437,7 @@
 	let wError = $state('');
 	let wWarnings = $state<string[]>([]);
 	let wUsedModel = $state('');
+	let wCopied = $state(false);
 
 	let wCanGenerate = $derived(wSlug.trim().length > 0 && !wGenerating);
 
@@ -432,7 +446,7 @@
 
 	async function generateWarnings() {
 		if (!wCanGenerate) return;
-		wGenerating = true; wError = ''; wWarnings = [];
+		wGenerating = true; wError = ''; wWarnings = []; wCopied = false;
 		try {
 			const res = await fetch('/api/admin/text-gen/content-warnings', {
 				method: 'POST', headers: { 'Content-Type': 'application/json' },
@@ -445,6 +459,12 @@
 		} catch { wError = 'Network error.'; } finally { wGenerating = false; }
 	}
 
+	async function copyWarnings() {
+		await navigator.clipboard.writeText(wWarnings.join(', '));
+		wCopied = true;
+		setTimeout(() => { wCopied = false; }, 2000);
+	}
+
 	// ── Quality score state ───────────────────────────────────────────────────────
 	let qAC = makeBookAC();
 	let qSlug = $state('');
@@ -477,13 +497,13 @@
 </script>
 
 <svelte:head>
-	<title>Text Gen — Admin</title>
+	<title>{m.admin_text_gen_page_title()}</title>
 </svelte:head>
 
 <div class="space-y-6 max-w-5xl">
 	<!-- Header -->
 	<div>
-		<h1 class="text-2xl font-bold text-(--color-text)">Text Generation</h1>
+		<h1 class="text-2xl font-bold text-(--color-text)">{m.admin_text_gen_heading()}</h1>
 		<p class="text-(--color-muted) text-sm mt-1">
 			Generate chapter titles and book descriptions using Cloudflare Workers AI.
 		</p>
@@ -920,32 +940,44 @@
 				</button>
 				{#if tError}<p class="text-sm text-(--color-danger) bg-(--color-danger)/10 rounded-lg px-3 py-2">{tError}</p>{/if}
 			</div>
-			<div>
-				{#if tResult}
-					<div class="space-y-2">
-						<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-widest">
-							Tagline{#if tUsedModel}<span class="normal-case font-normal"> · {tUsedModel.split('/').pop()}</span>{/if}
-						</p>
-						<div class="bg-(--color-surface) border border-(--color-brand)/40 rounded-xl p-4">
-							<p class="text-base italic text-(--color-text)">{tResult}</p>
-						</div>
-						<button onclick={() => { tResult = ''; }} class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors">Clear</button>
+		<div>
+			{#if tResult}
+				<div class="space-y-2">
+					<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-widest">
+						Tagline{#if tUsedModel}<span class="normal-case font-normal"> · {tUsedModel.split('/').pop()}</span>{/if}
+					</p>
+					<input
+						type="text"
+						bind:value={tEdited}
+						class="w-full bg-(--color-surface) border border-(--color-brand)/40 rounded-xl px-4 py-3 text-base italic text-(--color-text) focus:outline-none focus:ring-1 focus:ring-(--color-brand)"
+					/>
+					<p class="text-xs text-(--color-muted)">Note: tagline field not yet in the data model — copy and use manually.</p>
+					<div class="flex gap-2">
+						<button
+							onclick={copyTagline}
+							class="px-3 py-1.5 rounded-md text-xs font-medium transition-colors
+								{tCopied ? 'bg-green-400/10 text-green-400 border border-green-400/30' : 'bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text) border border-(--color-border)'}"
+						>
+							{tCopied ? 'Copied ✓' : 'Copy to clipboard'}
+						</button>
+						<button onclick={() => { tResult = ''; tEdited = ''; }} class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors">Clear</button>
 					</div>
-				{:else if tGenerating}
-					<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) rounded-xl h-28">
-						<svg class="w-6 h-6 animate-spin text-(--color-brand)" fill="none" viewBox="0 0 24 24">
-							<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
-							<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
-						</svg>
-					</div>
-				{:else}
-					<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) border-dashed rounded-xl h-28">
-						<p class="text-sm text-(--color-muted)">Tagline will appear here</p>
-					</div>
-				{/if}
-			</div>
+				</div>
+			{:else if tGenerating}
+				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) rounded-xl h-28">
+					<svg class="w-6 h-6 animate-spin text-(--color-brand)" fill="none" viewBox="0 0 24 24">
+						<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
+						<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
+					</svg>
+				</div>
+			{:else}
+				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) border-dashed rounded-xl h-28">
+					<p class="text-sm text-(--color-muted)">Tagline will appear here</p>
+				</div>
+			{/if}
 		</div>
-	{/if}
+	</div>
+{/if}
 
 	<!-- ── Genres panel ────────────────────────────────────────────────────────── -->
 	{#if activeTab === 'genres'}
@@ -1077,38 +1109,48 @@
 				</button>
 				{#if wError}<p class="text-sm text-(--color-danger) bg-(--color-danger)/10 rounded-lg px-3 py-2">{wError}</p>{/if}
 			</div>
-			<div>
-				{#if wWarnings.length > 0}
-					<div class="space-y-2">
-						<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-widest">
-							Detected warnings{#if wUsedModel}<span class="normal-case font-normal"> · {wUsedModel.split('/').pop()}</span>{/if}
-						</p>
-						<div class="flex flex-wrap gap-2">
-							{#each wWarnings as w}
-								<span class="px-3 py-1 rounded-full text-sm bg-amber-400/10 text-amber-400 border border-amber-400/30">{w}</span>
-							{/each}
-						</div>
-						<button onclick={() => { wWarnings = []; }} class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors">Clear</button>
+		<div>
+			{#if wWarnings.length > 0}
+				<div class="space-y-2">
+					<p class="text-xs font-semibold text-(--color-muted) uppercase tracking-widest">
+						Detected warnings{#if wUsedModel}<span class="normal-case font-normal"> · {wUsedModel.split('/').pop()}</span>{/if}
+					</p>
+					<div class="flex flex-wrap gap-2">
+						{#each wWarnings as w}
+							<span class="px-3 py-1 rounded-full text-sm bg-amber-400/10 text-amber-400 border border-amber-400/30">{w}</span>
+						{/each}
 					</div>
-				{:else if wWarnings.length === 0 && wUsedModel}
-					<div class="bg-green-400/10 border border-green-400/30 rounded-xl p-4">
-						<p class="text-sm text-green-400">No content warnings detected.</p>
+					<p class="text-xs text-(--color-muted)">Note: content warnings field not yet in the data model — copy and use manually.</p>
+					<div class="flex gap-2">
+						<button
+							onclick={copyWarnings}
+							class="px-3 py-1.5 rounded-md text-xs font-medium transition-colors
+								{wCopied ? 'bg-green-400/10 text-green-400 border border-green-400/30' : 'bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text) border border-(--color-border)'}"
+						>
+							{wCopied ? 'Copied ✓' : 'Copy to clipboard'}
+						</button>
+						<button onclick={() => { wWarnings = []; wUsedModel = ''; }} class="text-xs text-(--color-muted) hover:text-(--color-text) transition-colors">Clear</button>
 					</div>
-				{:else if wGenerating}
-					<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) rounded-xl h-28">
-						<svg class="w-6 h-6 animate-spin text-(--color-brand)" fill="none" viewBox="0 0 24 24">
-							<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
-							<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
-						</svg>
-					</div>
-				{:else}
-					<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) border-dashed rounded-xl h-28">
-						<p class="text-sm text-(--color-muted)">Warnings will appear here</p>
-					</div>
-				{/if}
-			</div>
+				</div>
+			{:else if wWarnings.length === 0 && wUsedModel}
+				<div class="bg-green-400/10 border border-green-400/30 rounded-xl p-4">
+					<p class="text-sm text-green-400">No content warnings detected.</p>
+				</div>
+			{:else if wGenerating}
+				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) rounded-xl h-28">
+					<svg class="w-6 h-6 animate-spin text-(--color-brand)" fill="none" viewBox="0 0 24 24">
+						<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
+						<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
+					</svg>
+				</div>
+			{:else}
+				<div class="flex items-center justify-center bg-(--color-surface) border border-(--color-border) border-dashed rounded-xl h-28">
+					<p class="text-sm text-(--color-muted)">Warnings will appear here</p>
+				</div>
+			{/if}
 		</div>
-	{/if}
+	</div>
+{/if}
 
 	<!-- ── Quality score panel ────────────────────────────────────────────────── -->
 	{#if activeTab === 'quality'}

ui/src/routes/admin/translation/+page.server.ts

@@ -1,6 +1,6 @@
 import { redirect } from '@sveltejs/kit';
 import type { Actions, PageServerLoad } from './$types';
-import { listBooks, listTranslationJobs, type TranslationJob } from '$lib/server/pocketbase';
+import { listBookSlugs, listTranslationJobs, type TranslationJob } from '$lib/server/pocketbase';
 import { backendFetch } from '$lib/server/scraper';
 import { log } from '$lib/server/logger';
 
@@ -9,16 +9,18 @@ export const load: PageServerLoad = async ({ locals }) => {
 		redirect(302, '/');
 	}
 
-	const [books, jobs] = await Promise.all([
-		listBooks().catch((e): Awaited<ReturnType<typeof listBooks>> => {
-			log.warn('admin/translation', 'failed to load books', { err: String(e) });
-			return [];
-		}),
-		listTranslationJobs().catch((e): TranslationJob[] => {
-			log.warn('admin/translation', 'failed to load translation jobs', { err: String(e) });
-			return [];
-		})
-	]);
+	// Stream jobs — navigation is instant, list populates shortly after.
+	const jobs = listTranslationJobs().catch((e): TranslationJob[] => {
+		log.warn('admin/translation', 'failed to load translation jobs', { err: String(e) });
+		return [];
+	});
+
+	// Books list is needed immediately for the enqueue form, but use cache so
+	// it's fast on repeat visits.
+	const books = await listBookSlugs().catch((e): Awaited<ReturnType<typeof listBookSlugs>> => {
+		log.warn('admin/translation', 'failed to load book slugs', { err: String(e) });
+		return [];
+	});
 
 	return { books, jobs };
 };

ui/src/routes/admin/translation/+page.svelte

@@ -1,17 +1,16 @@
 <script lang="ts">
-	import { untrack } from 'svelte';
-	import { invalidateAll } from '$app/navigation';
 	import { enhance } from '$app/forms';
 	import type { PageData, ActionData } from './$types';
 	import type { TranslationJob } from '$lib/server/pocketbase';
+	import * as m from '$lib/paraglide/messages.js';
 
 	let { data, form }: { data: PageData; form: ActionData } = $props();
 
-	let jobs = $state<TranslationJob[]>(untrack(() => data.jobs));
+	let jobs = $state<TranslationJob[]>([]);
 
-	// Keep in sync on server reloads
+	// Resolve streamed promise; re-runs on server reloads (invalidateAll)
 	$effect(() => {
-		jobs = data.jobs;
+		Promise.resolve(data.jobs).then((resolved) => { jobs = resolved; });
 	});
 
 	// ── Live-poll while any job is in-flight ─────────────────────────────────────
@@ -19,8 +18,12 @@
 
 	$effect(() => {
 		if (!hasInFlight) return;
-		const id = setInterval(() => {
-			invalidateAll();
+		const id = setInterval(async () => {
+			const res = await fetch('/api/admin/translation-jobs').catch(() => null);
+			if (res?.ok) {
+				const body = await res.json().catch(() => null);
+				if (body?.jobs) jobs = body.jobs;
+			}
 		}, 3000);
 		return () => clearInterval(id);
 	});
@@ -49,6 +52,7 @@
 		if (status === 'running') return 'text-(--color-brand) animate-pulse';
 		if (status === 'pending') return 'text-sky-400 animate-pulse';
 		if (status === 'failed') return 'text-(--color-danger)';
+		if (status === 'cancelled') return 'text-(--color-muted)';
 		return 'text-(--color-text)';
 	}
 
@@ -74,33 +78,91 @@
 	}
 
 	let jobsQ = $state('');
+	let jobsStatusFilter = $state('all');
+	const JOB_STATUS_OPTIONS = ['all', 'running', 'pending', 'done', 'failed', 'cancelled'] as const;
+
 	let filteredJobs = $derived(
-		jobsQ.trim()
-			? jobs.filter(
-					(j) =>
-						j.slug.toLowerCase().includes(jobsQ.toLowerCase().trim()) ||
-						j.lang.toLowerCase().includes(jobsQ.toLowerCase().trim()) ||
-						j.status.toLowerCase().includes(jobsQ.toLowerCase().trim())
-				)
-			: jobs
+		jobs.filter((j: TranslationJob) => {
+			const qLower = jobsQ.trim().toLowerCase();
+			const matchesQ =
+				!qLower ||
+				j.slug.toLowerCase().includes(qLower) ||
+				j.lang.toLowerCase().includes(qLower) ||
+				j.status.toLowerCase().includes(qLower);
+			const matchesStatus = jobsStatusFilter === 'all' || j.status === jobsStatusFilter;
+			return matchesQ && matchesStatus;
+		})
 	);
 
 	let stats = $derived({
 		total: jobs.length,
-		done: jobs.filter((j) => j.status === 'done').length,
-		failed: jobs.filter((j) => j.status === 'failed').length,
-		inFlight: jobs.filter((j) => j.status === 'pending' || j.status === 'running').length
+		done: jobs.filter((j: TranslationJob) => j.status === 'done').length,
+		failed: jobs.filter((j: TranslationJob) => j.status === 'failed').length,
+		running: jobs.filter((j: TranslationJob) => j.status === 'running').length,
+		pending: jobs.filter((j: TranslationJob) => j.status === 'pending').length,
+		cancelled: jobs.filter((j: TranslationJob) => j.status === 'cancelled').length,
+		inFlight: jobs.filter((j: TranslationJob) => j.status === 'pending' || j.status === 'running').length
 	});
+
+	// ── Cancel single job ────────────────────────────────────────────────────────
+	let cancellingJobIds = $state(new Set<string>());
+	let cancelJobErrors: Record<string, string> = $state({});
+
+	async function cancelJob(id: string) {
+		if (cancellingJobIds.has(id)) return;
+		cancellingJobIds = new Set([...cancellingJobIds, id]);
+		delete cancelJobErrors[id];
+		try {
+			const res = await fetch(`/api/admin/ai-jobs/${encodeURIComponent(id)}/cancel`, { method: 'POST' });
+			if (!res.ok) {
+				const body = await res.json().catch(() => ({}));
+				cancelJobErrors = { ...cancelJobErrors, [id]: body.error ?? `Error ${res.status}` };
+			} else {
+				jobs = jobs.map((j: TranslationJob) => j.id === id ? { ...j, status: 'cancelled' } : j);
+			}
+		} catch {
+			cancelJobErrors = { ...cancelJobErrors, [id]: 'Network error.' };
+		} finally {
+			cancellingJobIds = new Set([...cancellingJobIds].filter((x) => x !== id));
+		}
+	}
+
+	// ── Retry failed job ─────────────────────────────────────────────────────────
+	let retryingJobIds = $state(new Set<string>());
+	let retryJobErrors: Record<string, string> = $state({});
+
+	async function retryJob(job: TranslationJob) {
+		if (retryingJobIds.has(job.id)) return;
+		retryingJobIds = new Set([...retryingJobIds, job.id]);
+		delete retryJobErrors[job.id];
+		try {
+			const res = await fetch('/api/admin/translation/bulk', {
+				method: 'POST',
+				headers: { 'content-type': 'application/json' },
+				body: JSON.stringify({ slug: job.slug, lang: job.lang, from: job.chapter, to: job.chapter })
+			});
+			if (!res.ok) {
+				const body = await res.json().catch(() => ({}));
+				retryJobErrors = { ...retryJobErrors, [job.id]: body.error ?? `Error ${res.status}` };
+			} else {
+				jobs = jobs.map((j: TranslationJob) => j.id === job.id ? { ...j, status: 'pending', error_message: '' } : j);
+			}
+		} catch {
+			retryJobErrors = { ...retryJobErrors, [job.id]: 'Network error.' };
+		} finally {
+			retryingJobIds = new Set([...retryingJobIds].filter((x) => x !== job.id));
+		}
+	}
 </script>
 
 <svelte:head>
-	<title>Translation — Admin</title>
+	<title>{m.admin_translation_page_title()}</title>
 </svelte:head>
 
 <div class="space-y-6">
 	<!-- Header -->
 	<div>
-		<h1 class="text-2xl font-bold text-(--color-text)">Machine Translation</h1>
+		<h1 class="text-2xl font-bold text-(--color-text)">{m.admin_translation_heading()}</h1>
 		<p class="text-(--color-muted) text-sm mt-1">
 			{stats.total} job{stats.total !== 1 ? 's' : ''} &middot;
 			<span class="text-green-400">{stats.done} done</span>
@@ -120,14 +182,14 @@
 			class="px-4 py-1.5 rounded-md text-sm font-medium transition-colors
 				{activeTab === 'enqueue' ? 'bg-(--color-surface-3) text-(--color-text)' : 'text-(--color-muted) hover:text-(--color-text)'}"
 		>
-			Enqueue
+			{m.admin_translation_tab_enqueue()}
 		</button>
 		<button
 			onclick={() => (activeTab = 'jobs')}
 			class="px-4 py-1.5 rounded-md text-sm font-medium transition-colors
 				{activeTab === 'jobs' ? 'bg-(--color-surface-3) text-(--color-text)' : 'text-(--color-muted) hover:text-(--color-text)'}"
 		>
-			Jobs
+			{m.admin_translation_tab_jobs()}
 			{#if stats.inFlight > 0}
 				<span
 					class="ml-1.5 inline-flex items-center justify-center w-4 h-4 rounded-full bg-(--color-brand) text-(--color-surface) text-[10px] font-bold"
@@ -245,58 +307,101 @@
 
 	<!-- ── Jobs tab ───────────────────────────────────────────────────────────── -->
 	{#if activeTab === 'jobs'}
-		<input
-			type="search"
-			bind:value={jobsQ}
-			placeholder="Filter by slug, lang, or status…"
-			class="w-full max-w-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg px-3 py-2 text-(--color-text) text-sm placeholder-zinc-500 focus:outline-none focus:ring-2 focus:ring-(--color-brand)"
-		/>
+		<div class="flex flex-wrap gap-3 items-center">
+			<input
+				type="search"
+				bind:value={jobsQ}
+				placeholder={m.admin_translation_filter_placeholder()}
+				class="flex-1 min-w-48 max-w-sm bg-(--color-surface-2) border border-(--color-border) rounded-lg px-3 py-2 text-(--color-text) text-sm placeholder-zinc-500 focus:outline-none focus:ring-2 focus:ring-(--color-brand)"
+			/>
+			<div class="flex gap-1 flex-wrap">
+			{#each JOB_STATUS_OPTIONS as s}
+				{@const count = s === 'all' ? stats.total : (stats as Record<string, number>)[s] ?? 0}
+					<button
+						onclick={() => (jobsStatusFilter = s)}
+						class="px-2.5 py-1 rounded-md text-xs font-medium transition-colors capitalize
+							{jobsStatusFilter === s
+								? 'bg-(--color-brand) text-black'
+								: 'bg-(--color-surface-2) text-(--color-muted) hover:text-(--color-text)'}"
+					>
+						{s}{count > 0 ? ` ${count}` : ''}
+					</button>
+				{/each}
+			</div>
+		</div>
 
 		{#if filteredJobs.length === 0}
 			<p class="text-(--color-muted) text-sm py-8 text-center">
-				{jobsQ.trim() ? 'No matching jobs.' : 'No translation jobs yet.'}
+				{jobsQ.trim() ? m.admin_translation_no_matching() : m.admin_translation_no_jobs()}
 			</p>
 		{:else}
 			<!-- Desktop table -->
 			<div class="hidden sm:block overflow-x-auto rounded-xl border border-(--color-border)">
 				<table class="w-full text-sm">
-					<thead class="bg-(--color-surface-2) text-(--color-muted) text-xs uppercase tracking-wide">
-						<tr>
-							<th class="px-4 py-3 text-left">Book</th>
-							<th class="px-4 py-3 text-right">Ch.</th>
-							<th class="px-4 py-3 text-left">Lang</th>
-							<th class="px-4 py-3 text-left">Status</th>
-							<th class="px-4 py-3 text-left">Started</th>
-							<th class="px-4 py-3 text-left">Duration</th>
+				<thead class="bg-(--color-surface-2) text-(--color-muted) text-xs uppercase tracking-wide">
+					<tr>
+						<th class="px-4 py-3 text-left">Book</th>
+						<th class="px-4 py-3 text-right">Ch.</th>
+						<th class="px-4 py-3 text-left">Lang</th>
+						<th class="px-4 py-3 text-left">Status</th>
+						<th class="px-4 py-3 text-left">Started</th>
+						<th class="px-4 py-3 text-left">Duration</th>
+						<th class="px-4 py-3 text-left">Actions</th>
+					</tr>
+				</thead>
+				<tbody class="divide-y divide-(--color-border)/50">
+					{#each filteredJobs as job}
+						<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/50 transition-colors">
+							<td class="px-4 py-3 text-(--color-text) font-medium">
+								<a href="/books/{job.slug}" class="hover:text-(--color-brand) transition-colors"
+									>{job.slug}</a
+								>
+							</td>
+							<td class="px-4 py-3 text-right text-(--color-muted)">{job.chapter}</td>
+							<td class="px-4 py-3 text-(--color-muted) font-mono text-xs uppercase">{job.lang}</td>
+							<td class="px-4 py-3">
+								<span class="font-medium {jobStatusColor(job.status)}">{job.status}</span>
+							</td>
+							<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{fmtDate(job.started)}</td>
+							<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap"
+								>{duration(job.started, job.finished)}</td
+							>
+						<td class="px-4 py-3">
+							{#if job.status === 'pending' || job.status === 'running'}
+								<button
+									onclick={() => cancelJob(job.id)}
+									disabled={cancellingJobIds.has(job.id)}
+									class="px-2 py-1 rounded text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
+								>
+									{cancellingJobIds.has(job.id) ? 'Cancelling…' : 'Cancel'}
+								</button>
+							{/if}
+							{#if job.status === 'failed'}
+								<button
+									onclick={() => retryJob(job)}
+									disabled={retryingJobIds.has(job.id)}
+									class="px-2 py-1 rounded text-xs font-medium bg-sky-400/10 text-sky-400 hover:bg-sky-400/20 disabled:opacity-50 transition-colors"
+								>
+									{retryingJobIds.has(job.id) ? 'Retrying…' : 'Retry ↺'}
+								</button>
+							{/if}
+							{#if cancelJobErrors[job.id]}
+								<p class="text-xs text-(--color-danger) mt-1">{cancelJobErrors[job.id]}</p>
+							{/if}
+							{#if retryJobErrors[job.id]}
+								<p class="text-xs text-(--color-danger) mt-1">{retryJobErrors[job.id]}</p>
+							{/if}
+						</td>
 						</tr>
-					</thead>
-					<tbody class="divide-y divide-(--color-border)/50">
-						{#each filteredJobs as job}
-							<tr class="bg-(--color-surface) hover:bg-(--color-surface-2)/50 transition-colors">
-								<td class="px-4 py-3 text-(--color-text) font-medium">
-									<a href="/books/{job.slug}" class="hover:text-(--color-brand) transition-colors"
-										>{job.slug}</a
-									>
-								</td>
-								<td class="px-4 py-3 text-right text-(--color-muted)">{job.chapter}</td>
-								<td class="px-4 py-3 text-(--color-muted) font-mono text-xs uppercase">{job.lang}</td>
-								<td class="px-4 py-3">
-									<span class="font-medium {jobStatusColor(job.status)}">{job.status}</span>
-								</td>
-								<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap">{fmtDate(job.started)}</td>
-								<td class="px-4 py-3 text-(--color-muted) whitespace-nowrap"
-									>{duration(job.started, job.finished)}</td
+						{#if job.error_message}
+							<tr class="bg-(--color-danger)/10">
+								<td colspan="7" class="px-4 py-2 text-xs text-(--color-danger) font-mono"
+									>{job.error_message}</td
 								>
 							</tr>
-							{#if job.error_message}
-								<tr class="bg-(--color-danger)/10">
-									<td colspan="6" class="px-4 py-2 text-xs text-(--color-danger) font-mono"
-										>{job.error_message}</td
-									>
-								</tr>
-							{/if}
-						{/each}
-					</tbody>
+						{/if}
+					{/each}
+				</tbody>
 				</table>
 			</div>
 
@@ -329,9 +434,33 @@
 								class="text-(--color-muted) text-right">{duration(job.started, job.finished)}</span
 							>
 						</div>
-						{#if job.error_message}
-							<p class="text-xs text-(--color-danger) font-mono break-all">{job.error_message}</p>
-						{/if}
+					{#if job.error_message}
+						<p class="text-xs text-(--color-danger) font-mono break-all">{job.error_message}</p>
+					{/if}
+					{#if job.status === 'pending' || job.status === 'running'}
+						<button
+							onclick={() => cancelJob(job.id)}
+							disabled={cancellingJobIds.has(job.id)}
+							class="w-full px-3 py-1.5 rounded-lg text-xs font-medium bg-(--color-danger)/10 text-(--color-danger) hover:bg-(--color-danger)/20 disabled:opacity-50 transition-colors"
+						>
+							{cancellingJobIds.has(job.id) ? 'Cancelling…' : 'Cancel'}
+						</button>
+					{/if}
+					{#if job.status === 'failed'}
+						<button
+							onclick={() => retryJob(job)}
+							disabled={retryingJobIds.has(job.id)}
+							class="w-full px-3 py-1.5 rounded-lg text-xs font-medium bg-sky-400/10 text-sky-400 hover:bg-sky-400/20 disabled:opacity-50 transition-colors"
+						>
+							{retryingJobIds.has(job.id) ? 'Retrying…' : 'Retry ↺'}
+						</button>
+					{/if}
+					{#if cancelJobErrors[job.id]}
+						<p class="text-xs text-(--color-danger)">{cancelJobErrors[job.id]}</p>
+					{/if}
+					{#if retryJobErrors[job.id]}
+						<p class="text-xs text-(--color-danger)">{retryJobErrors[job.id]}</p>
+					{/if}
 					</div>
 				{/each}
 			</div>

ui/src/routes/api/admin/audio-jobs/+server.ts

@@ -0,0 +1,16 @@
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { listAudioJobs } from '$lib/server/pocketbase';
+
+/**
+ * GET /api/admin/audio-jobs
+ * Returns the current audio jobs list (served from 30 s Valkey cache).
+ * Used by the admin audio page for lightweight polling instead of invalidateAll().
+ */
+export const GET: RequestHandler = async ({ locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+	const jobs = await listAudioJobs().catch(() => []);
+	return json({ jobs });
+};

ui/src/routes/api/admin/image-gen/save-chapter-image/+server.ts

@@ -0,0 +1,35 @@
+/**
+ * POST /api/admin/image-gen/save-chapter-image
+ *
+ * Admin-only proxy: persists a pre-generated base64 image as a chapter
+ * illustration in MinIO without re-calling Cloudflare AI.
+ *
+ * Body: { slug: string, chapter: number, image_b64: string }
+ */
+
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { log } from '$lib/server/logger';
+import { backendFetch } from '$lib/server/scraper';
+
+export const POST: RequestHandler = async ({ request, locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+
+	const body = await request.text();
+	let res: Response;
+	try {
+		res = await backendFetch('/api/admin/image-gen/save-chapter-image', {
+			method: 'POST',
+			headers: { 'content-type': 'application/json' },
+			body
+		});
+	} catch (e) {
+		log.error('admin/image-gen/save-chapter-image', 'backend proxy error', { err: String(e) });
+		throw error(502, 'Could not reach backend');
+	}
+
+	const data = await res.json().catch(() => ({}));
+	return json(data, { status: res.status });
+};

ui/src/routes/api/admin/import/+server.ts

@@ -0,0 +1,57 @@
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { backendFetch } from '$lib/server/scraper';
+
+/**
+ * GET /api/admin/import
+ * List all import tasks.
+ */
+export const GET: RequestHandler = async ({ locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+	const res = await backendFetch('/api/admin/import', { method: 'GET' });
+	const data = await res.json().catch(() => ({ tasks: [] }));
+	return json(data);
+};
+
+/**
+ * POST /api/admin/import
+ * Create a new import task. Supports both multipart/form-data (file upload)
+ * and application/json (object key reference).
+ */
+export const POST: RequestHandler = async ({ request, locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+
+	const ct = request.headers.get('content-type') ?? '';
+
+	let res: Response;
+
+	if (ct.includes('multipart/form-data')) {
+		// Forward the raw FormData body; let the browser-set Content-Type
+		// (which includes the boundary) pass through unchanged.
+		const formData = await request.formData();
+		res = await backendFetch('/api/admin/import', {
+			method: 'POST',
+			// Do NOT set Content-Type manually — the fetch API sets it
+			// automatically with the correct boundary when given a FormData body.
+			body: formData
+		});
+	} else {
+		const body = await request.json();
+		res = await backendFetch('/api/admin/import', {
+			method: 'POST',
+			headers: { 'Content-Type': 'application/json' },
+			body: JSON.stringify(body)
+		});
+	}
+
+	if (!res.ok) {
+		const err = await res.json().catch(() => ({ error: 'Failed to create import task' }));
+		throw error(res.status, err.error || 'Failed to create import task');
+	}
+	const data = await res.json();
+	return json(data);
+};

ui/src/routes/api/admin/scrape-tasks/+server.ts

@@ -0,0 +1,16 @@
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { listScrapingTasks } from '$lib/server/pocketbase';
+
+/**
+ * GET /api/admin/scrape-tasks
+ * Returns the current scraping task list (served from 30 s Valkey cache).
+ * Used by the admin scrape page for lightweight polling instead of invalidateAll().
+ */
+export const GET: RequestHandler = async ({ locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+	const tasks = await listScrapingTasks().catch(() => []);
+	return json({ tasks });
+};

ui/src/routes/api/admin/translation-jobs/+server.ts

@@ -0,0 +1,16 @@
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { listTranslationJobs } from '$lib/server/pocketbase';
+
+/**
+ * GET /api/admin/translation-jobs
+ * Returns the current translation jobs list (served from 30 s Valkey cache).
+ * Used by the admin translation page for lightweight polling instead of invalidateAll().
+ */
+export const GET: RequestHandler = async ({ locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+	const jobs = await listTranslationJobs().catch(() => []);
+	return json({ jobs });
+};

ui/src/routes/api/admin/translation/bulk/+server.ts

@@ -0,0 +1,34 @@
+/**
+ * POST /api/admin/translation/bulk
+ *
+ * Admin-only proxy to the Go backend's translation bulk-enqueue endpoint.
+ * Body: { slug, lang, from, to }
+ * Response 200: { enqueued }
+ */
+
+import { json, error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { log } from '$lib/server/logger';
+import { backendFetch } from '$lib/server/scraper';
+
+export const POST: RequestHandler = async ({ request, locals }) => {
+	if (!locals.user || locals.user.role !== 'admin') {
+		throw error(403, 'Forbidden');
+	}
+
+	const body = await request.text();
+	let res: Response;
+	try {
+		res = await backendFetch('/api/admin/translation/bulk', {
+			method: 'POST',
+			headers: { 'content-type': 'application/json' },
+			body
+		});
+	} catch (e) {
+		log.error('api/admin/translation/bulk', 'backend proxy error', { err: String(e) });
+		throw error(502, 'Could not reach backend');
+	}
+
+	const data = await res.json().catch(() => ({}));
+	return json(data, { status: res.status });
+};

ui/src/routes/api/announce/+server.ts

@@ -0,0 +1,39 @@
+import { error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { backendFetch } from '$lib/server/scraper';
+
+/**
+ * GET /api/announce?text=...&voice=...&format=...
+ *
+ * Thin proxy to backend GET /api/tts-announce.
+ * No paywall — this is a short announcement clip (a few words), not chapter audio.
+ * No MinIO caching — the backend streams the clip directly.
+ */
+export const GET: RequestHandler = async ({ url }) => {
+	const text = url.searchParams.get('text') ?? '';
+	if (!text) error(400, 'text is required');
+
+	const qs = new URLSearchParams();
+	qs.set('text', text);
+
+	const voice = url.searchParams.get('voice');
+	if (voice) qs.set('voice', voice);
+
+	const format = url.searchParams.get('format') ?? 'mp3';
+	qs.set('format', format);
+
+	const backendRes = await backendFetch(`/api/tts-announce?${qs}`);
+
+	if (!backendRes.ok) {
+		error(backendRes.status as Parameters<typeof error>[0], 'TTS announce failed');
+	}
+
+	return new Response(backendRes.body, {
+		status: 200,
+		headers: {
+			'Content-Type': backendRes.headers.get('Content-Type') ?? 'audio/mpeg',
+			'Cache-Control': 'no-store',
+			'X-Accel-Buffering': 'no'
+		}
+	});
+};

ui/src/routes/api/auth/logout/+server.ts

@@ -1,15 +1,24 @@
 import { json } from '@sveltejs/kit';
 import type { RequestHandler } from './$types';
+import { parseAuthToken } from '../../../../hooks.server.js';
+import { deleteSessionByAuthId } from '$lib/server/pocketbase';
 
 const AUTH_COOKIE = 'libnovel_auth';
 
 /**
  * POST /api/auth/logout
- * Clears the auth cookie and returns { ok: true }.
- * Does not revoke the session record from PocketBase —
- * for full revocation use DELETE /api/sessions/[id] first.
+ * Deletes the session row from PocketBase AND clears the auth cookie, so the
+ * session doesn't linger as a phantom "active session" after sign-out.
  */
 export const POST: RequestHandler = async ({ cookies }) => {
+	const token = cookies.get(AUTH_COOKIE);
+	if (token) {
+		const user = parseAuthToken(token);
+		if (user?.authSessionId) {
+			// Best-effort — non-fatal if PocketBase is unreachable.
+			deleteSessionByAuthId(user.authSessionId).catch(() => {});
+		}
+	}
 	cookies.delete(AUTH_COOKIE, { path: '/' });
 	return json({ ok: true });
 };

ui/src/routes/api/chapter-image/[domain]/[slug]/[n]/+server.ts

@@ -0,0 +1,55 @@
+/**
+ * GET /api/chapter-image/[domain]/[slug]/[n]
+ * HEAD /api/chapter-image/[domain]/[slug]/[n]
+ *
+ * Proxies chapter illustration images from the Go backend.
+ * HEAD returns 200/404 to check existence; GET returns the full image bytes.
+ * Returns 404 when no image has been saved for this chapter.
+ */
+
+import { error } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { backendFetch } from '$lib/server/scraper';
+
+async function proxyChapterImage({ params, method }: { params: { domain: string; slug: string; n: string }; method: string }) {
+	const { domain, slug, n } = params;
+
+	let res: Response;
+	try {
+		res = await backendFetch(
+			`/api/chapter-image/${encodeURIComponent(domain)}/${encodeURIComponent(slug)}/${encodeURIComponent(n)}`,
+			{ method }
+		);
+	} catch {
+		throw error(502, 'Could not reach backend');
+	}
+
+	if (res.status === 404) {
+		throw error(404, 'No chapter image found');
+	}
+	if (!res.ok) {
+		throw error(res.status, 'Could not fetch chapter image');
+	}
+
+	if (method === 'HEAD') {
+		return new Response(null, {
+			status: 200,
+			headers: { 'Cache-Control': 'no-store' }
+		});
+	}
+
+	const contentType = res.headers.get('content-type') ?? 'image/jpeg';
+	const data = await res.arrayBuffer();
+
+	return new Response(data, {
+		status: 200,
+		headers: {
+			'Content-Type': contentType,
+			'Cache-Control': 'public, max-age=31536000, immutable',
+			'Content-Length': String(data.byteLength)
+		}
+	});
+}
+
+export const GET: RequestHandler = ({ params }) => proxyChapterImage({ params, method: 'GET' });
+export const HEAD: RequestHandler = ({ params }) => proxyChapterImage({ params, method: 'HEAD' });