feat(container): M-Box 1-8 — stack-agnostic standalone Docker container

Shade now ships as a self-contained Docker image. Deploy one container
per project, any stack (Bun, Python, Go, Rust, Kotlin) can talk to it via
plain HTTP. Zero coupling to consumer codebases.

M-Box 1: Stale identity cleanup API
- touchIdentity + purgeStaleIdentities on PrekeyStore interface
- Implemented for Memory, SQLite, and Postgres backends
- SQLite adds last_activity_at column with migration ALTER for existing DBs
- Postgres adds the same via raw SQL with IF NOT EXISTS guards
- Routes call touchIdentity on register, bundle fetch, replenish
- 4 new tests for the cleanup API

M-Box 2: Stale cleanup background task
- StaleCleanupTask runs purge on startup + every 24h (configurable)
- Reads SHADE_STALE_DAYS (default 30) and SHADE_CLEANUP_INTERVAL_HOURS
- Wired into standalone.ts, stopped on graceful shutdown
- 5 new tests for the task

M-Box 3: Observer baked into the container
- standalone.ts conditionally mounts @shade/observer at /shade-observer
  when SHADE_OBSERVER_TOKEN is set (and >= 16 chars)
- Shared PrekeyServerEvents emitter feeds both routes and observer
- @shade/observer added as optional dependency of @shade/server

M-Box 4: Dockerfile with dashboard build
- Multi-stage build: oven/bun:1 builder → oven/bun:1-alpine runtime
- COPY packages/ wholesale so workspace lockfile resolves cleanly
- RUN bun run build inside shade-dashboard → dist/ → observer/dist/
- Non-root shade user, /data volume, healthcheck, env defaults
- Final image: 260 MB

M-Box 5: OpenAPI spec for stack-agnostic clients
- packages/shade-server/openapi.yaml documents all 9 endpoints with
  request/response schemas, security (Ed25519 signatures + bearer token)
- createOpenApiRoutes serves /openapi.yaml and /docs (Redoc viewer)
- Any language can generate a client with openapi-generator

M-Box 6: Docker CI pipeline
- .gitea/workflows/docker.yml builds + pushes on git tag v*
- scripts/build-docker.ts for local builds, supports --push with GITEA_TOKEN
- Root package.json: build:docker, publish:docker scripts

M-Box 7: Deployment documentation
- packages/shade-server/README rewritten: 5-line quickstart with the image
- docs/DEPLOYMENT.md: full reference, env vars, backup, Dokploy, PG setup
- examples/05-dokploy-deployment/docker-compose.yml updated to pull
  published image (gt.zyon.no/stian/shade-prekey:latest)
- Root README deployment section rewritten

M-Box 8: End-to-end verification
- Image builds locally (bun run build:docker)
- /health, /openapi.yaml, /docs, /metrics, /shade-observer all respond
- 401 without observer token, 200 with
- Real SDK client round-trip: Alice → container → Bob → reply → Alice
- Persistence: identity + prekeys survive container restart (count 20→18
  as expected from two bundle fetches)

285 tests passing, 0 failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

packages/shade-server/Dockerfile

@@ -3,28 +3,27 @@ FROM oven/bun:1 AS builder
 
 WORKDIR /build
 
-# Copy workspace root
-COPY package.json bun.lock ./
-COPY tsconfig.json ./
+# Copy workspace root config
+COPY package.json bun.lock tsconfig.json ./
 
-# Copy all packages we depend on
-COPY packages/shade-core ./packages/shade-core
-COPY packages/shade-crypto-web ./packages/shade-crypto-web
-COPY packages/shade-server ./packages/shade-server
-COPY packages/shade-storage-sqlite ./packages/shade-storage-sqlite
-COPY packages/shade-storage-postgres ./packages/shade-storage-postgres
+# Copy all packages the server + observer + dashboard need
+COPY packages ./packages
 
 RUN bun install --frozen-lockfile
 
+# Build the dashboard SPA → dist/, then copy to observer's dist/
+RUN cd packages/shade-dashboard && bun run build
+
 # ─── Production stage ───────────────────────────────────────
 FROM oven/bun:1-alpine
 
 LABEL org.opencontainers.image.title="Shade Prekey Server"
-LABEL org.opencontainers.image.description="E2EE prekey distribution server (Signal Protocol)"
-LABEL org.opencontainers.image.source="https://github.com/Sterister/Shade"
+LABEL org.opencontainers.image.description="E2EE prekey distribution server with live observer (Signal Protocol)"
+LABEL org.opencontainers.image.source="https://gt.zyon.no/Stian/Shade"
 LABEL org.opencontainers.image.licenses="MIT"
+LABEL org.opencontainers.image.vendor="Stian"
 
-# Install curl for healthcheck
+# curl for healthcheck
 RUN apk add --no-cache curl
 
 # Non-root user
@@ -33,7 +32,7 @@ RUN addgroup -S shade && adduser -S shade -G shade
 WORKDIR /app
 COPY --from=builder --chown=shade:shade /build /app
 
-# Persistent data directory
+# Persistent data directory (SQLite file or any sidecar state)
 RUN mkdir -p /data && chown shade:shade /data
 VOLUME ["/data"]
 
@@ -41,9 +40,12 @@ USER shade
 
 EXPOSE 3900
 
-# Default to SQLite on the persistent volume
+# Defaults — override via `docker run -e`
 ENV SHADE_PREKEY_DB_PATH=/data/shade-prekeys.db
 ENV PORT=3900
+ENV SHADE_LOG_LEVEL=info
+ENV SHADE_STALE_DAYS=30
+ENV SHADE_CLEANUP_INTERVAL_HOURS=24
 
 HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
   CMD curl -fsS http://localhost:${PORT}/health || exit 1