Restructure chat service, web routes, and add test suite

Split monolithic chat service into modular structure with Matrix client
support, extract web server into per-resource route modules, introduce
bootstrap/main-loop separation, and add comprehensive vitest coverage
across services, repositories, and utilities. Adds project docs and
CLAUDE.md agent instructions.

docker-compose.yml

@@ -8,9 +8,14 @@ services:
     # Mount the data directory to persist the database and browser session
     volumes:
       - ./data:/app/data
-    # Environment variables
+    ports:
+      - "3000:3000"   # Web dashboard
+      - "6080:6080"   # noVNC for human login
     environment:
       - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
       - REDDIT_USERNAME=${REDDIT_USERNAME}
       - REDDIT_PASSWORD=${REDDIT_PASSWORD}
-      - BROWSER_HEADLESS=true
+      # Chromium runs headed under Xvfb so a human can complete login over noVNC.
+      - BROWSER_HEADLESS=false
+      # Required to lock down the VNC endpoint.
+      - VNC_PASSWORD=${VNC_PASSWORD}