feat(skills): skill lifecycle + ms-* skill set completion (#40 , #41 , #42 )

- scripts/skill.sh: install (bundled or path) / activate / deactivate / uninstall (refuses while enabled) / list - skills-enabled + skills-available dirs under the data root; a skill not in skills-enabled is not enabled or available for use - pi adapter: MOSAIC_SKILLS -> --skill per dir; --no-skills when none - agent.sh: seat definitions declare skills[]; resolution against skills-enabled refuses the launch loudly when missing - ms-* skills completed (owner-authored canon, hands-off): ms-tools adapted to the runtime, ms-file-read/write/agent/conductor bodies written in the owner's style; ms-agent-watch + ms-unslop untouched - tasks/USER.md onboarding fixtures; suite hardening (nested def path, user seed, mock-adapter dispatch evidence) Suites: config 24, task 74, release 14, conductor 17, verify PASS. RELEASE 0.0.12 packaged; health-gated activation on merge. Closes #40, closes #41, closes #42
Merge: skill lifecycle, skills completion, M16 self-determination hardening, M20 decision
2026-09-03 16:23:57 -05:00 · 2026-09-03 16:03:05 -05:00 · 2026-09-03 15:58:46 -05:00 · 2026-09-03 14:50:59 -05:00 · 2026-09-03 14:43:25 -05:00 · 2026-09-03 14:42:09 -05:00
1400 changed files with 10300 additions and 220020 deletions
@@ -1,154 +1,24 @@
-# ─────────────────────────────────────────────────────────────────────────────
-# Mosaic — Environment Variables Reference
-# Copy this file to .env and fill in the values for your deployment.
-# Lines beginning with # are comments; optional vars are commented out.
-# ─────────────────────────────────────────────────────────────────────────────
+# Non-secret runtime settings for the mosaic-poc-agent container.
+# Copy to .env if you want to override the defaults in compose.yaml.
+#
+# NEVER put credentials in this file. Authentication is supplied at
+# runtime only, via one of the two documented paths:
+#   1. read-only mounted pi auth file (default: ~/.pi/agent/auth.json,
+#      override the host path with PI_AUTH_FILE)
+#   2. provider API key environment variable (ZAI_API_KEY or
+#      ANTHROPIC_API_KEY), passed through by compose.yaml when set

+# Model provider (built-in pi provider name)
+PI_PROVIDER=zai

-# ─── Database (PostgreSQL 17 + pgvector) ─────────────────────────────────────
-# Full connection string used by the gateway, ORM, and migration runner.
-# Port 5433 avoids conflict with a host-side PostgreSQL instance.
-DATABASE_URL=postgresql://mosaic:mosaic@localhost:5433/mosaic
+# Model ID within the provider
+PI_MODEL=glm-5.3-flash

-# Docker Compose host-port override for the PostgreSQL container (default: 5433)
-# PG_HOST_PORT=5433
+# Optional: alternative host path of the pi credential file mounted
+# read-only at /home/node/.pi/agent/auth.json in the container
+#PI_AUTH_FILE=/home/jwoltje/.pi/agent/auth.json

-
-# ─── Queue (Valkey 8 / Redis-compatible) ─────────────────────────────────────
-# Port 6380 avoids conflict with a host-side Redis/Valkey instance.
-VALKEY_URL=redis://localhost:6380
-
-# Docker Compose host-port override for the Valkey container (default: 6380)
-# VALKEY_HOST_PORT=6380
-
-
-# ─── Gateway ─────────────────────────────────────────────────────────────────
-# TCP port the NestJS/Fastify gateway listens on (default: 14242)
-GATEWAY_PORT=14242
-
-# Comma-separated list of allowed CORS origins.
-# Must include the web app origin in production.
-GATEWAY_CORS_ORIGIN=http://localhost:3000
-
-
-# ─── Auth (BetterAuth) ───────────────────────────────────────────────────────
-# REQUIRED — random secret used to sign sessions and tokens.
-# Generate with: openssl rand -base64 32
-BETTER_AUTH_SECRET=change-me-to-a-random-32-char-string
-
-# Public base URL of the gateway (used by BetterAuth for callback URLs)
-BETTER_AUTH_URL=http://localhost:14242
-
-
-# ─── Web App (Next.js) ───────────────────────────────────────────────────────
-# Public gateway URL — accessible from the browser, not just the server.
-NEXT_PUBLIC_GATEWAY_URL=http://localhost:14242
-
-
-# ─── OpenTelemetry ───────────────────────────────────────────────────────────
-# OTLP HTTP endpoint (otel-collector or any OpenTelemetry-compatible backend)
-OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
-
-# Service name shown in traces
-OTEL_SERVICE_NAME=mosaic-gateway
-
-
-# ─── AI Providers ────────────────────────────────────────────────────────────
-
-# Ollama (local models — set OLLAMA_BASE_URL to enable)
-# OLLAMA_BASE_URL=http://localhost:11434
-# OLLAMA_HOST is a legacy alias for OLLAMA_BASE_URL
-# OLLAMA_HOST=http://localhost:11434
-# Comma-separated list of Ollama model IDs to register (default: llama3.2,codellama,mistral)
-# OLLAMA_MODELS=llama3.2,codellama,mistral
-
-# Anthropic (claude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-5)
-# ANTHROPIC_API_KEY=sk-ant-...
-
-# OpenAI (gpt-4o, gpt-4o-mini, o3-mini)
-# OPENAI_API_KEY=sk-...
-
-# Z.ai / GLM (glm-4.5, glm-4.5-air, glm-4.5-flash)
-# ZAI_API_KEY=...
-
-# Custom providers — JSON array of provider configs
-# Format: [{"id":"<id>","baseUrl":"<url>","apiKey":"<key>","models":[{"id":"<model-id>","name":"<label>"}]}]
-# MOSAIC_CUSTOM_PROVIDERS=
-
-
-# ─── Embedding Service ───────────────────────────────────────────────────────
-# OpenAI-compatible embeddings endpoint (default: OpenAI)
-# EMBEDDING_API_URL=https://api.openai.com/v1
-# EMBEDDING_MODEL=text-embedding-3-small
-
-
-# ─── Log Summarization Service ───────────────────────────────────────────────
-# OpenAI-compatible chat completions endpoint for log summarization (default: OpenAI)
-# SUMMARIZATION_API_URL=https://api.openai.com/v1
-# SUMMARIZATION_MODEL=gpt-4o-mini
-
-# Cron schedule for summarization job (default: every 6 hours)
-# SUMMARIZATION_CRON=0 */6 * * *
-
-# Cron schedule for log tier management (default: daily at 03:00)
-# TIER_MANAGEMENT_CRON=0 3 * * *
-
-
-# ─── Agent ───────────────────────────────────────────────────────────────────
-# Filesystem sandbox root for agent file tools (default: process.cwd())
-# AGENT_FILE_SANDBOX_DIR=/var/lib/mosaic/sandbox
-
-# Comma-separated list of tool names available to non-admin users.
-# Leave unset to allow all tools for all authenticated users.
-# AGENT_USER_TOOLS=read_file,list_directory,search_files
-
-# System prompt injected into every agent session (optional)
-# AGENT_SYSTEM_PROMPT=You are a helpful assistant.
-
-
-# ─── MCP Servers ─────────────────────────────────────────────────────────────
-# JSON array of MCP server configs — set to enable MCP tool integration.
-# Each entry: {"name":"<id>","url":"<http-or-sse-url>"}
-# MCP_SERVERS=[{"name":"my-mcp","url":"http://localhost:3100/sse"}]
-
-
-# ─── Coordinator ─────────────────────────────────────────────────────────────
-# Root directory used to scope coordinator (worktree/repo) operations.
-# Defaults to the monorepo root auto-detected from process.cwd().
-# MOSAIC_WORKSPACE_ROOT=/home/user/projects/mosaic
-
-
-# ─── Discord Plugin (optional — set DISCORD_BOT_TOKEN to enable) ─────────────
-# DISCORD_BOT_TOKEN=
-# DISCORD_GUILD_ID=
-# DISCORD_GATEWAY_URL=http://localhost:14242
-
-
-# ─── Telegram Plugin (optional — set TELEGRAM_BOT_TOKEN to enable) ───────────
-# TELEGRAM_BOT_TOKEN=
-# TELEGRAM_GATEWAY_URL=http://localhost:14242
-
-
-# ─── SSO Providers (add credentials to enable) ───────────────────────────────
-
-# --- Authentik (optional — set AUTHENTIK_CLIENT_ID to enable) ---
-# AUTHENTIK_ISSUER=https://auth.example.com/application/o/mosaic/
-# AUTHENTIK_CLIENT_ID=
-# AUTHENTIK_CLIENT_SECRET=
-
-# --- WorkOS (optional — set WORKOS_CLIENT_ID to enable) ---
-# WORKOS_ISSUER=https://your-company.authkit.app
-# WORKOS_CLIENT_ID=client_...
-# WORKOS_CLIENT_SECRET=sk_live_...
-
-# --- Keycloak (optional — set KEYCLOAK_CLIENT_ID to enable) ---
-# KEYCLOAK_ISSUER=https://auth.example.com/realms/master
-# Legacy alternative if you prefer to compose the issuer from separate vars:
-# KEYCLOAK_URL=https://auth.example.com
-# KEYCLOAK_REALM=master
-# KEYCLOAK_CLIENT_ID=mosaic
-# KEYCLOAK_CLIENT_SECRET=
-
-# Feature flags — set to true alongside provider credentials to show SSO buttons in the UI
-# NEXT_PUBLIC_WORKOS_ENABLED=true
-# NEXT_PUBLIC_KEYCLOAK_ENABLED=true
+# Optional: documented env-var auth alternative (secret! set in your
+# shell or a gitignored .env, never commit)
+#ZAI_API_KEY=
+#ANTHROPIC_API_KEY=
@@ -1,24 +1,8 @@
-logs/
-node_modules
-dist
-.turbo
-.next
-coverage
+# build/deps
+node_modules/
+
+# runtime credentials — never commit, never copy into the image
 .env
-.env.local
-*.tsbuildinfo
-.pnpm-store
-docs/reports/
+secrets/

-# Step-CA dev password — real file is gitignored; commit only the .example
-infra/step-ca/dev-password
-
-# Scratch dirs created by the framework git-wrapper shell test harnesses
-.mosaic-test-work/
-
-# Transient config files vite/vitest/esbuild write next to a *.config.ts while
-# loading it, then unlink. They are untracked but were not ignored, so turbo's
-# package traversal hashed them and intermittently failed CI with "Package
-# traversal error: ... .timestamp-*.mjs: No such file or directory" when the
-# file vanished mid-scan. Ignoring them removes the race.
-*.timestamp-*.mjs
+# generated runtime state lives in /home/jwoltje/.mosaic-dev (outside this project)
@@ -1 +0,0 @@
-npx lint-staged
@@ -1 +0,0 @@
-pnpm typecheck && pnpm lint && pnpm format:check
@@ -1,9 +0,0 @@
-{
-  "**/*.{ts,tsx,js,jsx}": [
-    "prettier --write",
-    "eslint --fix"
-  ],
-  "**/*.{json,md,yaml,yml}": [
-    "prettier --write"
-  ]
-}
@@ -1,78 +0,0 @@
-# Repo Mosaic Linkage
-
-This repository is attached to the machine-wide Mosaic framework.
-
-## Load Order for Agents
-
-1. `~/.config/mosaic/STANDARDS.md`
-2. `AGENTS.md` (this repository)
-3. `.mosaic/repo-hooks.sh` (repo-specific automation hooks)
-
-## Purpose
-
- Keep universal standards in `~/.config/mosaic`
- Keep repo-specific behavior in this repo
- Avoid copying large runtime configs into each project
-
-## Optional Quality Rails
-
-Use `.mosaic/quality-rails.yml` to track whether quality rails are enabled for this repo.
-
-Apply a template:
-
-```bash
-~/.config/mosaic/bin/mosaic-quality-apply --template <template> --target .
-```
-
-Verify enforcement:
-
-```bash
-~/.config/mosaic/bin/mosaic-quality-verify --target .
-```
-
-## Optional Matrix Orchestrator Rail
-
-Repo-local orchestrator state lives in `.mosaic/orchestrator/`.
-
-Run one cycle:
-
-```bash
-~/.config/mosaic/bin/mosaic-orchestrator-matrix-cycle
-~/.config/mosaic/bin/mosaic-orchestrator-run --once
-```
-
-Run continuously:
-
-```bash
-~/.config/mosaic/bin/mosaic-orchestrator-run --poll-sec 10
-```
-
-Bridge events to Matrix:
-
-```bash
-~/.config/mosaic/bin/mosaic-orchestrator-matrix-publish
-~/.config/mosaic/bin/mosaic-orchestrator-matrix-consume
-```
-
-Run until queue is drained (syncs from `docs/tasks.md` first):
-
-```bash
-~/.config/mosaic/bin/mosaic-orchestrator-drain
-```
-
-Set worker command if auto-detect does not match your CLI:
-
-```bash
-export MOSAIC_WORKER_EXEC="codex -p"
-# or
-export MOSAIC_WORKER_EXEC="opencode -p"
-```
-
-Use repo helper (foreground or detached):
-
-```bash
-bash scripts/agent/orchestrator-daemon.sh drain
-bash scripts/agent/orchestrator-daemon.sh start
-bash scripts/agent/orchestrator-daemon.sh status
-bash scripts/agent/orchestrator-daemon.sh stop
-```
@@ -1,18 +0,0 @@
-{
-  "enabled": false,
-  "transport": "matrix",
-  "matrix": {
-    "control_room_id": "",
-    "workspace_id": "",
-    "homeserver_url": "",
-    "access_token": "",
-    "bot_user_id": ""
-  },
-  "worker": {
-    "runtime": "codex",
-    "command_template": "bash scripts/agent/orchestrator-worker.sh {task_file}",
-    "timeout_seconds": 7200,
-    "max_attempts": 1
-  },
-  "quality_gates": ["pnpm lint", "pnpm typecheck", "pnpm test"]
-}
@@ -1 +0,0 @@
-
@@ -1,4 +0,0 @@
-{
-  "last_published_line": 0,
-  "since": null
-}
@@ -1,14 +0,0 @@
-{
-  "schema_version": 1,
-  "mission_id": "mvp-20260312",
-  "name": "MVP",
-  "description": "",
-  "project_path": "/home/jwoltje/src/mosaic-mono-v1",
-  "created_at": "2026-03-13T00:44:02Z",
-  "status": "active",
-  "task_prefix": "",
-  "quality_gates": "",
-  "milestone_version": "0.0.1",
-  "milestones": [],
-  "sessions": []
-}
@@ -1,19 +0,0 @@
-{
-  "generated_at": "2026-03-13T00:44:51Z",
-  "runtime": "claude",
-  "mission_id": "mvp-20260312",
-  "mission_name": "MVP",
-  "project_path": "/home/jwoltje/src/mosaic-mono-v1",
-  "quality_gates": "",
-  "current_milestone": {
-    "id": "",
-    "name": ""
-  },
-  "next_task": "",
-  "progress": {
-    "tasks_done": 0,
-    "tasks_total": 0,
-    "pct": 0
-  },
-  "current_branch": ""
-}
@@ -1 +0,0 @@
-
@@ -1,8 +0,0 @@
-{
-  "session_id": "claude-20260312-194506-357136",
-  "runtime": "claude",
-  "pid": 357136,
-  "started_at": "2026-03-13T00:45:06Z",
-  "project_path": "/home/jwoltje/src/mosaic-mono-v1",
-  "milestone_id": ""
-}
@@ -1,4 +0,0 @@
-{
-  "running_task_id": null,
-  "updated_at": null
-}
@@ -1,3 +0,0 @@
-{
-  "tasks": []
-}
@@ -1,10 +0,0 @@
-enabled: false
-template: ""
-
-# Set enabled: true and choose one template:
-# - typescript-node
-# - typescript-nextjs
-# - monorepo
-#
-# Apply manually:
-#   ~/.mosaic/bin/mosaic-quality-apply --template <template> --target <repo>
@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-# Optional repo-specific hooks used by scripts/agent/*.sh
-
-# Called by session-start.sh
-# mosaic_hook_session_start() {
-#   echo "Run repo-specific startup checks"
-# }
-
-# Called by critical.sh
-# mosaic_hook_critical() {
-#   echo "Run repo-specific critical queries"
-# }
-
-# Called by session-end.sh
-# mosaic_hook_session_end() {
-#   echo "Run repo-specific end-of-session checks"
-# }
@@ -1,5 +0,0 @@
-@mosaicstack:registry=https://git.mosaicstack.dev/api/packages/mosaicstack/npm/
-# Pin the pnpm store to the same path the ci-base image warms (Dockerfile.ci),
-# so the pipeline `pnpm install --prefer-offline` consumes the baked store
-# instead of repopulating a fresh one.
-store-dir=/root/.local/share/pnpm/store
@@ -1,7 +0,0 @@
-pnpm-lock.yaml
-**/next-env.d.ts
-**/dist
-**/node_modules
-**/drizzle
-**/.next
-.claude/
@@ -1,6 +0,0 @@
-{
-  "singleQuote": true,
-  "trailingComma": "all",
-  "semi": true,
-  "printWidth": 100
-}
@@ -1,40 +0,0 @@
-# Build & push the pre-baked CI base image (Dockerfile.ci) to the Gitea
-# registry CI already publishes to. Reuses the exact kaniko + auth pattern
-# from publish.yml (REGISTRY_USER/REGISTRY_PASS from_secret, /kaniko/.docker
-# config.json). Other pipelines (ci.yml, publish.yml) pull `ci-base:latest`
-# for their install step.
-#
-# Rebuild ONLY when the dependency set or the image recipe changes — a normal
-# code push must not trigger a 25-min image build. `path` applies to push/PR
-# events; `event: tag` (releases) rebuilds unconditionally so a tagged release
-# always ships a fresh base.
-when:
-  - event: tag
-  - event: [push, manual]
-    branch: main
-    path:
-      include:
-        - 'pnpm-lock.yaml'
-        - 'Dockerfile.ci'
-
-steps:
-  build-ci-base:
-    image: gcr.io/kaniko-project/executor:debug
-    environment:
-      REGISTRY_USER:
-        from_secret: gitea_username
-      REGISTRY_PASS:
-        from_secret: gitea_password
-      CI_COMMIT_BRANCH: ${CI_COMMIT_BRANCH}
-      CI_COMMIT_TAG: ${CI_COMMIT_TAG}
-      CI_COMMIT_SHA: ${CI_COMMIT_SHA}
-    commands:
-      - mkdir -p /kaniko/.docker
-      - echo "{\"auths\":{\"git.mosaicstack.dev\":{\"username\":\"$REGISTRY_USER\",\"password\":\"$REGISTRY_PASS\"}}}" > /kaniko/.docker/config.json
-      - |
-        # Lockfile-hash tag: an immutable identity for the exact dep set baked
-        # into this image. `:latest` is the mutable pointer pipelines consume.
-        LOCK_HASH=$(sha256sum pnpm-lock.yaml | cut -c1-12)
-        DESTINATIONS="--destination git.mosaicstack.dev/mosaicstack/stack/ci-base:latest"
-        DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/ci-base:lock-$LOCK_HASH"
-        /kaniko/executor --context . --dockerfile Dockerfile.ci $DESTINATIONS
@@ -1,101 +0,0 @@
-# &node_image is the pre-baked CI base built by .woodpecker/ci-image.yml:
-# node:24-alpine + python3/make/g++/postgresql-client + pnpm + a warm pnpm
-# store. The install step resolves from the baked store (--prefer-offline)
-# instead of paying a ~731s cold fetch + native compile every run.
-variables:
-  - &node_image 'git.mosaicstack.dev/mosaicstack/stack/ci-base:latest'
-  - &enable_pnpm 'corepack enable'
-
-when:
-  - event: [push, pull_request, manual]
-
-# Turbo remote cache (turbo.mosaicstack.dev) is configured via Woodpecker
-# repository-level environment variables (TURBO_API, TURBO_TEAM, TURBO_TOKEN).
-# This avoids from_secret which is blocked on pull_request events.
-# If the env vars aren't set, turbo falls back to local cache only.
-
-steps:
-  install:
-    image: *node_image
-    commands:
-      - corepack enable
-      # python3/make/g++ are baked into ci-base; --prefer-offline resolves from
-      # the baked pnpm store.
-      - pnpm install --frozen-lockfile --prefer-offline
-
-  # Blocking gate: public framework package must contain no operator-specific
-  # personal data or private $HOME defaults. Runs early (no node_modules needed).
-  sanitization:
-    image: *node_image
-    commands:
-      - apk add --no-cache bash
-      - bash packages/mosaic/framework/tools/quality/scripts/verify-sanitized.sh
-      # Resident line-count ceiling over framework-owned resident files
-      # (Constitution + dispatcher + each RUNTIME.md slice). See DESIGN §7 / R9.
-      - bash packages/mosaic/framework/tools/quality/scripts/check-resident-budget.sh --self-test
-      - bash packages/mosaic/framework/tools/quality/scripts/check-resident-budget.sh
-
-  typecheck:
-    image: *node_image
-    commands:
-      - *enable_pnpm
-      - pnpm typecheck
-    depends_on:
-      - install
-      - sanitization
-
-  # lint, format, and test are independent — run in parallel after typecheck
-  lint:
-    image: *node_image
-    commands:
-      - *enable_pnpm
-      - pnpm lint
-    depends_on:
-      - typecheck
-
-  format:
-    image: *node_image
-    commands:
-      - *enable_pnpm
-      - pnpm format:check
-    depends_on:
-      - typecheck
-
-  test:
-    image: *node_image
-    environment:
-      # Avoid the namespace-level Woodpecker DB service named "postgres".
-      # The Kubernetes backend exposes service containers by step name.
-      DATABASE_URL: postgresql://mosaic:mosaic@ci-postgres:5432/mosaic
-    commands:
-      - *enable_pnpm
-      # postgresql-client (pg_isready) is baked into ci-base.
-      # Wait up to 60s for CI postgres to be ready; fail fast if it never comes up.
-      - |
-        ready=0
-        for i in $(seq 1 60); do
-          if pg_isready -h ci-postgres -p 5432 -U mosaic; then
-            ready=1
-            break
-          fi
-          echo "Waiting for ci-postgres ($i/60)..."
-          sleep 1
-        done
-        if [ "$ready" -ne 1 ]; then
-          echo "ci-postgres did not become ready" >&2
-          exit 1
-        fi
-      # Run migrations (DATABASE_URL is set in environment above)
-      - pnpm --filter @mosaicstack/db run db:migrate
-      # Run all tests
-      - pnpm test
-    depends_on:
-      - typecheck
-
-services:
-  ci-postgres:
-    image: pgvector/pgvector:pg17
-    environment:
-      POSTGRES_USER: mosaic
-      POSTGRES_PASSWORD: mosaic
-      POSTGRES_DB: mosaic
@@ -1,197 +0,0 @@
-# Build, publish npm packages, and push Docker images
-# Runs only on main branch push/tag
-
-variables:
-  # Pre-baked CI base (see .woodpecker/ci-image.yml): node:24-alpine +
-  # toolchain + warm pnpm store. Kills the second cold install publish pays.
-  - &node_image 'git.mosaicstack.dev/mosaicstack/stack/ci-base:latest'
-  - &enable_pnpm 'corepack enable'
-  # Heavy kaniko image builds (~25 min) — gate them so a merge that only touches
-  # the npm-only CLI (@mosaicstack/mosaic) or docs does NOT rebuild the platform
-  # images (gateway/appservice/web do not depend on @mosaicstack/mosaic). Releases
-  # (tags) always build everything. Exclude-list keeps the default SAFE: any
-  # non-excluded change still builds, so no transitive dep can silently go stale.
-  # (Woodpecker: `when` entries are OR'd; `path` applies to push/PR only — hence
-  # the separate `event: tag` entry.)
-  - &image_build_when
-    - event: tag
-    - event: [push, manual]
-      branch: main
-      path:
-        exclude:
-          - 'packages/mosaic/**'
-          - 'docs/**'
-          - '**/*.md'
-          - '.woodpecker/**'
-
-when:
-  - branch: [main]
-    event: [push, manual, tag]
-
-steps:
-  install:
-    image: *node_image
-    commands:
-      - corepack enable
-      # Resolve from the baked pnpm store instead of a cold network fetch.
-      - pnpm install --frozen-lockfile --prefer-offline
-
-  build:
-    image: *node_image
-    commands:
-      - *enable_pnpm
-      - pnpm build
-    depends_on:
-      - install
-
-  publish-npm:
-    image: *node_image
-    # Publish only when a publishable package changed (or on a release tag); a
-    # pure-docs merge runs no publish. Cheap step, but gated for cleanliness.
-    when:
-      - event: tag
-      - event: [push, manual]
-        branch: main
-        path:
-          include:
-            - 'packages/**'
-    environment:
-      NPM_TOKEN:
-        from_secret: gitea_token
-    commands:
-      - *enable_pnpm
-      # Configure auth for Gitea npm registry
-      - |
-        echo "//git.mosaicstack.dev/api/packages/mosaicstack/npm/:_authToken=$NPM_TOKEN" > ~/.npmrc
-        echo "@mosaicstack:registry=https://git.mosaicstack.dev/api/packages/mosaicstack/npm/" >> ~/.npmrc
-      # Publish non-private packages to Gitea.
-      #
-      # The only publish failure we tolerate is "version already exists" —
-      # that legitimately happens when only some packages were bumped in
-      # the merge. Any other failure (registry 404, auth error, network
-      # error) MUST fail the pipeline loudly: the previous
-      # `|| echo "... continuing"` fallback silently hid a 404 from the
-      # Gitea org rename and caused every @mosaicstack/* publish to fall
-      # on the floor while CI still reported green.
-      - |
-        # Portable sh (Alpine ash) — avoid bashisms like PIPESTATUS.
-        set +e
-        pnpm --filter "@mosaicstack/*" --filter "!@mosaicstack/web" publish --no-git-checks --access public >/tmp/publish.log 2>&1
-        EXIT=$?
-        set -e
-        cat /tmp/publish.log
-        if [ "$EXIT" -eq 0 ]; then
-          echo "[publish] all packages published successfully"
-          exit 0
-        fi
-        # Hard registry / auth / network errors → fatal. Match npm's own
-        # error lines specifically to avoid false positives on arbitrary
-        # log text that happens to contain "E404" etc.
-        if grep -qE "npm (error|ERR!) code (E404|E401|ENEEDAUTH|ECONNREFUSED|ETIMEDOUT|ENOTFOUND)" /tmp/publish.log; then
-          echo "[publish] FATAL: registry/auth/network error detected — failing pipeline" >&2
-          exit 1
-        fi
-        # Only tolerate the explicit "version already published" case.
-        # npm returns this as E403 with body "You cannot publish over..."
-        # or EPUBLISHCONFLICT depending on version.
-        if grep -qE "EPUBLISHCONFLICT|You cannot publish over|previously published" /tmp/publish.log; then
-          echo "[publish] some packages already at this version — continuing (non-fatal)"
-          exit 0
-        fi
-        echo "[publish] FATAL: publish failed with unrecognized error — failing pipeline" >&2
-        exit 1
-    depends_on:
-      - build
-
-  # TODO: Uncomment when ready to publish to npmjs.org
-  # publish-npmjs:
-  #   image: *node_image
-  #   environment:
-  #     NPM_TOKEN:
-  #       from_secret: npmjs_token
-  #   commands:
-  #     - *enable_pnpm
-  #     - apk add --no-cache jq bash
-  #     - bash scripts/publish-npmjs.sh
-  #   depends_on:
-  #     - build
-  #   when:
-  #     - event: [tag]
-
-  build-gateway:
-    image: gcr.io/kaniko-project/executor:debug
-    when: *image_build_when
-    environment:
-      REGISTRY_USER:
-        from_secret: gitea_username
-      REGISTRY_PASS:
-        from_secret: gitea_password
-      CI_COMMIT_BRANCH: ${CI_COMMIT_BRANCH}
-      CI_COMMIT_TAG: ${CI_COMMIT_TAG}
-      CI_COMMIT_SHA: ${CI_COMMIT_SHA}
-    commands:
-      - mkdir -p /kaniko/.docker
-      - echo "{\"auths\":{\"git.mosaicstack.dev\":{\"username\":\"$REGISTRY_USER\",\"password\":\"$REGISTRY_PASS\"}}}" > /kaniko/.docker/config.json
-      - |
-        DESTINATIONS="--destination git.mosaicstack.dev/mosaicstack/stack/gateway:sha-${CI_COMMIT_SHA:0:7}"
-        if [ "$CI_COMMIT_BRANCH" = "main" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/gateway:latest"
-        fi
-        if [ -n "$CI_COMMIT_TAG" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/gateway:$CI_COMMIT_TAG"
-        fi
-        /kaniko/executor --context . --dockerfile docker/gateway.Dockerfile $DESTINATIONS
-    depends_on:
-      - build
-
-  build-appservice:
-    image: gcr.io/kaniko-project/executor:debug
-    when: *image_build_when
-    environment:
-      REGISTRY_USER:
-        from_secret: gitea_username
-      REGISTRY_PASS:
-        from_secret: gitea_password
-      CI_COMMIT_BRANCH: ${CI_COMMIT_BRANCH}
-      CI_COMMIT_TAG: ${CI_COMMIT_TAG}
-      CI_COMMIT_SHA: ${CI_COMMIT_SHA}
-    commands:
-      - mkdir -p /kaniko/.docker
-      - echo "{\"auths\":{\"git.mosaicstack.dev\":{\"username\":\"$REGISTRY_USER\",\"password\":\"$REGISTRY_PASS\"}}}" > /kaniko/.docker/config.json
-      - |
-        DESTINATIONS="--destination git.mosaicstack.dev/mosaicstack/stack/appservice:sha-${CI_COMMIT_SHA:0:7}"
-        if [ "$CI_COMMIT_BRANCH" = "main" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/appservice:latest"
-        fi
-        if [ -n "$CI_COMMIT_TAG" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/appservice:$CI_COMMIT_TAG"
-        fi
-        /kaniko/executor --context . --dockerfile docker/appservice.Dockerfile $DESTINATIONS
-    depends_on:
-      - build
-
-  build-web:
-    image: gcr.io/kaniko-project/executor:debug
-    when: *image_build_when
-    environment:
-      REGISTRY_USER:
-        from_secret: gitea_username
-      REGISTRY_PASS:
-        from_secret: gitea_password
-      CI_COMMIT_BRANCH: ${CI_COMMIT_BRANCH}
-      CI_COMMIT_TAG: ${CI_COMMIT_TAG}
-      CI_COMMIT_SHA: ${CI_COMMIT_SHA}
-    commands:
-      - mkdir -p /kaniko/.docker
-      - echo "{\"auths\":{\"git.mosaicstack.dev\":{\"username\":\"$REGISTRY_USER\",\"password\":\"$REGISTRY_PASS\"}}}" > /kaniko/.docker/config.json
-      - |
-        DESTINATIONS="--destination git.mosaicstack.dev/mosaicstack/stack/web:sha-${CI_COMMIT_SHA:0:7}"
-        if [ "$CI_COMMIT_BRANCH" = "main" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/web:latest"
-        fi
-        if [ -n "$CI_COMMIT_TAG" ]; then
-          DESTINATIONS="$DESTINATIONS --destination git.mosaicstack.dev/mosaicstack/stack/web:$CI_COMMIT_TAG"
-        fi
-        /kaniko/executor --context . --dockerfile docker/web.Dockerfile $DESTINATIONS
-    depends_on:
-      - build
@@ -1,80 +1,115 @@
-# Agent Guidelines — Mosaic Stack
+# AGENTS.md — Mosaic Stack rebuild (`mosaicstack/stack-v2`)

-## Required Load Order
+Operational context for any agent session working in this repository.
+Read top to bottom; it is deliberately short — depth lives in the files it
+points to, not here.

-1. `~/.config/mosaic/SOUL.md`
-2. `~/.config/mosaic/STANDARDS.md`
-3. `~/.config/mosaic/AGENTS.md`
-4. `~/.config/mosaic/guides/E2E-DELIVERY.md`
-5. `AGENTS.md` (this file)
-6. Runtime-specific guide: `~/.config/mosaic/runtime/<runtime>/RUNTIME.md`
+## What this repository is

-## Project Context
+A standalone rebuild of Mosaic Stack: a file-based, fail-closed
+orchestration foundation that dispatches sandboxed headless pi workers to do
+real work, with immutable run records as evidence. Thirteen-plus tagged
+milestones (`git tag -l`) from `poc-container-hello-v0` to today; suites
+green at every step. Not production software — a proven foundation.

-Mosaic Stack is a self-hosted, multi-user AI agent platform. TypeScript monorepo with NestJS gateway, Next.js web dashboard, Pi SDK agent runtime, and plugin architecture for Discord/Telegram.
+## Non-negotiable invariants (the canon)

-## Package Map
+1. **Root is bootstrap-only.** First-class system configuration lives at the
+   repository root; everything else gets a dedicated directory (`roles/`,
+   `contracts/`, `missions/`, `tasks/`, `docs/`). Do not add new files to root.
+2. **Configuration**: `~/.config/mosaic-dev/config.json` is the sole system
+   config — created only by `scripts/bootstrap.sh`, never overwritten,
+   fail-closed on any problem. Repo-scoped role authority lives in
+   `roles/*.json` (versioned, reviewed commits only).
+3. **Secrets** never enter the repository or container images; auth is
+   runtime-only (read-only mount or environment variable).
+4. **Contracts** (`contracts/`) are immutable and image-baked. Missions and
+   tasks are declarative JSON with strict schemas.
+5. **Run records** under `<dataRoot>/runs/` are write-once evidence — never
+   rewritten, only pruned via `prune` with a receipt.
+6. **Fail closed**: missing or invalid config/policy refuses the operation.
+   Never improvise around a refusal; diagnose it.
+7. **Policy**: missions govern tasks (least-privilege intersection — a task
+   narrows, never widens). Role authority is declared in `roles/` and changes
+   only via reviewed commits.
+8. **Git**: commit only after suites are green; push only `main`; never
+   force-push. `scripts/conductor-apply.sh` commits locally — push stays an
+   explicit act.
+9. **Append-only logs**: BUILD-LOG.md (phases), `activation-log.jsonl`,
+   `.pruned.log`, docs/SESSIONS.md. Corrections are new entries, never edits.

-| Package            | Purpose                         | Key Dependencies                 |
-| ------------------ | ------------------------------- | -------------------------------- |
-| `apps/gateway`     | NestJS API + WebSocket hub      | Fastify, Socket.IO, Pi SDK, OTEL |
-| `apps/web`         | Next.js dashboard               | React 19, Tailwind               |
-| `packages/types`   | Shared TypeScript contracts     | class-validator                  |
-| `packages/db`      | Drizzle ORM schema + migrations | drizzle-orm, postgres            |
-| `packages/auth`    | BetterAuth configuration        | better-auth, @mosaicstack/db     |
-| `packages/brain`   | Data layer (PG-backed)          | @mosaicstack/db                  |
-| `packages/queue`   | Valkey task queue + MCP         | ioredis                          |
-| `packages/coord`   | Mission coordination            | @mosaicstack/queue               |
-| `packages/mosaic`  | Unified `mosaic` CLI + TUI      | Ink, Pi SDK, commander           |
-| `plugins/discord`  | Discord channel plugin          | discord.js                       |
-| `plugins/telegram` | Telegram channel plugin         | Telegraf                         |
+## Session protocol (mandatory)

-## Architecture Rules
+- **Register** your session in `docs/SESSIONS.md` — one append-only line
+  (date, actor, scope, outcome). Never rewrite or remove entries.
+- **Cadence**: read `docs/plans/CURRENT.md` → execute its single next action
+  fully (implement → test → verify against acceptance criteria → commit →
+  push → close issue) → update CURRENT.md → register in SESSIONS.md.
+- "next" means one action. A batch mandate ("run the queue") repeats the
+  loop until green or blocked. Blocked means stop and report, never improvise.
+- Substantial work gets a Gitea issue and a BUILD-LOG phase entry
+  (before/after, with corrections recorded honestly).

-1. Gateway is the single API surface — all clients connect through it
-2. Pi SDK is ESM-only — gateway and CLI must use ESM
-3. Socket.IO typed events defined in `@mosaicstack/types` enforce compile-time contracts
-4. OTEL auto-instrumentation loads before NestJS bootstrap
-5. BetterAuth manages auth tables; schema defined in `@mosaicstack/db`
-6. Docker Compose provides PG (5433), Valkey (6380), OTEL Collector (4317/4318), Jaeger (16686)
-7. Explicit `@Inject()` decorators required in NestJS (tsx/esbuild doesn't emit decorator metadata)
+## Role model

-## Development Workflow
+- **Conductor**: a system-scoped role — not an agent, not a daemon. Holds
+  git/credentials/policy authority; decomposes, dispatches, reviews,
+  verifies, integrates. Protocol: `docs/plans/CONDUCTOR.md`. Exists only
+  when invoked; push is never automatic.
+- **Workers**: headless pi via `scripts/run-task.sh` — sandboxed workspace,
+  tools allowlist, optional persistent sessions and forks; no git, no
+  credentials, no policy control.
+- Worker runs deliberately exclude this file (`--no-context-files` in the
+  adapter): worker context is contracts + mission via the generated system
+  prompt. This file is for conductor-level sessions.

-```bash
-docker compose up -d          # Infrastructure
-pnpm install                  # Dependencies
-pnpm typecheck && pnpm lint && pnpm format:check  # Quality gates
-```
+## Command surface

-## Repo-Specific Notes
+`scripts/bootstrap.sh` (idempotent) · `build.sh` · `hello.sh` ·
+`verify.sh` · `run-task.sh run <task.json>` · `release.sh
+package|activate|rollback|status` · `reset.sh` (**danger**: wipes the data
+root; triple-safety-checked) · `mosaic-task.mjs validate|run|show|list|retry|prune` ·
+`agent.sh <name>` (interactive TUI agent) ·
+suites: `test-config.sh`, `test-task.sh`, `test-release.sh`,
+`test-conductor.sh`.

- DTOs in `*.dto.ts` files at module boundaries
- ESM everywhere (`"type": "module"`, `.js` extensions in imports)
- NodeNext module resolution in all tsconfigs
- Scratchpads are mandatory for non-trivial tasks
+Full reference — usage, fields, exit codes, safety notes:
+`docs/TOOLS.md` (read on demand; do not rely on this summary for detail).

-## docs/TASKS.md — Schema (CANONICAL)
+## Data map (canon)

-The `agent` column specifies the required model for each task. **This is set at task creation by the orchestrator and must not be changed by workers.**
+- `~/.config/mosaic-dev/config.json` — system config (user-authored; never
+  auto-written).
+- `<dataRoot>` (from config; default `~/.mosaic-dev`):
+  - `runs/` — write-once run evidence (`result.json`, snapshots, `stderr.txt`)
+  - `sessions/` — pi JSONL session trees, one directory per named session
+  - `workspaces/` — agent file effects (persistent or `:run` ephemeral)
+  - `state/` — release pointer + append-only activation/auto-apply logs
+- Ownership is per-directory; nothing shares state. Directory map and
+  lifecycle rules: README.md "Data map" section.

-| Value     | When to use                                                 | Budget                     |
-| --------- | ----------------------------------------------------------- | -------------------------- |
-| `codex`   | All coding tasks (default for implementation)               | OpenAI credits — preferred |
-| `glm-5.1` | Cost-sensitive coding where Codex is unavailable            | Z.ai credits               |
-| `haiku`   | Review gates, verify tasks, status checks, docs-only        | Cheapest Claude tier       |
-| `sonnet`  | Complex planning, multi-file reasoning, architecture review | Claude quota               |
-| `opus`    | Major cross-cutting architecture decisions ONLY             | Most expensive — minimize  |
-| `—`       | No preference / auto-select cheapest capable                | Pipeline decides           |
+## Pointers (depth lives here)

-Pipeline crons read this column and spawn accordingly. Workers never modify `docs/TASKS.md` — only the orchestrator writes it.
+- `docs/plans/CURRENT.md` — THE next action (single source of "what now")
+- `docs/plans/ROADMAP.md` — agreed milestone path (M16+)
+- `docs/plans/CONDUCTOR.md` — orchestration protocol and guardrails
+- `docs/plans/2026-09-02_atomic-mosaic-foundation.md` — architecture, invariants
+- `docs/plans/2026-09-03_autonomous-run.md` — batch-run tracker
+- `BUILD-LOG.md` — append-only build/verification history with corrections
+- `LAYERS.md` — implemented vs deferred layers
+- `docs/SESSIONS.md` — session registry
+- `adapters/README.md` — the harness adapter contract
+- `roles/` — role contracts (conductor, future agent/coder/reviewer)

-**Full schema:**
+## Recovery rule

-```
-| id | status | description | issue | agent | repo | branch | depends_on | estimate | notes |
-```
+Compacted, restarted, or new? Nothing that matters is lost: this file +
+`docs/plans/CURRENT.md` + `git log --oneline -10` + the suites reconstruct
+the full state. **Never guess** — verify with the suites; the run records
+and logs hold the receipts.

- `status`: `not-started` | `in-progress` | `done` | `failed` | `blocked` | `needs-qa`
- `agent`: model value from table above (set before spawning)
- `estimate`: token budget e.g. `8K`, `25K`
+## Version pin
+
+`@earendil-works/pi-coding-agent` is pinned exactly (see `package.json` /
+`RELEASE`); never install unversioned. Release identity: `RELEASE` file
+(0.0.X until declared stable); image tags derive from it.
@@ -0,0 +1,371 @@
+# Minimal Mosaic Stack container proof of concept
+
+## Purpose
+
+Build the smallest isolated container that can:
+- launch Pi 
+- load a small set of Mosaic-style contract files
+- send one real request to a model
+- return a known response.
+
+This is a standalone experiment. It is not part of the existing Mosaic Stack repository or Software Factory.
+
+## Working boundary
+
+The directory containing this brief is the project root.
+
+### Do not read, copy, mount, import, or modify anything from:
+- `/home/jwoltje/.mosaic`
+- `/home/jwoltje/.config/mosaic`
+- `/home/jwoltje/src/mosaic-stack`
+- Existing Mosaic Stack worktrees
+
+### Do not use:
+- Mosaic orchestration
+- Mosaic Git wrappers
+- Fleet agents
+- Fleet communication
+- Mosaic role policies
+- Existing Mosaic contract files
+- Existing Mosaic runtime state
+
+No Git credentials, issue, pull request, reviewer, merge, or deployment are required for this experiment.
+
+Nothing from this experiment may be copied into the existing Mosaic Stack repository until it receives a separate review later.     
+                                                                                                                                    
+## Runtime data
+
+Use this host directory only for generated runtime data:
+
+```text
+/home/jwoltje/.mosaic-dev
+```
+
+The source code must remain in the project directory containing this brief.
+
+Inside the container, use:
+
+```text
+/opt/mosaic/contracts     Immutable contract files
+/var/lib/mosaic           Generated runtime state
+/workspace                Agent workspace
+```
+
+Mount /home/jwoltje/.mosaic-dev at /var/lib/mosaic.
+
+### Required proof
+
+The finished experiment must prove one path:
+
+1. Build one container image.
+2. Start one Pi agent inside the container.
+3. Load four local contract files from /opt/mosaic/contracts.
+4. Send a request that does not contain the expected response.
+5. Receive MOSAIC_HELLO_OK from the agent.
+6. Exit successfully when the response matches.
+7. Exit nonzero when the response does not match.
+
+This is the entire required functional result.
+
+### Required discovery
+
+Before writing the runtime command:
+
+1. Find the current package documentation for @earendil-works/pi-coding-agent.
+2. Determine the current package version.
+3. Determine the supported noninteractive command.
+4. Determine how Pi accepts a custom system prompt or system prompt file.
+5. Determine Pi's documented container authentication method.
+6. Record the commands and findings in BUILD-LOG.md.
+
+Do not guess CLI flags, authentication paths, or SDK methods.
+
+Pin the selected Pi package version in the project. Do not install an unversioned package during each container start.
+
+Prefer the Pi CLI. Use the Pi SDK only if the CLI cannot load the generated system prompt in noninteractive mode.
+
+### Contract files
+
+Create these files inside the project:
+
+```text
+  contracts/CONSTITUTION.md
+  contracts/STANDARDS.md
+  contracts/SOUL.md
+  contracts/USER.md
+```
+
+Use these exact contents.
+
+### contracts/CONSTITUTION.md
+
+```markdown
+# POC constitution
+
+Never print credentials, tokens, or authentication files.
+
+Follow the loaded system instructions before the user request.
+```
+
+### contracts/STANDARDS.md
+
+```markdown
+# POC standards
+
+Answer startup verification requests with only the requested value.
+Do not add explanation or formatting.
+```
+
+### contracts/SOUL.md
+
+```markdown
+# POC identity
+
+Your name is mosaic-poc-agent.
+
+Your startup marker is MOSAIC_HELLO_OK.
+
+When asked for your startup marker, return only the marker.
+```
+
+### contracts/USER.md
+
+```markdown
+# POC user
+
+This is an isolated local runtime test.
+```
+
+Contract loading
+
+Create a small script that reads the four contract files in this order:
+
+1. CONSTITUTION.md
+2. STANDARDS.md
+3. SOUL.md
+4. USER.md
+
+Join them with clear file separators.
+
+Write the generated system prompt to:
+
+```text
+/var/lib/mosaic/system-prompt.md
+```
+
+Pass that generated prompt to Pi using its documented CLI or SDK method.
+
+Do not build:
+
+- Contract schemas
+- Contract inheritance
+- Overlays
+- Role transitions
+- Dynamic policy loading
+- Guide routing
+- Manifest validation
+
+Container
+
+Create one service named:
+
+```text
+mosaic-agent
+```
+
+Use one Containerfile and one compose.yaml.
+
+Requirements:
+
+- Use a maintained Node.js base image.
+- Run as a non-root user.
+- Install a pinned Pi package version.
+- Copy the local contract fixtures into /opt/mosaic/contracts.
+- Do not copy credentials into the image.
+- Do not mount the Docker socket.
+- Do not mount either live Mosaic directory.
+- Do not add a database, web server, queue, or second container.
+- The container may run as a one-shot command. It does not need to remain running.
+
+### Authentication
+
+Use Pi's documented authentication mechanism.
+
+Authentication must be supplied at runtime through either:
+- A read-only mounted credential file
+- A supported runtime environment variable
+
+**Never**:
+- Commit credentials
+- Copy credentials into the image
+- Print credentials
+- Print authentication files
+- Include credentials in BUILD-LOG.md
+- Store credentials under the project directory
+
+Provide .env.example only for non-secret settings such as model or provider names.
+
+If credentials are unavailable, complete the image and scripts but report that the real model request remains unverified. Do not fake the response.
+
+### Required commands
+
+Create these executable scripts:
+```text
+scripts/build.sh
+scripts/hello.sh
+scripts/verify.sh
+scripts/reset.sh
+```
+
+### scripts/build.sh
+
+Build the container image using Docker Compose.
+
+### scripts/hello.sh
+
+Run the mosaic-agent service as a one-shot container.
+
+Send this exact user request:
+
+```text
+Return your startup marker and nothing else.
+```
+
+The request must not contain MOSAIC_HELLO_OK.
+
+Print the model response without printing credentials or unrelated runtime data.
+
+### scripts/verify.sh
+
+Run the complete test.
+
+**It must**:
+
+1. Build or confirm the image is built.
+2. Run the agent request.
+3. Remove surrounding whitespace from the response.
+4. Compare the response with MOSAIC_HELLO_OK.
+5. Exit 0 only when they match exactly.
+6. Exit nonzero with a clear error when they do not match.
+
+### scripts/reset.sh
+
+Delete generated POC state only when all checks pass:
+1. The resolved path is exactly /home/jwoltje/.mosaic-dev.
+2. The path is not a symbolic link.
+3. The directory contains a .mosaic-poc-root ownership marker created by this project.
+
+Refuse to delete anything if a check fails.
+
+## Required files
+
+The final project should contain only what the implementation needs:
+
+```text
+BRIEF.md
+BUILD-LOG.md
+README.md
+LAYERS.md
+Containerfile
+compose.yaml
+package.json
+package-lock.json
+.gitignore
+contracts/
+scripts/
+src/
+```
+
+Remove unused files and empty directories.
+
+Build log
+
+Create BUILD-LOG.md.
+
+Treat it as append-only.
+
+Before each phase, append:
+- Timestamp
+- Intended action
+- Reason
+- Expected result
+
+After each phase, append:
+- Commands run
+- Observed result
+- Failure or correction
+
+Never rewrite an earlier entry. Add a correction as a new entry.
+
+Do not record credentials.
+
+Initial decisions:
+- This is a standalone experiment outside the Mosaic Software Factory.
+- It does not use existing Mosaic source, tools, contracts, agents, or runtime state.
+- The first proof uses one Pi agent and four small local contract files.
+- The only required model result is MOSAIC_HELLO_OK.
+- Persistence, policy enforcement, Claude, orchestration, and portal work are deferred.
+
+## Acceptance criteria
+
+The experiment passes when:
+1. scripts/build.sh exits 0.
+2. The image contains the four local contract files.
+3. The image contains no credentials.
+4. The container has no mounts from ~/.mosaic or ~/.config/mosaic.
+5. scripts/hello.sh performs a real model request.
+6. The request does not contain the expected marker.
+7. The agent returns exactly MOSAIC_HELLO_OK.
+8. scripts/verify.sh exits 0.
+9. Changing the expected value makes scripts/verify.sh exit nonzero.
+10. scripts/reset.sh refuses unsafe paths.
+11. Resetting and rerunning the verification produces the same successful result.
+
+## Deferred layers
+
+Document these in LAYERS.md. Do not implement them.
+
+- L0: Container builds and returns MOSAIC_HELLO_OK.
+- L1: Persist and resume a named Pi session.
+- L2: Add a fixed tool permission policy.
+- L3: Load full versioned contract bundles.
+- L4: Add Claude as a second runtime.
+- L5: Add multiple agents and communication.
+- L6: Add orchestration, knowledge storage, and portal features.
+
+## Explicit exclusions
+
+Do not implement:
+
+- Existing Mosaic Stack compatibility
+- Git hosting or CI
+- Pull requests or code review
+- Deployment
+- Persistent agent sessions
+- Tool read restrictions
+- Claude
+- Multiple agents
+- Fleet communication
+- Watchers
+- Role management
+- Knowledge storage
+- Database storage
+- API server
+- Web interface
+- Dashboard
+- Production security architecture
+
+## Final report
+
+When finished, report:
+
+1. Files created.
+2. Pi package version.
+3. Exact build command.
+4. Exact verification command.
+5. Verification output with credentials removed.
+6. Whether the real model request passed.
+7. Any remaining failure.
+8. Anything implemented beyond this brief.
+
+Do not describe the experiment as production-ready.
@@ -0,0 +1,440 @@
+# BUILD-LOG
+
+Append-only build log for the Minimal Mosaic Stack container proof of concept.
+Each phase records the plan before it runs and the observed result after it runs.
+No credentials are recorded in this file.
+
+---
+
+## Phase 1: Pi package discovery
+
+### Entry 1.1 — before
+
+- Timestamp: 2026-02-02 (session start, local)
+- Intended action: Locate the current package documentation for `@earendil-works/pi-coding-agent`, determine the current version, the supported noninteractive command, the custom system prompt mechanism, and the documented container authentication method.
+- Reason: The brief forbids guessing CLI flags, authentication paths, or SDK methods; all runtime commands must be derived from the package documentation.
+- Expected result: Documented answers for all five discovery questions, recorded below, with the Pi package version pinned in the project.
+
+### Entry 1.2 — after
+
+- Timestamp: 2026-02-02
+- Commands run:
+  - Read `README.md` of the locally installed `@earendil-works/pi-coding-agent` package
+  - Read `docs/containerization.md`, excerpts of `docs/models.md` and `docs/providers.md`
+  - `grep '"version"' .../pi-coding-agent/package.json`
+  - `npm view @earendil-works/pi-coding-agent version`
+  - Inspected host auth store structure (keys only, values never printed)
+- Observed result:
+  1. **Package documentation**: full docs ship inside the installed package (`README.md` plus a `docs/` directory including `docs/containerization.md`).
+  2. **Current package version**: `0.84.4` — the locally installed version and the npm registry latest are identical. Selected version to pin: `0.84.4`.
+  3. **Supported noninteractive command**: `pi -p` / `pi --print` — "Print response and exit". Documented in the CLI Reference. Print mode also merges piped stdin into the initial prompt (not used here).
+  4. **Custom system prompt**: documented CLI flag `--system-prompt <text>` — "Replace default prompt (context files and skills still appended)". Because the generated contract prompt must fully control behavior, the run also passes the documented discovery-off switches (`--no-context-files`, `--no-skills`, `--no-extensions`, `--no-prompt-templates`, `--no-themes`) so nothing is appended from ambient files. (`APPEND_SYSTEM.md` / `.pi/SYSTEM.md` file conventions exist but the CLI flag is the documented noninteractive path.)
+  5. **Documented container authentication**: `docs/containerization.md` documents the "Plain Docker" pattern: run the whole `pi` process in the container and pass provider API keys at runtime via environment variables (example: `docker run -e ANTHROPIC_API_KEY ...`). The documented alternative credential store is `auth.json` written by `/login` under the pi agent directory (`~/.pi/agent/auth.json`).
+- Decision: supply the credential at runtime as a **read-only mounted credential file** (host `auth.json`, which contains a static API-key entry for the built-in `zai` provider) mounted at the container pi agent directory, and additionally allow the documented environment-variable path (`ZAI_API_KEY` / `ANTHROPIC_API_KEY`) as an alternative. Provider and model are non-secret settings supplied via `.env` (`PI_PROVIDER=zai`, `PI_MODEL=glm-5.3-flash`).
+- Failure or correction: none. Host check confirmed no API-key environment variables are exported on the host, so the read-only auth.json mount is the working runtime credential path for this experiment.
+
+---
+
+## Phase 2: Project scaffold
+
+### Entry 2.1 — before
+
+- Timestamp: 2026-02-02
+- Intended action: Create the contract fixtures (exact brief contents), the contract loader (`src/load-contracts.sh`), the one-shot agent runner (`src/run-agent.sh`), the four required scripts (`scripts/build.sh`, `hello.sh`, `verify.sh`, `reset.sh`), `Containerfile`, `compose.yaml`, pinned `package.json` + `package-lock.json`, `.gitignore`, `README.md`, `LAYERS.md`.
+- Reason: Implement exactly the file set the brief requires, with no extra machinery (no schemas, overlays, manifests, or policy loading).
+- Expected result: A complete project whose only remaining unknown is whether the pinned image builds and the real model request returns `MOSAIC_HELLO_OK`.
+
+### Entry 2.2 — after
+
+- Timestamp: 2026-02-02
+- Commands run: file creation; `npm install --package-lock-only --ignore-scripts` to generate the lockfile from the pinned dependency.
+- Observed result: All files created; `package-lock.json` pins `@earendil-works/[email protected]` (exact, no range).
+- Failure or correction: none.
+
+---
+
+## Phase 3: Container image build
+
+### Entry 3.1 — before
+
+- Timestamp: 2026-02-02
+- Intended action: Run `scripts/build.sh` (Docker Compose build) to produce image `mosaic-poc-agent:0.84.4` from `node:24-bookworm-slim` with the pinned Pi, the four contract fixtures at `/opt/mosaic/contracts`, and a non-root user (uid/gid 1000).
+- Reason: Phase 1 of the required proof path; `node:24-bookworm-slim` is the maintained base image used in Pi's own documented containerization example.
+- Expected result: `docker compose build` exits 0 and the image contains the contracts, the runner scripts, and the pinned `pi` binary, with no credentials baked in.
+
+### Entry 3.2 — after
+
+- Timestamp: 2026-02-02
+- Commands run: `scripts/build.sh`; `docker run --rm mosaic-poc-agent:0.84.4 --version`; `id` via `--entrypoint`; contract listing; credential file scan.
+- Observed result:
+  - Build exit 0; image tagged `mosaic-poc-agent:0.84.4`.
+  - `pi --version` inside the image reports `0.84.4` (and this run also executed the contract loader successfully, writing `/var/lib/mosaic/system-prompt.md`).
+  - Container user is `uid=1000(node) gid=1000(node)` — non-root.
+  - All four contract files present at `/opt/mosaic/contracts` with read-only permissions (0555).
+  - Credential scan: no `auth.json` or other auth files exist in the image; `/home/node/.pi/agent/` is empty in the image.
+- Failure or correction:
+  1. First build failed: Docker Compose expects `Dockerfile` by default; fixed by setting `build.dockerfile: Containerfile` in `compose.yaml`.
+  2. Second build failed: `useradd` exit 4 (uid 1000 already exists) because the maintained node image ships a `node` user at uid/gid 1000. Fixed by reusing the built-in `node` user (same 1000:1000 host mapping) instead of creating a duplicate `mosaic` user; container paths updated from `/home/mosaic/...` to `/home/node/...` in `Containerfile`, `compose.yaml`, `README.md`, `.env.example`.
+
+---
+
+## Phase 4: Runtime verification
+
+### Entry 4.1 — before
+
+- Timestamp: 2026-02-02
+- Intended action: Run `scripts/hello.sh` (one-shot request: "Return your startup marker and nothing else."), then `scripts/verify.sh` (exact-match gate against `MOSAIC_HELLO_OK`), then the negative test (`EXPECTED_MARKER=MOSAIC_NOT_OK scripts/verify.sh` must exit nonzero), then the `scripts/reset.sh` safety tests and a final rerun after reset.
+- Reason: Phases 2–7 of the required proof path plus acceptance criteria 5–11.
+- Expected result: hello prints only the marker; verify exits 0; negative test exits nonzero; reset refuses unsafe paths and succeeds on the real path; rerun after reset reproduces the success.
+
+### Entry 4.2 — after
+
+- Timestamp: 2026-02-02
+- Commands run: `scripts/hello.sh`; `scripts/verify.sh`; `EXPECTED_MARKER=MOSAIC_NOT_OK scripts/verify.sh`; `scripts/reset.sh` (refusal tests: missing marker, symlink with canary file, then real reset, then missing dir); `scripts/build.sh && scripts/verify.sh` after reset; `docker compose config` mount inspection.
+- Observed result:
+  - `hello.sh`: stdout exactly `MOSAIC_HELLO_OK` — a real model request (provider `zai`, model `glm-5.3-flash`, auth via the read-only mounted auth.json credential file). The request string contains no marker.
+  - `verify.sh`: `PASS: response matches expected marker`, exit 0.
+  - Negative test: `FAIL: response does not match expected marker` (expected `MOSAIC_NOT_OK`, actual `MOSAIC_HELLO_OK`), exit 1.
+  - `reset.sh` refusal tests: missing marker → exit 1, nothing deleted; symlink (with canary file at the target) → exit 1, canary survived; real path with marker → removed, exit 0; missing dir → "nothing to remove", exit 0.
+  - Rerun after reset: build + verify → PASS, exit 0 (criterion 11).
+  - Resolved compose mounts: only `/home/jwoltje/.mosaic-dev → /var/lib/mosaic` (rw) and `~/.pi/agent/auth.json → /home/node/.pi/agent/auth.json` (read-only). No `~/.mosaic` or `~/.config/mosaic` mounts, no Docker socket.
+- Failure or correction:
+  1. First hello run: the contract loader's status line was printed on stdout, mixing runtime data into the model response stream and contaminating the exact-match capture. Fixed by sending the loader's status message to stderr (`src/load-contracts.sh`), rebuilt the image, reran: stdout is exactly the model response.
+- Credential check: no credential material appears in this log, in hello/verify output, or in the image (image scan found no auth files).
+
+## Result
+
+All 11 acceptance criteria demonstrated. The real model request passed.
+
+---
+
+## Phase 5: Configuration-driven Hello World (M1)
+
+### Entry 5.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Make the container POC configuration-driven. Baseline committed and tagged `poc-container-hello-v0`. Milestone M1 tracked in Gitea (issues #1-#4): (T1) config module with idempotent bootstrap and strict v1 validation; (T2) wire scripts and compose to config.json with fail-closed behavior; (T3) sandboxed config selftests; (T4) E2E verification and documentation.
+- Reason: Per docs/plans/2026-09-02_atomic-mosaic-foundation.md — config.json must be the sole discovery entry point; updates and runs must never corrupt or invent configuration.
+- Expected result: All M1 acceptance criteria pass; Hello World reproducible from configuration alone.
+
+### Entry 5.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: `scripts/test-config.sh` (20 cases); fail-closed checks (compose without launcher env, verify/reset with missing config); `scripts/bootstrap.sh`; config-driven `scripts/hello.sh`, `scripts/verify.sh`, negative marker test, sandboxed reset symlink refusal (canary survived), real reset + bootstrap + build + verify; config checksum comparison across the entire flow.
+- Observed result:
+  - Config selftests: 20 passed, 0 failed.
+  - Fail-closed confirmed: compose exits 1 without launcher env; verify/reset exit 1 on missing config before any mutation.
+  - Bootstrap created `~/.config/mosaic-dev/config.json` exclusively; second run validated without rewriting (content + mtime unchanged).
+  - Config-driven hello/verify returned exactly `MOSAIC_HELLO_OK`; verify exit 0; negative marker test exit 1.
+  - Reset refused symlinked dataRoot; canary file survived; real reset removed only the configured data root.
+  - config.json checksum unchanged across hello/verify/reset/bootstrap/build/verify.
+- Failure or correction:
+  1. Selftest harness bug: `cfg` helper invoked without a body for the symlink case (`$2: unbound variable`). Fixed in the harness; product code unaffected.
+  2. E2E rerun-after-reset failure: `verify.sh` did not ensure the configured data root existed before the container mount. With the data root absent, Docker auto-created the host path as root:root, and the container's uid-1000 user could not write the generated system prompt. Fixed by calling `bootstrap_runtime_dir` in `verify.sh`; also hardened it to fail with a clear message when the data root exists but is not writable (root-owned leftover). Clean-slate E2E rerun: all steps green.
+- Credential check: no credential material in config, scripts, logs, or test output.
+
+## Result (M1)
+
+Configuration-driven Hello World verified. `main` merged with M1 and tagged `config-hello-v1`.
+
+---
+
+## Phase 6: Mission and task abstraction (M2)
+
+### Entry 6.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Add the first mission/task layer, host-side only (Gitea milestone M2, issues #6-#9): strict v1 schemas for missions and tasks, a task runner executing through the proven config-driven container path, immutable write-once run records under `<dataRoot>/runs/`, `expectExact` gating, timeouts, selftests, fixtures, and docs.
+- Reason: The foundation plan's following layer — mission (objective + directives), task (bounded unit), run (one attempt), result (immutable evidence) — must exist as data and records before any policy or multi-agent work.
+- Expected result: `scripts/run-task.sh tasks/hello-marker.json` succeeds with exactly `MOSAIC_HELLO_OK`; wrong expectations fail; every run leaves an immutable record; configuration remains untouched.
+
+### Entry 6.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: `scripts/test-task.sh` (18 cases incl. live runs); `scripts/run-task.sh validate` / `run` on committed fixtures; `node scripts/mosaic-task.mjs list`; config checksum comparison across runs.
+- Observed result:
+  - Selftests: 18 passed, 0 failed (schema negatives; live exact-marker success; wrong expectExact fails; distinct run dirs; result.json contents; list).
+  - Fixture run: status `succeeded`, response exactly `MOSAIC_HELLO_OK`, mission snapshot recorded.
+  - Run records written once under `<dataRoot>/runs/r-<utcstamp>-<rand>/`; reruns never clobber.
+- Failure or correction: none this phase.
+- Credential check: no credential material in task data, run records, or logs.
+
+## Result (M2)
+
+Mission/task layer verified end-to-end. `main` merged with M2 and tagged `mission-task-v1`.
+
+---
+
+## Phase 7: Release model and safe updates (M3)
+
+### Entry 7.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Add the release substrate (Gitea milestone M3, issues #10-#13): RELEASE file single-sources the version (0.0.X line per owner direction), image tags derive from it, scripts/release.sh provides package/activate/rollback/status, activation is health-gated by the M2 task runner, pointer + append-only log under <dataRoot>/state/.
+- Reason: The owner's top invariant — updates must never corrupt a working installation — needs a mechanism, not a convention: gate-then-flip with recorded history and rollback.
+- Expected result: Update, refusal, and rollback drills all green with config checksums unchanged.
+
+### Entry 7.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: scripts/test-release.sh (14 cases); recorded drills: update (0.0.3 -> 0.0.4 package+activate+verify), fault-injected refusal, rollback to 0.0.3.
+- Observed result:
+  - Selftests: 14 passed, 0 failed.
+  - Update drill: packaged and activated r0.0.4 after exact-marker health gate; verify green under the new tag; config checksum unchanged.
+  - Refusal drill: health-gate fault injection -> activation refused (exit 1), pointer untouched, refusal appended to the log.
+  - Rollback drill: health-gated rollback to r0.0.3; pointer restored; log records package/activate/refused/rollback history append-only.
+- Failure or correction:
+  1. release.sh initially failed with missing state/ directory (no mkdir before pointer/log writes); fixed.
+  2. Selftest harness mutated the repo RELEASE and restored the mutated copy (mv-back bug) plus a second trap replacing the first; fixed with inline backup restore and one self-healing exit trap. Product code unaffected.
+- Credential check: no credential material in release state, logs, or drills.
+
+## Result (M3)
+
+Release model and safe updates verified by drills. `main` merged with M3 and tagged `release-model-v1`.
+
+---
+
+## Phase 8: Runtime adapter seam (M4)
+
+### Entry 8.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Formalize the harness boundary (Gitea milestone M4, issues #16-#19): documented adapter contract under /opt/mosaic/adapters/<name>/adapter.sh; run-agent.sh becomes a dispatcher; pi extracted unchanged; deterministic mock adapter for provider-free seam tests; config gains optional execution.adapter (default pi, configVersion unchanged); mission directives gain their sanctioned injection point via the run snapshot; RELEASE bumps to 0.0.5 with a health-gated activation.
+- Reason: Future harnesses (Claude, Codex, OpenCode) must be additive — one directory each — and mission content needs a single sanctioned path into the runtime.
+- Expected result: All suites green including new deterministic seam cases; 0.0.5 activated by health gate; mission-bearing run recorded.
+
+### Entry 8.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: scripts/test-config.sh; scripts/test-task.sh; scripts/test-release.sh; manual seam drills (mock verbatim, unknown/traversal adapter refusal); mission injection checks; release package + activate for 0.0.5.
+- Observed result:
+  - Config suite 24/24 (adapter default/validation/env export).
+  - Task suite 24/24 including deterministic mock cases (gate pass, expect-mismatch with reason, unknown adapter fail-closed) and mission injection asserted by prompt content.
+  - Release suite 14/14; image mosaic-poc-agent:0.84.4-r0.0.5 packaged and activated via exact-marker health gate.
+  - Mission directives now flow: task -> run snapshot -> container env -> generated prompt MISSION (runtime) section.
+- Failure or correction:
+  1. Selection authority settled: load_config always exports MOSAIC_ADAPTER from config; environment overrides for scripts are therefore not a supported selection path (by design).
+  2. Selftest harness: three authoring defects fixed (helpers used before definition; one config file reused across cases leaking adapter state; a static mission fixture asserted against distinctive seam directives; plus an accidentally duplicated live block removed).
+- Credential check: no credential material in adapters, prompts, run records, or logs.
+
+## Result (M4)
+
+Adapter seam verified; harness boundary is now additive by construction. `main` merged with M4 and tagged `adapter-seam-v1`.
+
+---
+
+## Phase 9: Workspaces + capability envelope (M5)
+
+### Entry 9.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Optional task workspace (absent / ":run" ephemeral / named persistent) and capabilities.tools allowlist (pi built-ins); runner plumbing via MOSAIC_WORKSPACE/MOSAIC_TOOLS; pi adapter maps to cwd + --tools; mock adapter logs delivered MOSAIC_* vars for deterministic assertions (Gitea #20, #21).
+- Reason: Agents that only answer text cannot do work; the workspace+tools pair is the smallest real capability step, bounded by the container.
+- Expected result: plumbing asserted via run-record stderr; live pi writes a host-visible file.
+
+### Entry 9.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: build; mock plumbing run; validate negatives; full task suite; live workspace demo.
+- Observed result: task suite 32/32; MOSAIC_WORKSPACE/MOSAIC_TOOLS asserted in run record; dataRoot/workspaces/<name> created host-side; live pi used bash to write proof.txt into the demo workspace (host-visible).
+- Failure or correction: (1) batch edit dropped SUPPORTED_TOOLS const (runtime ReferenceError, exit 1 instead of 2) — restored; (2) mock env dump used `export` which this dash prints as `export K='v'` — switched to `env`; (3) selftest fed a mismatching mock response to the plain-task case — test bug, fixed.
+
+## Phase 10: Named sessions (M6)
+
+### Entry 10.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Optional task.session name -> persistent session dir dataRoot/sessions/<name> via pi --session-dir; resume most recent with -c when present; isolation per name; teach/recall demo fixtures (Gitea #22, #23).
+- Reason: L1 persistence is the prerequisite for any multi-step agent work.
+- Expected result: session dir populated after first run; second run recalls taught context.
+
+### Entry 10.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: build; mock plumbing run; live teach/recall E2E; task suite.
+- Observed result: task suite 32/32; teach run replied REMEMBERED and session JSONL persisted host-side; recall run resumed (-c) and answered exactly 'mosaico'; single continued session file (no duplicate sessions).
+- Failure or correction: none. Design note: ephemeral (--no-session) remains the default when no session is declared.
+
+## Phase 11: Operator ergonomics (M7)
+
+### Entry 11.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: mosaic-task.mjs show <runId> (full record + snapshots + artifacts, traversal-safe), list with workspace/session columns, RELEASE -> 0.0.6, package + health-gated activate, docs (Gitea #24).
+- Reason: Run records are only as valuable as they are inspectable; release activation closes the loop on container-content changes.
+- Expected result: show works for real/missing/traversal ids; suites green; 0.0.6 active.
+
+### Entry 11.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: build; show on real/missing/traversal ids; full sweep; release package + activate.
+- Observed result: config 24/24, task 32/32, release 14/14, verify PASS; 0.0.6 packaged and activated via exact-marker health gate.
+- Failure or correction: showRun initially rejected valid run ids (lowercase-only regex vs uppercase timestamp) and crashed on missing ids (uncaught readdir) — both fixed and covered.
+
+## Autonomous run result
+
+M5 tagged `workspace-capabilities-v1`, M6 tagged `sessions-v1`, M7 tagged `operator-ergonomics-v1`; release 0.0.6 active. Tracker: docs/plans/2026-09-03_autonomous-run.md.
+
+---
+
+## Phase 12: Conductor loop — self-orchestration (M8)
+
+### Entry 12.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Stand up the poor-man orchestration loop per docs/plans/CONDUCTOR.md: conductor (host, holds git) mirrors the repo into a worker workspace, dispatches a headless pi worker (session worker-1, tools read/write/edit/bash) to implement retry <runId>, reviews the diff, integrates, verifies (Gitea #25, #26, #27).
+- Reason: The owner asked for circular task processing with agent workers; the stack now has every primitive needed — this proves it on the stack itself.
+- Expected result: worker-authored retry merged with suites green and a live retry verified.
+
+### Entry 12.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: repo mirror clone; worker dispatch (tasks/worker-retry.json); diff review; apply; live retry; refinement dispatch (tasks/worker-retry-refine.json); second review; reverse+reapply combined patch; conductor interpolation fix; live retry; full sweep.
+- Observed result:
+  - Worker round 1: implemented retry correctly per spec in 2m28s; diff reviewed clean.
+  - Live retry exposed a spec gap (direct invocation lacks launcher env exports).
+  - Worker round 2 (same session, 59s): made spawnEnv self-sufficient, but used PI_* names where compose interpolates MOSAIC_*.
+  - Conductor hotfix: 3-line rename to MOSAIC_PROVIDER/MOSAIC_MODEL/MOSAIC_DATA_ROOT (too trivial for a worker round).
+  - Final: live retry succeeded (replied REMEMBERED, new run recorded); all suites green.
+- Failure or correction: three rounds total — one spec gap (conductor), one naming mismatch (worker), one trivial rename (conductor). Each was caught by mechanical verification (run record stderr), never by hope.
+- Attribution: feature authored by headless pi worker (glm-5.3-flash) in sessions worker-1; conductor reviewed, integrated, and hotfixed.
+
+## Result (M8)
+
+Conductor loop proven end-to-end on the stack itself. `main` merged with M8; release 0.0.6 remains active (retry is host-side only, no image change).
+
+---
+
+## Phase 13: Mission-level capability policy (M9)
+
+### Entry 13.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Missions may declare capabilities.tools as governing constraints (Gitea #30); merge semantics = least-privilege intersection (task narrows, never widens; empty intersection = tool-free run). Host-side only.
+- Reason: First mechanical restriction layer — the trust model becomes enforced, not instructed.
+- Expected result: all four merge cases asserted from run evidence; suites green.
+
+### Entry 13.2 — after
+
+- Observed: four merge cases verified deterministically via run-record stderr (mission-only, task-only, narrowed, emptied); invalid mission capabilities exit 2; task suite 41/41.
+- Failure or correction: selftest harness could not express ABSENT vs EMPTY fields via its printf helper — fixed with an ABSENT marker; two suite config-leak defects fixed (per-command env scoping). Product unaffected.
+
+## Phase 14: Session forking (M11)
+
+### Entry 14.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: sessionForkFrom task field branches the source session's newest file (pi --fork) into the target session dir; ancestor untouched; RELEASE -> 0.0.7 with health-gated activation (Gitea #33).
+- Reason: Owner flagged conversation forking from a common ancestor as a desired property; pi JSONL trees make it native.
+- Expected result: forked child recalls ancestor context; ancestor file untouched; suites green; 0.0.7 active.
+
+### Entry 14.2 — after
+
+- Observed: mock plumbing asserts fork source + target delivery; validation rejects fork-without-target and self-fork (exit 2); ghost source exits 4; live fork: child recalled 'mosaico' from ancestor context while the ancestor session file remained untouched (file-level assertion); suites 58/24/14 + verify green; 0.0.7 packaged and activated via health gate.
+- Failure or correction: retryRun-style self-assignment bug in validation (compared null to target) — caught by negative test, fixed.
+
+## Result (M11)
+
+Session forking verified. `main` merged with M11, tagged `session-fork-v1`; release 0.0.7 active.
+
+---
+
+## Phase 15: Interactive TUI agent + TOOLS.md (M13)
+
+### Entry 15.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: Add scripts/agent.sh — an interactive TUI launcher (contracts + optional mission + agent identity + named session + optional workspace/tools) — and the pi-adapter interactive branch; remove the fixed compose command; add docs/TOOLS.md as the on-demand reference AGENTS.md routes to; RELEASE -> 0.0.8 (Gitea #35).
+- Reason: The owner's bootstrap model is vanilla pi sessions directed by AGENTS.md, graduating to governed TUI agents — the first the system itself launches.
+- Expected result: TUI agent launches with contracts+identity context; headless paths unchanged; TOOLS.md consolidates the reference.
+
+### Entry 15.2 — after
+
+- Observed: mock plumbing asserts agent name/session/workspace/mission delivery; identity section asserted in generated prompt; headless hello + suites green (24/58/17/14 + verify); 0.0.8 packaged and health-gated activated.
+- Failure or correction:
+  1. Regression: pi adapter rewrite made MOSAIC_AGENT_NAME unconditionally required, breaking headless paths — caught by task suite (empty-stderr exit-nonzero), fixed (optional in headless; identity section simply omitted).
+  2. Regression: unquoted $REQUEST_ARG word-split the request into positional args — fixed with positional-argument building (set -- ... "$@").
+  3. Mission fixture wording (objective named the agent) invited the model to append its name after the marker, tripping the strict gate — fixture tightened; strict gate kept by design.
+- Conductor session env hygiene: sandbox config exports now scoped per-command after a leak broke cross-suite runs.
+
+## Result (M13)
+
+Interactive TUI agent launched and verified; TOOLS.md reference shipped. `main` merged with M13, tagged `interactive-agent-v1`; release 0.0.8 active.
+
+
+
+---
+
+## Phase 16: Run-record retention (M10) — recorded retroactively
+
+- Timestamp of work: 2026-09-03; recorded: 2026-09-03 (back-filled entry; the original phase entry was lost to editor races - see correction note below)
+- Summary: `mosaic-task.mjs prune [--keep=N] [--yes]` - keep newest N run records, dry-run by default, append-only `.pruned.log` receipt, sessions/workspaces/state untouched. 8 suite cases.
+- Observed: dry-run deletes nothing; keep-N honored; newest kept; receipt written; isolation asserted.
+- Correction (recorded): suite-hardening edits (prune section config scoping, duplicate helper removal) were applied in the same phase.
+
+## Phase 17: Conductor auto-apply policy (M12) — recorded retroactively
+
+- Timestamp of work: 2026-09-03; recorded: 2026-09-03 (back-filled)
+- Summary: `conductor-policy.json` (tracked, strictly validated: enabled switch, path allowlist, gating suites) + `scripts/conductor-apply.sh <runId>` - succeeded-run check, clean target tree, allowlist, syntax gates, apply, suites, attribution commit; any failure reverts; push never automatic. 17 sandbox suite cases.
+- Observed: all gates green; suite-failure auto-revert verified; disabled policy refuses with exit 2.
+- Decision recorded: review moves to after-the-fact (history revertible) for worker patches under the policy; push remains explicit.
+
+## Phase 18: Live user context (M14) — recorded retroactively
+
+- Timestamp of work: 2026-09-03; recorded: 2026-09-03 (back-filled)
+- Summary: USER.md removed from immutable contracts (wrong owner - user info is user-owned live context); `<dataRoot>/user/*.md` dispatched (sorted) into every agent launch's generated prompt; bootstrap seeds `user/USER.md` once; loader layers now governance -> persona -> identity -> mission -> user.
+- Observed: user edit propagates to next launch (TUI or headless) without rebuilds; contract-only prompts unchanged when no user dir present.
+- Correction (recorded): first implementation pass did not regenerate the container - caught by owner test (edits to repo/mirror copies of USER.md did not propagate; the design, not the test, was the defect).
+
+## Phase 19: Agent seats + roles/ convention (M15) — recorded retroactively
+
+- Timestamp of work: 2026-09-03; recorded: 2026-09-03 (back-filled)
+- Summary: `agents/<name>/` holds `agent.json` (strict validation: version, name, role?, capabilities?, workspace?, session?) + `SOUL.md` persona; `agent.sh` validates, copies runtime SOUL to `dataRoot/agents/<name>/`, sets `MOSAIC_AGENT_SOUL_FILE`; loader fills the SOUL slot from the seat persona (contract SOUL = default); identity section gains role; per-agent default workspace; compose passthroughs.
+- Observed: launch with seat definition replaces the contract persona in the generated prompt; role in identity; seat record written once; suites green; RELEASE 0.0.10 packaged, health-gated activated.
+- Correction (recorded): RELEASE was not bumped when container content changed - tag r0.0.9 rebuilt with different content (invariant lapse; r0.0.9 was never active). Restored: RELEASE 0.0.10 packaged beside, health-gated, activated.
+- Conventions recorded per owner direction: repository root holds bootstrap-required configuration only; role contracts live in `roles/`.
+
+## Backfill note
+
+Phases 16-19 were recorded retroactively on 2026-09-03 after editor-session races
+left them unwritten at the time of work. Ground truth for each entry: the git
+history (commit subjects/bodies), the Gitea milestone/issue records (#32, #34,
+#35, #36), and the suite files themselves. No facts were reconstructed from
+memory alone.
+
+---
+
+## Phase 20: Release self-determination (M16)
+
+### Entry 20.1 — before
+
+- Timestamp: 2026-09-03
+- Intended action: The system determines what is installed and aligns itself; the user never manually runs release.sh. `release.sh ensure` (align-or-noop) invoked automatically by human-facing launchers (hello, verify, agent); run-task reports drift without auto-aligning (workers/suites must not trigger builds or model gates mid-automation).
+- Reason: Owner direction — intelligence in operation; post-reset pointer loss required a manual release command, which contradicts the self-healing design.
+- Expected result: post-reset pointer loss auto-restores via health-gated ensure; drift warns on run-task; aligned state is a no-op; M20 packages/* decision recorded.
+
+### Entry 20.2 — after
+
+- Timestamp: 2026-09-03
+- Commands run: ensure with pointer removed (live drift); ensure idempotence; drift-warning demo via RELEASE bump without packaging; full suites.
+- Observed result: drift detected (active: none, desired: 0.0.11) -> health-gated activate -> aligned; second ensure no-op; run-task drift warning fired on desired-version bump without packaging; all suites green (24/68/17/14 + verify).
+- Failure or correction:
+  1. First run-task edit anchor missed (inline comment mismatch) — reapplied with exact text.
+  2. RELEASE was temporarily bumped to 0.0.12 without packaging for the drift demo — restored to 0.0.11; state pointer remained aligned.
+- M20 decision recorded in ROADMAP.md: v2 adopts packages/* monorepo structure at usurpation (owner, continuity-first).
+- Process note (tool races): mechanism confirmed — batching a file write/edit and a dependent bash command in one parallel block runs the bash before the write flushes. Consequences: lost doc updates, stale anchors, one premature grep. Operating rule: dependent calls sequential; every write verified before claimed complete.
+
+## Result (M16)
+
+Release self-determination live: the system aligns itself to RELEASE without manual commands. Suites 24/68/17/14 + verify green.
+
+## Phase 21: M16 hardening + M20 decision
+
+- Recursion guard: release.sh's health-gate task run sets MOSAIC_ENSURE_SKIP
+  so the gate's run-task cannot re-enter release self-determination.
+- run-task.sh: drift warning on pointer/RELEASE mismatch (workers and suites
+  never trigger builds or model gates mid-automation).
+- ROADMAP M20 decision recorded: v2 adopts packages/* monorepo structure at
+  usurpation (owner, continuity-first); restructure sequenced as M20 phase 1.
+- Live drill: drift 0.0.11 -> 0.0.12 detected, health-gated activate, no
+  recursion, verify green.
@@ -1,45 +1 @@
-# CLAUDE.md — Mosaic Stack
-
-## Project
-
-Self-hosted, multi-user AI agent platform. TypeScript monorepo.
-
-## Stack
-
- **API**: NestJS + Fastify adapter (`apps/gateway`)
- **Web**: Next.js 16 + React 19 (`apps/web`)
- **ORM**: Drizzle ORM + PostgreSQL 17 + pgvector (`packages/db`)
- **Auth**: BetterAuth (`packages/auth`)
- **Agent**: Pi SDK (`packages/agent`, `packages/mosaic`)
- **Queue**: Valkey 8 (`packages/queue`)
- **Build**: pnpm workspaces + Turborepo
- **CI**: Woodpecker CI
- **Observability**: OpenTelemetry → Jaeger
-
-## Commands
-
-```bash
-pnpm typecheck        # TypeScript check (all packages)
-pnpm lint             # ESLint (all packages)
-pnpm format:check     # Prettier check
-pnpm test             # Vitest (all packages)
-pnpm build            # Build all packages
-
-# Database
-pnpm --filter @mosaicstack/db db:push      # Push schema to PG (dev)
-pnpm --filter @mosaicstack/db db:generate  # Generate migrations
-pnpm --filter @mosaicstack/db db:migrate   # Run migrations
-
-# Dev
-docker compose up -d                  # Start PG, Valkey, OTEL, Jaeger
-pnpm --filter @mosaicstack/gateway exec tsx src/main.ts  # Start gateway
-```
-
-## Conventions
-
- ESM everywhere (`"type": "module"`, `.js` extensions in imports)
- NodeNext module resolution
- Explicit `@Inject()` decorators in NestJS (tsx/esbuild doesn't support emitDecoratorMetadata)
- DTOs in `*.dto.ts` files at module boundaries
- OTEL tracing imported before NestJS bootstrap (`import './tracing.js'`)
- All three gates must pass before push: typecheck, lint, format:check
+@AGENTS.md
@@ -0,0 +1,43 @@
+# Minimal Mosaic Stack POC agent image.
+# Base: maintained Node.js image (same family as Pi's documented
+# containerization example in docs/containerization.md).
+FROM node:24-bookworm-slim
+
+# Tools Pi's documented container image expects (bash, CA certs, git, ripgrep).
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends bash ca-certificates git ripgrep \
+    && rm -rf /var/lib/apt/lists/*
+
+# Non-root user: the maintained node image ships a 'node' user at
+# uid/gid 1000, which matches the host user that owns the runtime
+# state directory mounted at /var/lib/mosaic. It is reused as-is.
+
+# Pinned Pi install: package.json pins the exact version and
+# package-lock.json is installed with npm ci. No unversioned installs.
+WORKDIR /opt/app
+COPY package.json package-lock.json ./
+RUN npm ci --ignore-scripts
+
+# Immutable contract fixtures (required location), runtime scripts, and
+# runtime adapters.
+COPY contracts /opt/mosaic/contracts
+COPY src /opt/mosaic/src
+COPY adapters /opt/mosaic/adapters
+RUN chmod 0555 /opt/mosaic/contracts /opt/mosaic/contracts/* \
+    && chmod 0555 /opt/mosaic/src /opt/mosaic/src/*.sh \
+    && chmod 0555 /opt/mosaic/adapters /opt/mosaic/adapters/*/adapter.sh
+
+# Writable state, workspace, and pi agent directory (auth.json is
+# bind-mounted read-only at runtime; nothing is copied into the image).
+RUN mkdir -p /var/lib/mosaic /workspace /home/node/.pi/agent \
+    && chown -R node:node /var/lib/mosaic /workspace /home/node /opt/app
+
+USER node
+WORKDIR /workspace
+ENV HOME=/home/node \
+    PATH="/opt/app/node_modules/.bin:${PATH}" \
+    PI_OFFLINE=1
+
+# One-shot agent: args form the user request (default is the startup
+# verification request defined in compose.yaml).
+ENTRYPOINT ["/opt/mosaic/src/run-agent.sh"]
@@ -1,45 +0,0 @@
-# Pre-baked CI base image for Woodpecker pipelines.
-#
-# Purpose: eliminate the cold `pnpm install` that dominates every pipeline
-# (~731s median). This image ships the native toolchain (no per-run `apk add`)
-# AND a warm, content-addressable pnpm store with the dependency-tree tarballs
-# already fetched at build time. `pnpm fetch` only populates the store from the
-# lockfile — it does NOT run the native node-gyp builds (better-sqlite3,
-# node-pty, sqlite3, canvas, sharp); those still compile at `pnpm install`,
-# which is exactly why the musl toolchain stays baked into this image. A
-# pipeline `pnpm install --frozen-lockfile --prefer-offline` then resolves
-# tarballs from local hard-links (no network) and compiles natives against the
-# already-present toolchain, in tens of seconds instead of ~731s.
-#
-# Rebuilt only when `pnpm-lock.yaml` or this Dockerfile change
-# (see .woodpecker/ci-image.yml).
-#
-# Node version is pinned to 24 (Active LTS). This is the follow-up bump from
-# node:22 — sequenced AFTER the CI cache work landed so the runtime change
-# carries zero cache variables. node:26 stays held until it reaches LTS
-# (Oct 2026); the Current line risks native-module (node-gyp) breakage on a
-# runner that compiles better-sqlite3 / canvas / sharp / node-pty from source.
-FROM node:24-alpine
-
-# Native toolchain required to compile node-gyp deps on musl, plus the
-# postgresql-client used by the test step's pg_isready readiness probe. `bash`
-# is baked here too — the sanitization step in ci.yml otherwise does a per-run
-# `apk add bash`.
-RUN apk add --no-cache python3 make g++ postgresql-client bash
-
-# Pin pnpm to the repo's packageManager version via corepack.
-RUN corepack enable && corepack prepare [email protected] --activate
-
-WORKDIR /app
-
-# Pin the store location so the pipeline can point `store-dir` at the same path.
-ENV PNPM_HOME=/root/.local/share/pnpm
-RUN pnpm config set store-dir /root/.local/share/pnpm/store
-
-# Warm the store. `pnpm fetch` populates the content-addressable store with the
-# dependency tarballs directly from the lockfile (no package.json / workspace
-# needed), so a baked store stays valid until the lockfile changes. Note:
-# `fetch` does NOT compile native modules — that happens later at `pnpm install`
-# in the pipeline, against the toolchain baked above.
-COPY pnpm-lock.yaml ./
-RUN pnpm fetch --frozen-lockfile
@@ -0,0 +1,50 @@
+# LAYERS
+
+Deferred capability layers for the Mosaic experiment. Only L0 is implemented by
+this proof of concept; everything below it is documented here and deliberately
+not implemented (see BRIEF.md, "Explicit exclusions").
+
+## L0 — Implemented: container returns MOSAIC_HELLO_OK
+
+One image (`mosaic-poc-agent:0.84.4`, built on `node:24-bookworm-slim`, non-root,
+pinned Pi) runs one Pi agent one-shot. Four immutable local contract files are
+loaded in fixed order into the generated system prompt
+(`/var/lib/mosaic/system-prompt.md`). One real model request is sent
+noninteractively; the response must equal `MOSAIC_HELLO_OK` exactly or the
+verification exits nonzero. Authentication is supplied at runtime only
+(read-only mounted pi auth file, or a provider API key environment variable).
+
+## L1 — Deferred: persist and resume a named Pi session
+
+Keep a named Pi session across container runs (`--name`, session storage under
+`/var/lib/mosaic`), resume it with the documented session flags, and verify
+state survives a container restart.
+
+## L2 — Deferred: fixed tool permission policy
+
+Add a fixed allow/deny policy for Pi tools (e.g. restricting built-in tools via
+documented `--tools` / `--exclude-tools` or an extension-based permission gate),
+so contract files can constrain what the agent may do, not just what it says.
+
+## L3 — Deferred: load full versioned contract bundles
+
+Replace the four static fixtures with versioned contract bundles: bundle
+manifests, contract versions, and deterministic ordering/hashing, loaded from
+an immutable bundle artifact instead of files copied at image build time.
+
+## L4 — Deferred: Claude as a second runtime
+
+Add a second runtime (Claude) alongside the Pi agent in the same container
+stack, behind the same contract-loading path, to compare behavior across
+runtimes.
+
+## L5 — Deferred: multiple agents and communication
+
+Run several named agents with defined roles and a communication channel between
+them (message passing or shared state under `/var/lib/mosaic`).
+
+## L6 — Deferred: orchestration, knowledge storage, and portal features
+
+Fleet-level orchestration, knowledge storage, monitoring, and portal UI on top
+of L1-L5. This is where the existing Mosaic Stack concepts would be re-evaluated
+from first principles.
@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Mosaic Stack
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
@@ -1,364 +1,221 @@
-# Mosaic Stack
+# Minimal Mosaic Stack container POC

-Self-hosted, multi-user AI agent platform. One config, every runtime, same standards.
+Standalone experiment, not part of the Mosaic Stack repository or Software Factory.

-Mosaic gives you a unified launcher for Claude Code, Codex, OpenCode, and Pi — injecting consistent system prompts, guardrails, skills, and mission context into every session. A NestJS gateway provides the API surface, a Next.js dashboard gives you the UI, and a plugin system connects Discord, Telegram, and more.
+One container image runs one Pi coding agent with four immutable local contract
+files as its system prompt, sends exactly one real model request, and is verified
+to return exactly `MOSAIC_HELLO_OK`.

-## Quick Install
+## Layout

-```bash
-curl -fsSL https://mosaicstack.dev/install.sh | bash
+```text
+BRIEF.md            requirements for the original container proof
+BUILD-LOG.md        append-only build/verification log
+LAYERS.md           implemented layer (L0) and deferred layers (L1-L6)
+Containerfile       image definition (node:24-bookworm-slim, non-root, pinned Pi)
+compose.yaml        one service: mosaic-agent (one-shot; configured via env)
+package.json        pins @earendil-works/pi-coding-agent at exactly 0.84.4
+package-lock.json   resolved lockfile used by npm ci in the image
+.env.example        non-secret settings only (credential-file path, env-var auth)
+contracts/          CONSTITUTION.md, STANDARDS.md, SOUL.md, USER.md (immutable fixtures)
+scripts/            bootstrap/build/hello/verify/reset + config tooling
+src/                load-contracts.sh, run-agent.sh (run inside the container)
+docs/plans/         architecture and milestone plans
 ```

-Or use the direct URL:
+## Configuration

-```bash
-bash <(curl -fsSL https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh)
+The sole discovery entry point is:
+
+```text
+~/.config/mosaic-dev/config.json
 ```

-The installer auto-launches the setup wizard, which walks you through gateway install and verification. Flags for non-interactive use:
+Created only by the explicit, idempotent bootstrap:

 ```bash
-bash <(curl -fsSL …) --yes               # Accept all defaults
-bash <(curl -fsSL …) --yes --no-auto-launch  # Install only, skip wizard
+scripts/bootstrap.sh   # create-if-absent; validates existing config, never rewrites
 ```

-This installs both components:
+Minimal shape (`configVersion` 1):

-| Component               | What                                                             | Where                |
-| ----------------------- | ---------------------------------------------------------------- | -------------------- |
-| **Framework**           | Bash launcher, guides, runtime configs, tools, skills            | `~/.config/mosaic/`  |
-| **@mosaicstack/mosaic** | Unified `mosaic` CLI — TUI, gateway client, wizard, auto-updater | `~/.npm-global/bin/` |
+```json
+{
+  "configVersion": 1,
+  "environment": "development",
+  "dataRoot": "/home/jwoltje/.mosaic-dev",
+  "execution": {
+    "backend": "docker",
+    "provider": "zai",
+    "model": "glm-5.3-flash"
+  }
+}
+```

-After install, the wizard runs automatically or you can invoke it manually:
+Rules enforced by `scripts/mosaic-config.mjs`:
+
+- Unknown keys, unsupported versions/backends, and malformed JSON exit nonzero; nothing is modified.
+- `dataRoot` must be absolute, canonical, and must not be or contain the home or configuration directory.
+- Validation failures never touch config, state, or images.
+- `scripts/test-config.sh` runs the sandboxed config selftests (no Docker required).
+
+Run paths (`build/hello/verify/reset`) fail closed when configuration is missing or invalid; they never invent it.
+
+## Missions & tasks (M2)
+
+Missions and tasks are validated JSON data (strict schemas, version-pinned). The M2 layer is host-side only: mission directives are recorded for provenance but do not yet reach the runtime system prompt (capability/policy layer comes later).
+
+```text
+missions/hello.json          objective + directives (missionVersion 1)
+tasks/hello-marker.json      prompt + optional mission ref + expectExact + timeout
+<dataRoot>/runs/r-<id>/      immutable run record: task.json, mission.json,
+                             stderr.txt, result.json (all write-once)
+```
+
+Usage:

 ```bash
-mosaic wizard        # Full guided setup (gateway install → verify)
+scripts/run-task.sh validate tasks/hello-marker.json   # strict validation, writes nothing
+scripts/run-task.sh run tasks/hello-marker.json        # execute; result recorded under dataRoot/runs
+scripts/mosaic-task.mjs list                           # list runs and statuses
+scripts/test-task.sh                                   # selftests (schema negatives + live runs)
 ```

-### Requirements
+A run exits 0 only when its expectation is met (`expectExact` match); mismatches, nonzero agent exits, and timeouts record `status: failed` in `result.json` and exit 1. Each run gets a unique directory — rerunning never rewrites history.

- Node.js ≥ 20
- npm (for global @mosaicstack/mosaic install)
- One or more runtimes: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai), or [Pi](https://github.com/mariozechner/pi-coding-agent)
+## Release model (M3)
+
+`RELEASE` single-sources the release version (0.0.X until declared stable); the image tag derives from it plus the pinned Pi version. Activation is health-gated and every event is recorded:
+
+```bash
+scripts/release.sh package                    # build + tag the release image
+scripts/release.sh activate                   # health check (exact marker) -> atomic pointer swap
+scripts/release.sh activate --fault-injection # prove the refusal path (drills only)
+scripts/release.sh rollback                   # health-gated return to the previous release
+scripts/release.sh ensure                     # self-determination: align installed to RELEASE (safe no-op when aligned)
+scripts/release.sh status                     # release, tag, active pointer, recent log
+scripts/test-release.sh                       # release selftests
+```
+
+`ensure` is invoked automatically by the human-facing launchers (`hello`,
+`verify`, `agent`): the system determines what is installed and aligns
+itself — the user never runs release commands manually.
+
+- `<dataRoot>/state/active.json` — the activation pointer (atomic tmp+rename replace)
+- `<dataRoot>/state/activation-log.jsonl` — append-only history: package / activate / refused / rollback
+
+A failed health check never activates; the previously active release remains deployed. Updating the software therefore cannot corrupt the running installation: package beside, gate, then flip. Verified by the update/refusal/rollback drills in BUILD-LOG Phase 7.
+
+## Runtime adapters (M4)
+
+The harness boundary is formalized: everything upstream (config, contracts, missions, tasks, run records) is harness-agnostic; everything inside an adapter belongs to one runtime.
+
+```text
+adapters/<name>/adapter.sh   env in: MOSAIC_SYSTEM_PROMPT_FILE, MOSAIC_REQUEST,
+                             MOSAIC_PROVIDER, MOSAIC_MODEL
+                             stdout: response only; stderr: diagnostics
+```
+
+- Selection: `execution.adapter` in config.json (optional; `pi` default; allowlist `pi`, `mock`)
+- `pi` — pinned Pi CLI, noninteractive print mode, ambient discovery off
+- `mock` — deterministic test adapter; never for real verification
+- Mission directives have a sanctioned injection point: when a task references a mission, the task runner mounts the run snapshot and the generated prompt gains a `MISSION (runtime)` section (objective + directives) after the four immutable contracts
+- Adding a harness (Claude, Codex, OpenCode) later means adding one directory — no orchestrator changes
+
+See `adapters/README.md` for the full contract.
+
+## Workspaces, capabilities, sessions (M5/M6)
+
+Optional task fields extend what an agent can do — all defaulting to the previous behavior:
+
+```json
+{
+  "workspace": "demo",                          // ":run" ephemeral, or persistent dataRoot/workspaces/<name>
+  "capabilities": { "tools": ["bash", "read"] }, // pi tool allowlist; absent = no tools
+  "session": "demo"                             // persistent session at dataRoot/sessions/<name>
+}
+```
+
+- The adapter runs inside the workspace; files it writes are host-visible (`dataRoot/workspaces/<name>`).
+- Sessions persist via pi's documented `--session-dir`; a follow-up run in the same session resumes the conversation (`-c`) and can recall prior context. Distinct names never share state. Ephemeral (`--no-session`) remains the default when no session is declared.
+- Selection authority: config for adapter/provider/model; the task file for workspace/capabilities/session.
+
+Inspect anything:
+
+```bash
+node scripts/mosaic-task.mjs list                # runs with task/workspace/session columns
+node scripts/mosaic-task.mjs show <runId>        # full record + snapshots + artifacts
+```
+
+Demo fixtures: `tasks/workspace-demo.json`, `tasks/session-demo-1.json` + `tasks/session-demo-2.json`.
+
+See `docs/plans/2026-09-02_atomic-mosaic-foundation.md` for the full plan.
+
+Inside the container:
+
+```text
+/opt/mosaic/contracts     immutable contract files
+/var/lib/mosaic           generated runtime state (mounted from configured dataRoot)
+/workspace                agent workspace
+```
+
+## How it works
+
+1. `scripts/build.sh` builds the release image (`mosaic-poc-agent:<pi>-r<release>`,
+   tag derived from `RELEASE` + the pinned Pi version) with Docker Compose.
+2. On each run, `/opt/mosaic/src/load-contracts.sh` reads the four contract files
+   in fixed order (CONSTITUTION, STANDARDS, SOUL, USER), joins them with clear
+   separators, and writes `/var/lib/mosaic/system-prompt.md`.
+3. `/opt/mosaic/src/run-agent.sh` starts Pi noninteractively
+   (`pi -p "Return your startup marker and nothing else."`) with
+   `--system-prompt "$(cat /var/lib/mosaic/system-prompt.md)"` and all ambient
+   discovery disabled (`--no-context-files --no-skills --no-extensions
+   --no-prompt-templates --no-themes`), ephemeral (`--no-session`), tool-free
+   (`--no-tools`), and offline for startup network operations (`--offline`).
+4. `scripts/verify.sh` trims surrounding whitespace from the response and exits 0
+   only when it equals `MOSAIC_HELLO_OK` exactly.

 ## Usage

-### Launching Agent Sessions
+```bash
+scripts/bootstrap.sh   # create config.json if absent (idempotent)
+scripts/build.sh       # build the image
+scripts/hello.sh       # one-shot request; prints the model response
+scripts/verify.sh      # full gated test; exit 0 only on exact MOSAIC_HELLO_OK
+scripts/run-task.sh    # run a mission/task file (see Missions & tasks)
+scripts/release.sh     # package / activate / rollback / status (see Release model)
+scripts/test-config.sh # fast config-layer selftests (no Docker)
+scripts/test-task.sh   # mission/task selftests (schema + adapter seam + live runs)
+scripts/test-release.sh # release selftests
+scripts/reset.sh       # delete the configured data root (safety-checked)
+```
+
+Prove the failure path (acceptance criterion 9):

 ```bash
-mosaic pi                    # Launch Pi with Mosaic injection
-mosaic claude                # Launch Claude Code with Mosaic injection
-mosaic codex                 # Launch Codex with Mosaic injection
-mosaic opencode              # Launch OpenCode with Mosaic injection
-
-mosaic yolo claude           # Claude with dangerous-permissions mode
-mosaic yolo pi               # Pi in yolo mode
+EXPECTED_MARKER=MOSAIC_NOT_OK scripts/verify.sh   # must exit nonzero
 ```

-The launcher verifies your config, checks for `SOUL.md`, injects your `AGENTS.md` standards into the runtime, and forwards all arguments.
+## Authentication

-Pi launches default to a token-lean skill posture: `mosaic pi` passes `--no-skills` so Pi does not preload every global skill description into the system prompt. Use `MOSAIC_PI_SKILL_MODE=all mosaic pi` for the legacy all-skills catalog, or `MOSAIC_PI_SKILL_MODE=discover mosaic pi` to let Pi use its native settings/project skill discovery.
+Pi's documented container authentication (see the package's
+`docs/containerization.md`) is used, in this order:

-### TUI & Gateway
+1. **Read-only mounted credential file** (default): the host pi auth file
+   `~/.pi/agent/auth.json` is bind-mounted read-only to
+   `/home/node/.pi/agent/auth.json`. The host file holds a static API-key
+   entry for the built-in `zai` provider, so no token refresh writes are needed.
+2. **Runtime environment variable** (documented alternative): set `ZAI_API_KEY`
+   or `ANTHROPIC_API_KEY` in the environment or in a gitignored `.env`; compose
+   passes them through. Pi's documented precedence applies.

-```bash
-mosaic tui                   # Interactive TUI connected to the gateway
-mosaic gateway login         # Authenticate with a gateway instance
-mosaic sessions list         # List active agent sessions
-```
+Credentials are never committed, never copied into the image, and never printed.
+`.env.example` contains non-secret settings only.

-### Gateway Management
+## Boundaries honored

-```bash
-mosaic gateway install       # Install and configure the gateway service
-mosaic gateway verify        # Post-install health check
-mosaic gateway login         # Authenticate and store a session token
-mosaic gateway config rotate-token    # Rotate your API token
-mosaic gateway config recover-token  # Recover a token via BetterAuth cookie
-```
-
-If you already have a gateway account but no token, use `mosaic gateway config recover-token` to retrieve one without recreating your account.
-
-### Configuration
-
-Mosaic supports three storage tiers: `local` (PGlite, single-host), `standalone` (PostgreSQL, single-host), and `federated` (PostgreSQL + pgvector + Valkey, multi-host). See [Federated Tier Setup](docs/federation/SETUP.md) for multi-user and production deployments, or [Migrating to Federated](docs/guides/migrate-tier.md) to upgrade from existing tiers.
-
-```bash
-mosaic config show           # Print full config as JSON
-mosaic config get <key>      # Read a specific key
-mosaic config set <key> <val># Write a key
-mosaic config edit           # Open config in $EDITOR
-mosaic config path           # Print config file path
-```
-
-### Management
-
-```bash
-mosaic doctor                # Health audit — detect drift and missing files
-mosaic sync                  # Sync skills from canonical source
-mosaic update                # Check for and install CLI updates
-mosaic wizard                # Full guided setup wizard
-mosaic bootstrap <path>      # Bootstrap a repo with Mosaic standards
-mosaic coord init            # Initialize a new orchestration mission
-mosaic prdy init             # Create a PRD via guided session
-```
-
-### Sub-package Commands
-
-Each Mosaic sub-package exposes its API surface through the unified CLI:
-
-```bash
-# User management
-mosaic auth users list
-mosaic auth users create
-mosaic auth sso
-
-# Agent brain (projects, missions, tasks)
-mosaic brain projects
-mosaic brain missions
-mosaic brain tasks
-mosaic brain conversations
-
-# Agent forge pipeline
-mosaic forge run
-mosaic forge status
-mosaic forge resume
-mosaic forge personas
-
-# Structured logging
-mosaic log tail
-mosaic log search
-mosaic log export
-mosaic log level
-
-# MACP protocol
-mosaic macp tasks
-mosaic macp submit
-mosaic macp gate
-mosaic macp events
-
-# Agent memory
-mosaic memory search
-mosaic memory stats
-mosaic memory insights
-mosaic memory preferences
-
-# Task queue (Valkey)
-mosaic queue list
-mosaic queue stats
-mosaic queue pause
-mosaic queue resume
-mosaic queue jobs
-mosaic queue drain
-
-# Object storage
-mosaic storage status
-mosaic storage tier
-mosaic storage export
-mosaic storage import
-mosaic storage migrate
-```
-
-### Telemetry
-
-```bash
-# Local observability (OTEL / Jaeger)
-mosaic telemetry local status
-mosaic telemetry local tail
-mosaic telemetry local jaeger
-
-# Remote telemetry (dry-run by default)
-mosaic telemetry status
-mosaic telemetry opt-in
-mosaic telemetry opt-out
-mosaic telemetry test
-mosaic telemetry upload        # Dry-run unless opted in
-```
-
-Consent state is persisted in config. Remote upload is a no-op until you run `mosaic telemetry opt-in`.
-
-## Development
-
-### Prerequisites
-
- Node.js ≥ 20
- pnpm 10.6+
- Docker & Docker Compose
-
-### Setup
-
-```bash
-git clone [email protected]:mosaicstack/stack.git
-cd stack
-
-# Start infrastructure (Postgres, Valkey, Jaeger)
-docker compose up -d
-
-# Install dependencies
-pnpm install
-
-# Run migrations
-pnpm --filter @mosaicstack/db run db:migrate
-
-# Start all services in dev mode
-pnpm dev
-```
-
-### Infrastructure
-
-Docker Compose provides:
-
-| Service               | Port      | Purpose                |
-| --------------------- | --------- | ---------------------- |
-| PostgreSQL (pgvector) | 5433      | Primary database       |
-| Valkey                | 6380      | Task queue + caching   |
-| Jaeger                | 16686     | Distributed tracing UI |
-| OTEL Collector        | 4317/4318 | Telemetry ingestion    |
-
-### Quality Gates
-
-```bash
-pnpm typecheck               # TypeScript type checking (all packages)
-pnpm lint                    # ESLint (all packages)
-pnpm test                    # Vitest (all packages)
-pnpm format:check            # Prettier check
-pnpm format                  # Prettier auto-fix
-```
-
-### CI
-
-Woodpecker CI runs on every push:
-
- `pnpm install --frozen-lockfile`
- Database migration against a fresh Postgres
- `pnpm test` (Turbo-orchestrated across all packages)
-
-npm packages are published to the Gitea package registry on main merges.
-
-## Architecture
-
-```
-stack/
-├── apps/
-│   ├── gateway/             NestJS API + WebSocket hub (Fastify, Socket.IO, OTEL)
-│   └── web/                 Next.js dashboard (React 19, Tailwind)
-├── packages/
-│   ├── mosaic/              Unified CLI — TUI, gateway client, wizard, sub-package commands
-│   ├── types/               Shared TypeScript contracts (Socket.IO typed events)
-│   ├── db/                  Drizzle ORM schema + migrations (pgvector)
-│   ├── auth/                BetterAuth configuration
-│   ├── brain/               Data layer (PG-backed)
-│   ├── queue/               Valkey task queue + MCP
-│   ├── coord/               Mission coordination
-│   ├── forge/               Multi-stage AI pipeline (intake → board → plan → code → review)
-│   ├── macp/                MACP protocol — credential resolution, gate runner, events
-│   ├── agent/               Agent session management
-│   ├── memory/              Agent memory layer
-│   ├── log/                 Structured logging
-│   ├── prdy/                PRD creation and validation
-│   ├── quality-rails/       Quality templates (TypeScript, Next.js, monorepo)
-│   └── design-tokens/       Shared design tokens
-├── plugins/
-│   ├── discord/             Discord channel plugin (discord.js)
-│   ├── telegram/            Telegram channel plugin (Telegraf)
-│   ├── macp/                OpenClaw MACP runtime plugin
-│   └── mosaic-framework/    OpenClaw framework injection plugin
-├── tools/
-│   └── install.sh           Unified installer (framework + npm CLI, --yes / --no-auto-launch)
-├── scripts/agent/           Agent session lifecycle scripts
-├── docker-compose.yml       Dev infrastructure
-└── .woodpecker/             CI pipeline configs
-```
-
-### Key Design Decisions
-
- **Gateway is the single API surface** — all clients (TUI, web, Discord, Telegram) connect through it
- **ESM everywhere** — `"type": "module"`, `.js` extensions in imports, NodeNext resolution
- **Socket.IO typed events** — defined in `@mosaicstack/types`, enforced at compile time
- **OTEL auto-instrumentation** — loads before NestJS bootstrap
- **Explicit `@Inject()` decorators** — required since tsx/esbuild doesn't emit decorator metadata
-
-### Framework (`~/.config/mosaic/`)
-
-The framework is the bash-based standards layer installed to every developer machine:
-
-```
-~/.config/mosaic/
-├── AGENTS.md              ← Central standards (loaded into every runtime)
-├── SOUL.md                ← Agent identity (name, style, guardrails)
-├── USER.md                ← User profile (name, timezone, preferences)
-├── TOOLS.md               ← Machine-level tool reference
-├── bin/mosaic             ← Unified launcher (claude, codex, opencode, pi, yolo)
-├── guides/                ← E2E delivery, orchestrator protocol, PRD, etc.
-├── runtime/               ← Per-runtime configs (claude/, codex/, opencode/, pi/)
-├── skills/                ← Universal skills (synced from agent-skills repo)
-├── tools/                 ← Tool suites (orchestrator, git, quality, prdy, etc.)
-└── memory/                ← Persistent agent memory (preserved across upgrades)
-```
-
-### Forge Pipeline
-
-Forge is a multi-stage AI pipeline for autonomous feature delivery:
-
-```
-Intake → Discovery → Board Review → Planning (3 stages) → Coding → Review → Remediation → Test → Deploy
-```
-
-Each stage has a dispatch mode (`exec` for research/review, `yolo` for coding), quality gates, and timeouts. The board review uses multiple AI personas (CEO, CTO, CFO, COO + specialists) to evaluate briefs before committing resources.
-
-## Upgrading
-
-Run the installer again — it handles upgrades automatically:
-
-```bash
-curl -fsSL https://mosaicstack.dev/install.sh | bash
-```
-
-Or use the direct URL:
-
-```bash
-bash <(curl -fsSL https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh)
-```
-
-Or use the CLI:
-
-```bash
-mosaic update                # Check + install CLI updates
-mosaic update --check        # Check only, don't install
-```
-
-The CLI also performs a background update check on every invocation (cached for 1 hour).
-
-### Installer Flags
-
-```bash
-bash tools/install.sh --check           # Version check only
-bash tools/install.sh --framework       # Framework only (skip npm CLI)
-bash tools/install.sh --cli             # npm CLI only (skip framework)
-bash tools/install.sh --ref v1.0        # Install from a specific git ref
-bash tools/install.sh --yes             # Non-interactive, accept all defaults
-bash tools/install.sh --no-auto-launch  # Skip auto-launch of wizard
-```
-
-## Contributing
-
-```bash
-# Create a feature branch
-git checkout -b feat/my-feature
-
-# Make changes, then verify
-pnpm typecheck && pnpm lint && pnpm test && pnpm format:check
-
-# Commit (husky runs lint-staged automatically)
-git commit -m "feat: description of change"
-
-# Push and create PR
-git push -u origin feat/my-feature
-```
-
-DTOs go in `*.dto.ts` files at module boundaries. Scratchpads (`docs/scratchpads/`) are mandatory for non-trivial tasks. See `AGENTS.md` for the full standards reference.
-
-## License
-
-Proprietary — all rights reserved.
+- No mounts of `~/.mosaic` or `~/.config/mosaic`; no Docker socket mount.
+- Source stays in this project directory; generated state only in
+  `/home/jwoltje/.mosaic-dev` (host) and `/var/lib/mosaic` (container).
+- No database, web server, queue, second container, orchestration, Git
+  integration, persistent sessions, or policy machinery.
@@ -0,0 +1 @@
+0.0.12
@@ -0,0 +1,54 @@
+# Mosaic runtime adapters
+
+An adapter is the entire harness-specific surface of the system. Everything
+upstream of an adapter — configuration, contracts, missions, tasks, run
+records — is harness-agnostic; everything inside an adapter may assume one
+specific agent runtime.
+
+## Contract
+
+An adapter lives at:
+
+```text
+/opt/mosaic/adapters/<name>/adapter.sh
+```
+
+and must be executable. The dispatcher (`/opt/mosaic/src/run-agent.sh`)
+selects it via `MOSAIC_ADAPTER` (default: `pi`) and execs it after the
+system prompt has been generated.
+
+**Inputs (environment):**
+
+| Variable | Meaning |
+|---|---|
+| `MOSAIC_SYSTEM_PROMPT_FILE` | Absolute path to the generated system prompt (contracts + optional mission section). Read it; do not modify it. |
+| `MOSAIC_REQUEST` | The exact user request text (may contain newlines). |
+| `MOSAIC_PROVIDER` | Configured provider name. |
+| `MOSAIC_MODEL` | Configured model id. |
+
+Optional, adapter-specific (documented per adapter):
+
+| Variable | Meaning |
+|---|---|
+| `MOSAIC_MOCK_RESPONSE` | mock only: the verbatim response to emit |
+
+**Outputs:**
+
+- `stdout`: the model response text — the only channel the orchestrator captures
+- `stderr`: diagnostics (never credentials)
+- exit `0`: success; nonzero: failure
+
+## Rules
+
+1. Adapters print ONLY the response on stdout. Status lines go to stderr.
+2. Adapters never read configuration files; the resolved settings arrive via environment.
+3. Adapters never write outside `/var/lib/mosaic`.
+4. Adding an adapter requires: a new directory, the contract implementation, and
+   adding the name to the allowlist in `scripts/mosaic-config.mjs`.
+
+## Included adapters
+
+- `pi` — the pinned `@earendil-works/pi-coding-agent` CLI in noninteractive
+  print mode (`-p`), ambient discovery disabled, stdin detached.
+- `mock` — deterministic echo of `MOSAIC_MOCK_RESPONSE`. Test-only: never use
+  it where a real model response is required.
@@ -0,0 +1,18 @@
+#!/bin/sh
+# Mock adapter: deterministic response for seam tests. NEVER use where a
+# real model response is required.
+#
+# Contract: see /opt/mosaic/adapters/README.md.
+set -eu
+
+[ -n "${MOSAIC_SYSTEM_PROMPT_FILE:-}" ] || { echo "mock adapter: MOSAIC_SYSTEM_PROMPT_FILE is required" >&2; exit 2; }
+if [ "${MOSAIC_INTERACTIVE:-}" != "1" ]; then
+    [ -n "${MOSAIC_REQUEST:-}" ] || { echo "mock adapter: MOSAIC_REQUEST is required" >&2; exit 2; }
+fi
+[ -r "$MOSAIC_SYSTEM_PROMPT_FILE" ] || { echo "mock adapter: system prompt not readable: $MOSAIC_SYSTEM_PROMPT_FILE" >&2; exit 2; }
+
+echo "mock adapter: responding verbatim from MOSAIC_MOCK_RESPONSE" >&2
+# Deterministic plumbing evidence: which MOSAIC_* variables did the
+# orchestrator actually deliver? (Auth secrets are not MOSAIC_-prefixed.)
+(env | grep '^MOSAIC_' | sort) >&2 2>/dev/null || true
+printf '%s\n' "${MOSAIC_MOCK_RESPONSE:-}"
@@ -0,0 +1,96 @@
+#!/bin/sh
+# Pi adapter: implements the Mosaic adapter contract for the pinned
+# @earendil-works/pi-coding-agent CLI.
+#
+# Contract: see /opt/mosaic/adapters/README.md.
+# Headless (default): stdout = response only; stderr = diagnostics; exit 0.
+# Interactive (MOSAIC_INTERACTIVE=1): full pi TUI on the attached terminal.
+set -eu
+
+[ -n "${MOSAIC_SYSTEM_PROMPT_FILE:-}" ] || { echo "pi adapter: MOSAIC_SYSTEM_PROMPT_FILE is required" >&2; exit 2; }
+[ -r "$MOSAIC_SYSTEM_PROMPT_FILE" ] || { echo "pi adapter: system prompt not readable: $MOSAIC_SYSTEM_PROMPT_FILE" >&2; exit 2; }
+# MOSAIC_AGENT_NAME is optional in headless mode (identity section is then
+# omitted); interactive launches always set it via scripts/agent.sh.
+
+: "${PI_PROVIDER:?pi adapter: PI_PROVIDER is required}"
+: "${PI_MODEL:?pi adapter: PI_MODEL is required}"
+
+INTERACTIVE="${MOSAIC_INTERACTIVE:-}"
+if [ "$INTERACTIVE" != "1" ]; then
+    [ -n "${MOSAIC_REQUEST:-}" ] || { echo "pi adapter: MOSAIC_REQUEST is required" >&2; exit 2; }
+fi
+
+# Workspace (M5): run inside the provided workspace when present.
+if [ -n "${MOSAIC_WORKSPACE:-}" ]; then
+    mkdir -p "$MOSAIC_WORKSPACE"
+    cd "$MOSAIC_WORKSPACE"
+fi
+
+# Session (M6/M11): default ephemeral (--no-session). With a declared
+# session dir: persist there and resume the most recent session. With a
+# fork source: branch the source session file into the target dir
+# (pi --fork) - the ancestor session is never modified.
+SESSION_FLAGS="--no-session"
+if [ -n "${MOSAIC_SESSION_FORK:-}" ]; then
+    [ -n "${MOSAIC_SESSION_DIR:-}" ] || { echo "pi adapter: session fork requires MOSAIC_SESSION_DIR" >&2; exit 2; }
+    mkdir -p "$MOSAIC_SESSION_DIR"
+    SESSION_FLAGS="--fork $MOSAIC_SESSION_FORK --session-dir $MOSAIC_SESSION_DIR"
+elif [ -n "${MOSAIC_SESSION_DIR:-}" ]; then
+    mkdir -p "$MOSAIC_SESSION_DIR"
+    SESSION_FLAGS="--session-dir $MOSAIC_SESSION_DIR"
+    if [ -n "$(ls -A "$MOSAIC_SESSION_DIR" 2>/dev/null)" ]; then
+        SESSION_FLAGS="$SESSION_FLAGS -c"
+    fi
+fi
+
+# Capabilities (M5): explicit allowlist or no tools.
+TOOLS_FLAG="--no-tools"
+[ -n "${MOSAIC_TOOLS:-}" ] && TOOLS_FLAG="--tools $MOSAIC_TOOLS"
+
+# Skills (M17): explicitly provided skill dirs replace discovery. When none
+# are provided the agent runs with --no-skills (nothing ambient to find).
+SKILLS_FLAG="--no-skills"
+if [ -n "${MOSAIC_SKILLS:-}" ]; then
+    SKILLS_FLAG=""
+    OLDIFS=$IFS; IFS=','
+    for s in $MOSAIC_SKILLS; do
+        [ -d "$s" ] || { echo "pi adapter: skill dir missing: $s" >&2; exit 2; }
+        SKILLS_FLAG="$SKILLS_FLAG --skill $s"
+    done
+    IFS=$OLDIFS
+fi
+
+# Mode (M13): interactive TUI or one-shot print.
+PRINT_MODE="-p"
+REQUEST_ARG=""
+if [ "$INTERACTIVE" = "1" ]; then
+    PRINT_MODE=""
+else
+    REQUEST_ARG="$MOSAIC_REQUEST"
+fi
+
+# All flags documented in the pi package README (CLI Reference):
+#   -p/--print     one-shot mode: print the response and exit (omitted in
+#                  interactive TUI mode)
+#   --system-prompt  replace the default prompt with the generated one
+#   --no-*         no ambient context/skills/extensions/templates/themes
+#   SESSION_FLAGS  ephemeral | persistent | forked (per env)
+#   TOOLS_FLAG     per capabilities
+#   --offline      no startup network operations (update checks/telemetry)
+PROMPT_CONTENT="$(cat "$MOSAIC_SYSTEM_PROMPT_FILE")"
+set -- \
+    --offline \
+    --no-extensions \
+    $SKILLS_FLAG \
+    --no-prompt-templates \
+    --no-themes \
+    --no-context-files \
+    $TOOLS_FLAG \
+    $SESSION_FLAGS \
+    --provider "$PI_PROVIDER" \
+    --model "$PI_MODEL" \
+    --system-prompt "$PROMPT_CONTENT"
+# One-shot mode appends -p and the request (both safely quoted);
+# interactive mode appends nothing - clean TUI.
+[ "$INTERACTIVE" = "1" ] || set -- "$@" -p "$MOSAIC_REQUEST"
+exec pi "$@"
@@ -0,0 +1,5 @@
+# SOUL - researcher
+
+You are the researcher seat of the Mosaic fleet. You are curious, methodical,
+and precise. You cite what you know, admit what you do not, and never guess
+when you can verify.
@@ -0,0 +1,6 @@
+{
+  "agentVersion": 1,
+  "name": "researcher",
+  "role": "researcher",
+  "capabilities": { "tools": ["read", "bash"] }
+}
@@ -1,35 +0,0 @@
-{
-  "name": "@mosaicstack/mosaic-as",
-  "version": "0.0.1",
-  "type": "module",
-  "private": true,
-  "repository": {
-    "type": "git",
-    "url": "https://git.mosaicstack.dev/mosaicstack/stack.git",
-    "directory": "apps/appservice"
-  },
-  "main": "dist/main.js",
-  "bin": {
-    "mosaic-as": "dist/main.js",
-    "mosaic-as-registration": "dist/registration-main.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "lint": "eslint src",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests",
-    "dev": "tsx watch src/main.ts"
-  },
-  "dependencies": {
-    "@mosaicstack/appservice": "workspace:*"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.8.0",
-    "vitest": "^2.0.0"
-  },
-  "files": [
-    "dist"
-  ]
-}
@@ -1,388 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-
-import { AppserviceDaemon } from '../server.js';
-import type { DaemonConfig, DaemonRequest } from '../server.js';
-
-const AGENTS_TYPE = 'org.uscllc.mosaic_as.agents';
-
-const cfg: DaemonConfig = {
-  homeserverUrl: 'https://hs.example',
-  domain: 'hs.example',
-  asToken: 'as-secret',
-  hsToken: 'hs-secret',
-  bridgeTokens: ['bridge-secret'],
-};
-
-const jsonResponse = (status: number, body: unknown): Response =>
-  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });
-
-const request = (overrides: Partial<DaemonRequest>): DaemonRequest => ({
-  method: 'GET',
-  path: '/',
-  searchParams: new URLSearchParams(),
-  body: undefined,
-  ...overrides,
-});
-
-const makeDaemon = () => {
-  const fetchMock = vi.fn(async (_input: URL | string) => jsonResponse(200, { event_id: '$sent' }));
-  const daemon = new AppserviceDaemon(cfg, fetchMock as unknown as typeof fetch, () => {});
-  return { daemon, fetchMock };
-};
-
-describe('AppserviceDaemon routing', () => {
-  it('serves health unauthenticated', async () => {
-    const { daemon } = makeDaemon();
-    expect((await daemon.handle(request({ path: '/health' }))).status).toBe(200);
-  });
-
-  it('404s unknown paths', async () => {
-    const { daemon } = makeDaemon();
-    expect((await daemon.handle(request({ path: '/nope' }))).status).toBe(404);
-  });
-
-  it('transactions require the hs_token', async () => {
-    const { daemon } = makeDaemon();
-    const bad = await daemon.handle(
-      request({
-        method: 'PUT',
-        path: '/_matrix/app/v1/transactions/t1',
-        authorizationHeader: 'Bearer wrong',
-        body: { events: [] },
-      }),
-    );
-    expect(bad.status).toBe(403);
-    const ok = await daemon.handle(
-      request({
-        method: 'PUT',
-        path: '/_matrix/app/v1/transactions/t1',
-        authorizationHeader: 'Bearer hs-secret',
-        body: { events: [{ type: 'm.room.message', event_id: '$e' }] },
-      }),
-    );
-    expect(ok.status).toBe(200);
-  });
-
-  it('bridge requires a bridge token (hs/as tokens do not work)', async () => {
-    const { daemon } = makeDaemon();
-    for (const token of [undefined, 'Bearer hs-secret', 'Bearer as-secret', 'Bearer nope']) {
-      const res = await daemon.handle(
-        request({
-          method: 'POST',
-          path: '/bridge/v1/messages',
-          authorizationHeader: token,
-          body: {},
-        }),
-      );
-      expect(res.status).toBe(403);
-    }
-  });
-
-  it('bridge message sends as the agent and returns the event id', async () => {
-    const { daemon, fetchMock } = makeDaemon();
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/messages',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { room_id: '!r:hs.example', agent: 'pi0-web1', body: 'hi', thread_root: '$req' },
-      }),
-    );
-    expect(res.status).toBe(200);
-    expect(res.body.event_id).toBe('$sent');
-    const sendCall = fetchMock.mock.calls
-      .map((c) => new URL(String(c[0])))
-      .find((u) => u.pathname.includes('/send/m.room.message/'));
-    expect(sendCall).toBeDefined();
-    expect(sendCall!.searchParams.get('user_id')).toBe('@agent-pi0-web1:hs.example');
-  });
-
-  it('bridge rejects invalid payloads with 400', async () => {
-    const { daemon } = makeDaemon();
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/messages',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { room_id: 'bad', agent: 'pi0', body: 'x' },
-      }),
-    );
-    expect(res.status).toBe(400);
-  });
-
-  it('bridge typing endpoint works', async () => {
-    const { daemon, fetchMock } = makeDaemon();
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/typing',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { room_id: '!r:hs.example', agent: 'pi0-web1', typing: true },
-      }),
-    );
-    expect(res.status).toBe(200);
-    const typingCall = fetchMock.mock.calls
-      .map((c) => new URL(String(c[0])))
-      .find((u) => u.pathname.includes('/typing/'));
-    expect(typingCall).toBeDefined();
-  });
-
-  it('authenticated unknown bridge sub-paths return 405, never fall through', async () => {
-    const { daemon } = makeDaemon();
-    const res = await daemon.handle(
-      request({
-        method: 'GET',
-        path: '/bridge/v1/unknown',
-        authorizationHeader: 'Bearer bridge-secret',
-      }),
-    );
-    expect(res.status).toBe(405);
-  });
-
-  it('provisions a room as the AS sender with space linking', async () => {
-    const calls: Array<{ url: URL; body: unknown }> = [];
-    const fetchMock = vi.fn(async (input: URL | string, init?: RequestInit) => {
-      const url = new URL(String(input));
-      calls.push({ url, body: init?.body ? JSON.parse(String(init.body)) : undefined });
-      if (url.pathname.endsWith('/createRoom'))
-        return jsonResponse(200, { room_id: '!new:hs.example' });
-      return jsonResponse(200, {});
-    });
-    const daemon = new AppserviceDaemon(cfg, fetchMock as unknown as typeof fetch, () => {});
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/provision/rooms',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: {
-          name: 'proj-x',
-          alias: 'mosaic-proj-x',
-          invite: ['@jason.woltje:hs.example'],
-          space_id: '!space:hs.example',
-        },
-      }),
-    );
-    expect(res.status).toBe(200);
-    expect(res.body.room_id).toBe('!new:hs.example');
-    expect(res.body.space_linked).toBe(true);
-    const create = calls.find((c) => c.url.pathname.endsWith('/createRoom'));
-    expect(create!.url.searchParams.get('user_id')).toBe('@mosaic-as:hs.example');
-    const body = create!.body as Record<string, unknown>;
-    expect(body.room_alias_name).toBe('mosaic-proj-x');
-    expect((body.power_level_content_override as Record<string, unknown>).users).toEqual({
-      '@mosaic-as:hs.example': 100,
-    });
-    expect(calls.some((c) => c.url.pathname.includes('/state/m.space.child/'))).toBe(true);
-    expect(calls.some((c) => c.url.pathname.includes('/state/m.space.parent/'))).toBe(true);
-  });
-
-  it('space-link failure still returns the room id (no orphan)', async () => {
-    const fetchMock = vi.fn(async (input: URL | string) => {
-      const url = new URL(String(input));
-      if (url.pathname.endsWith('/createRoom'))
-        return jsonResponse(200, { room_id: '!new:hs.example' });
-      if (url.pathname.includes('/state/m.space.child/'))
-        return jsonResponse(403, { errcode: 'M_FORBIDDEN', error: 'no PL in space' });
-      return jsonResponse(200, {});
-    });
-    const daemon = new AppserviceDaemon(cfg, fetchMock as unknown as typeof fetch, () => {});
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/provision/rooms',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { name: 'proj-x', space_id: '!space:hs.example' },
-      }),
-    );
-    expect(res.status).toBe(200);
-    expect(res.body.room_id).toBe('!new:hs.example');
-    expect(res.body.space_linked).toBe(false);
-    expect(String(res.body.space_error)).toContain('403');
-  });
-
-  it('invite list cap enforced', async () => {
-    const { daemon } = makeDaemon();
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/provision/rooms',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { name: 'x', invite: Array.from({ length: 51 }, (_, i) => `@u${i}:hs`) },
-      }),
-    );
-    expect(res.status).toBe(400);
-  });
-
-  it('provision rejects bad payloads and requires auth', async () => {
-    const { daemon } = makeDaemon();
-    const noAuth = await daemon.handle(
-      request({ method: 'POST', path: '/bridge/v1/provision/rooms', body: { name: 'x' } }),
-    );
-    expect(noAuth.status).toBe(403);
-    const bad = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/provision/rooms',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { name: '', alias: 'BAD ALIAS' },
-      }),
-    );
-    expect(bad.status).toBe(400);
-  });
-
-  // A daemon whose fetch mock backs account_data with a mutable in-test object,
-  // so register/verify/revoke round-trip through the (faked) homeserver.
-  const makeAgentDaemon = () => {
-    const accountData: { value: Record<string, unknown> | null } = { value: null };
-    const fetchMock = vi.fn(async (input: URL | string, init?: RequestInit) => {
-      const url = new URL(String(input));
-      const path = url.pathname;
-      if (path.includes(`/account_data/${AGENTS_TYPE}`)) {
-        if (init?.method === 'PUT') {
-          accountData.value = JSON.parse(String(init.body)) as Record<string, unknown>;
-          return jsonResponse(200, {});
-        }
-        if (accountData.value === null) {
-          return jsonResponse(404, { errcode: 'M_NOT_FOUND', error: 'not found' });
-        }
-        return jsonResponse(200, accountData.value);
-      }
-      if (path.endsWith('/register')) return jsonResponse(200, { user_id: 'whatever' });
-      if (path.includes('/send/m.room.message/')) return jsonResponse(200, { event_id: '$sent' });
-      return jsonResponse(200, {});
-    });
-    const daemon = new AppserviceDaemon(cfg, fetchMock as unknown as typeof fetch, () => {});
-    return { daemon, fetchMock };
-  };
-
-  const registerAgent = async (
-    daemon: AppserviceDaemon,
-    body: Record<string, unknown> = { alias: 'pi0', host: 'web1' },
-  ) =>
-    daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/agents',
-        authorizationHeader: 'Bearer bridge-secret',
-        body,
-      }),
-    );
-
-  it('host token registers an agent and returns agent_user_id + bridge_token', async () => {
-    const { daemon, fetchMock } = makeAgentDaemon();
-    const res = await registerAgent(daemon, { alias: 'pi0', host: 'web1' });
-    expect(res.status).toBe(200);
-    expect(res.body.agent_user_id).toBe('@agent-pi0-web1:hs.example');
-    expect(String(res.body.bridge_token).startsWith('magt_')).toBe(true);
-    const registerCall = fetchMock.mock.calls
-      .map((c) => new URL(String(c[0])))
-      .find((u) => u.pathname.endsWith('/register'));
-    expect(registerCall).toBeDefined();
-  });
-
-  it('register requires a HOST token (agent token and no token are 403)', async () => {
-    const { daemon } = makeAgentDaemon();
-    const minted = await registerAgent(daemon);
-    const agentToken = String(minted.body.bridge_token);
-
-    const asAgent = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/agents',
-        authorizationHeader: `Bearer ${agentToken}`,
-        body: { alias: 'pi1', host: 'web2' },
-      }),
-    );
-    expect(asAgent.status).toBe(403);
-
-    const noAuth = await daemon.handle(
-      request({ method: 'POST', path: '/bridge/v1/agents', body: { alias: 'pi1', host: 'web2' } }),
-    );
-    expect(noAuth.status).toBe(403);
-  });
-
-  it('agent-scoped token may send as itself but not as another agent', async () => {
-    const { daemon } = makeAgentDaemon();
-    const minted = await registerAgent(daemon, { alias: 'pi0', host: 'web1' });
-    const agentToken = String(minted.body.bridge_token);
-
-    const self = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/messages',
-        authorizationHeader: `Bearer ${agentToken}`,
-        body: { room_id: '!r:hs.example', agent: 'pi0-web1', body: 'hi' },
-      }),
-    );
-    expect(self.status).toBe(200);
-
-    const other = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/messages',
-        authorizationHeader: `Bearer ${agentToken}`,
-        body: { room_id: '!r:hs.example', agent: 'pi9-web9', body: 'hi' },
-      }),
-    );
-    expect(other.status).toBe(403);
-    expect(other.body.error).toBe('token not scoped to this agent');
-  });
-
-  it('revoked agent token is rejected on messages', async () => {
-    const { daemon } = makeAgentDaemon();
-    const minted = await registerAgent(daemon, { alias: 'pi0', host: 'web1' });
-    const agentToken = String(minted.body.bridge_token);
-
-    const revoke = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/agents/revoke',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: { agent_user_id: '@agent-pi0-web1:hs.example' },
-      }),
-    );
-    expect(revoke.status).toBe(200);
-    expect(revoke.body.revoked).toBe(1);
-
-    const afterRevoke = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/messages',
-        authorizationHeader: `Bearer ${agentToken}`,
-        body: { room_id: '!r:hs.example', agent: 'pi0-web1', body: 'hi' },
-      }),
-    );
-    expect(afterRevoke.status).toBe(403);
-  });
-
-  it('GET /bridge/v1/agents lists registered agents (host only)', async () => {
-    const { daemon } = makeAgentDaemon();
-    await registerAgent(daemon, { alias: 'pi0', host: 'web1', display_name: 'Pi Zero' });
-
-    const res = await daemon.handle(
-      request({
-        method: 'GET',
-        path: '/bridge/v1/agents',
-        authorizationHeader: 'Bearer bridge-secret',
-      }),
-    );
-    expect(res.status).toBe(200);
-    const agents = res.body.agents as Array<Record<string, unknown>>;
-    expect(agents).toHaveLength(1);
-    expect(agents[0]?.agent_user_id).toBe('@agent-pi0-web1:hs.example');
-    expect(agents[0]?.display_name).toBe('Pi Zero');
-  });
-
-  it('empty bridge token list denies everything', async () => {
-    const daemon = new AppserviceDaemon({ ...cfg, bridgeTokens: [] }, undefined, () => {});
-    const res = await daemon.handle(
-      request({
-        method: 'POST',
-        path: '/bridge/v1/typing',
-        authorizationHeader: 'Bearer bridge-secret',
-        body: {},
-      }),
-    );
-    expect(res.status).toBe(403);
-  });
-});
@@ -1,23 +0,0 @@
-import type { DaemonConfig } from './server.js';
-
-const required = (name: string): string => {
-  const value = process.env[name];
-  if (!value) throw new Error(`missing required env var ${name}`);
-  return value;
-};
-
-export function configFromEnv(): DaemonConfig & { port: number } {
-  return {
-    homeserverUrl: required('MOSAIC_AS_HOMESERVER_URL'),
-    domain: required('MOSAIC_AS_DOMAIN'),
-    asToken: required('MOSAIC_AS_TOKEN'),
-    hsToken: required('MOSAIC_HS_TOKEN'),
-    userPrefix: process.env.MOSAIC_AS_USER_PREFIX ?? 'agent-',
-    senderLocalpart: process.env.MOSAIC_AS_SENDER_LOCALPART ?? 'mosaic-as',
-    bridgeTokens: (process.env.MOSAIC_AS_BRIDGE_TOKENS ?? '')
-      .split(',')
-      .map((t) => t.trim())
-      .filter(Boolean),
-    port: Number(process.env.MOSAIC_AS_PORT ?? 8008),
-  };
-}
@@ -1,67 +0,0 @@
-import http from 'node:http';
-
-import { configFromEnv } from './config.js';
-import { AppserviceDaemon } from './server.js';
-
-const cfg = configFromEnv();
-const daemon = new AppserviceDaemon(cfg);
-
-const MAX_BODY_BYTES = 1024 * 1024;
-
-const server = http.createServer((req, res) => {
-  const chunks: Buffer[] = [];
-  let received = 0;
-  let rejected = false;
-  req.on('data', (chunk: Buffer) => {
-    received += chunk.length;
-    if (received > MAX_BODY_BYTES) {
-      rejected = true;
-      res.writeHead(413, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ errcode: 'M_TOO_LARGE', error: 'request body too large' }));
-      req.destroy();
-      return;
-    }
-    chunks.push(chunk);
-  });
-  req.on('end', () => {
-    if (rejected) return;
-    void (async () => {
-      const url = new URL(req.url ?? '/', 'http://localhost');
-      let body: unknown;
-      try {
-        const raw = Buffer.concat(chunks).toString();
-        body = raw ? JSON.parse(raw) : undefined;
-      } catch {
-        res.writeHead(400, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ errcode: 'M_NOT_JSON', error: 'invalid json' }));
-        return;
-      }
-      const result = await daemon.handle({
-        method: req.method ?? 'GET',
-        path: url.pathname,
-        searchParams: url.searchParams,
-        authorizationHeader: req.headers.authorization,
-        body,
-      });
-      res.writeHead(result.status, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify(result.body));
-    })().catch((error: unknown) => {
-      console.error('request failed:', error);
-      if (res.headersSent) {
-        res.destroy();
-        return;
-      }
-      res.writeHead(500, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ error: 'internal error' }));
-    });
-  });
-});
-
-server.listen(cfg.port, () => {
-  console.log(
-    `mosaic-as listening on :${cfg.port} (homeserver ${cfg.homeserverUrl}, domain ${cfg.domain})`,
-  );
-  if (cfg.bridgeTokens.length === 0) {
-    console.warn('WARNING: MOSAIC_AS_BRIDGE_TOKENS is empty — bridge API will deny all requests');
-  }
-});
@@ -1,10 +0,0 @@
-import { buildRegistration, registrationToYaml } from '@mosaicstack/appservice';
-
-import { configFromEnv } from './config.js';
-
-// Prints the Synapse registration YAML (mosaic-as.yaml) for the current env.
-// Usage: MOSAIC_AS_URL=http://mosaic-as:8008 mosaic-as-registration > mosaic-as.yaml
-const cfg = configFromEnv();
-const url = process.env.MOSAIC_AS_URL;
-if (!url) throw new Error('missing required env var MOSAIC_AS_URL');
-process.stdout.write(registrationToYaml(buildRegistration(cfg, { url })));
@@ -1,225 +0,0 @@
-import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
-
-import {
-  AgentTokenStore,
-  AppserviceIntent,
-  TransactionHandler,
-  validateBridgeMessage,
-  validateBridgeTyping,
-  validateProvisionRoom,
-  validateRegisterAgent,
-  validateRevokeAgent,
-} from '@mosaicstack/appservice';
-import type { AppserviceConfig, MatrixEvent } from '@mosaicstack/appservice';
-
-export interface DaemonConfig extends AppserviceConfig {
-  /** Bearer tokens accepted on /bridge/v1/* (one per agent-comms host daemon). */
-  bridgeTokens: string[];
-}
-
-export interface DaemonRequest {
-  method: string;
-  /** URL path without query string. */
-  path: string;
-  searchParams: URLSearchParams;
-  authorizationHeader?: string;
-  body: unknown;
-}
-
-export interface DaemonResponse {
-  status: number;
-  body: Record<string, unknown>;
-}
-
-// Compare equal-length HMAC digests so neither content nor LENGTH of the
-// stored secret is observable through timing.
-const HMAC_KEY = randomBytes(32);
-const digest = (value: string): Buffer => createHmac('sha256', HMAC_KEY).update(value).digest();
-
-const safeEqual = (a: string, b: string): boolean => timingSafeEqual(digest(a), digest(b));
-
-const TXN_PATH = /^\/_matrix\/app\/v1\/transactions\/([^/]+)$/;
-
-/**
- * Resolved identity for an authenticated /bridge/v1/* caller. Host principals
- * (the agent-comms host daemons) are unrestricted; agent principals are scoped
- * to a single virtual user and may only act as themselves.
- */
-export type BridgePrincipal = { kind: 'host' } | { kind: 'agent'; agentUserId: string } | null;
-
-/**
- * HTTP-framework-agnostic request router for the mosaic-as daemon: the
- * Application Service transactions endpoint (Synapse-facing) plus the
- * internal bridge API v1 (agent-comms daemon-facing). main.ts binds this to
- * node:http; tests drive it directly.
- */
-export class AppserviceDaemon {
-  readonly intent: AppserviceIntent;
-  private readonly transactions: TransactionHandler;
-  private readonly agents: AgentTokenStore;
-
-  constructor(
-    private readonly cfg: DaemonConfig,
-    fetchImpl?: typeof fetch,
-    private readonly log: (line: string) => void = (line) => console.log(line),
-  ) {
-    this.intent = new AppserviceIntent(cfg, fetchImpl);
-    this.agents = new AgentTokenStore(this.intent);
-    this.transactions = new TransactionHandler({
-      hsToken: cfg.hsToken,
-      onEvent: (event) => this.onEvent(event),
-      onError: (error, txnId) => this.log(`txn ${txnId} handler error: ${String(error)}`),
-    });
-  }
-
-  /** v1: the daemon only observes; room logic lives in the agent-comms daemons. */
-  private onEvent(event: MatrixEvent): void {
-    if (event.type === 'm.room.message') {
-      this.log(
-        `event ${event.event_id ?? '?'} in ${event.room_id ?? '?'} from ${event.sender ?? '?'}`,
-      );
-    }
-  }
-
-  /** Resolve the calling principal, or null when unauthorized. Fail-closed:
-   * host tokens win (timing-safe compare); otherwise a magt_* bearer is looked
-   * up in the agent token store; anything else is rejected. */
-  private async bridgeAuthorized(
-    authorizationHeader: string | undefined,
-  ): Promise<BridgePrincipal> {
-    if (!authorizationHeader?.startsWith('Bearer ')) return null;
-    const presented = authorizationHeader.slice('Bearer '.length);
-    if (this.cfg.bridgeTokens.some((token) => safeEqual(presented, token))) {
-      return { kind: 'host' };
-    }
-    const agentUserId = await this.agents.verifyToken(presented);
-    if (agentUserId) return { kind: 'agent', agentUserId };
-    return null;
-  }
-
-  async handle(req: DaemonRequest): Promise<DaemonResponse> {
-    if (req.method === 'GET' && req.path === '/health') {
-      return { status: 200, body: { ok: true } };
-    }
-
-    const txnMatch = req.method === 'PUT' ? TXN_PATH.exec(req.path) : null;
-    if (txnMatch?.[1] !== undefined) {
-      return this.transactions.handle(txnMatch[1], req.body, {
-        authorizationHeader: req.authorizationHeader,
-        accessTokenParam: req.searchParams.get('access_token') ?? undefined,
-      });
-    }
-
-    if (req.path.startsWith('/bridge/v1/')) {
-      const principal = await this.bridgeAuthorized(req.authorizationHeader);
-      if (!principal) {
-        return { status: 403, body: { errcode: 'M_FORBIDDEN', error: 'bad bridge token' } };
-      }
-      try {
-        if (req.method === 'POST' && req.path === '/bridge/v1/agents') {
-          if (principal.kind !== 'host') {
-            return {
-              status: 403,
-              body: { errcode: 'M_FORBIDDEN', error: 'agents cannot register agents' },
-            };
-          }
-          validateRegisterAgent(req.body);
-          const { agentUserId, token } = await this.agents.register({
-            alias: req.body.alias,
-            host: req.body.host,
-            displayName: req.body.display_name,
-          });
-          this.log(`registered agent ${agentUserId}`);
-          return { status: 200, body: { agent_user_id: agentUserId, bridge_token: token } };
-        }
-        if (req.method === 'POST' && req.path === '/bridge/v1/agents/revoke') {
-          if (principal.kind !== 'host') {
-            return {
-              status: 403,
-              body: { errcode: 'M_FORBIDDEN', error: 'agents cannot revoke agents' },
-            };
-          }
-          validateRevokeAgent(req.body);
-          const revoked = await this.agents.revoke(req.body.agent_user_id);
-          this.log(`revoked ${revoked} token(s) for ${req.body.agent_user_id}`);
-          return { status: 200, body: { revoked } };
-        }
-        if (req.method === 'GET' && req.path === '/bridge/v1/agents') {
-          if (principal.kind !== 'host') {
-            return {
-              status: 403,
-              body: { errcode: 'M_FORBIDDEN', error: 'agents cannot list agents' },
-            };
-          }
-          const agents = await this.agents.list();
-          return { status: 200, body: { agents } };
-        }
-        if (req.method === 'POST' && req.path === '/bridge/v1/messages') {
-          validateBridgeMessage(req.body);
-          if (
-            principal.kind === 'agent' &&
-            this.intent.agentUserId(req.body.agent) !== principal.agentUserId
-          ) {
-            return {
-              status: 403,
-              body: { errcode: 'M_FORBIDDEN', error: 'token not scoped to this agent' },
-            };
-          }
-          const eventId = await this.intent.sendAsAgent({
-            roomId: req.body.room_id,
-            agent: req.body.agent,
-            body: req.body.body,
-            threadRoot: req.body.thread_root,
-            msgtype: req.body.msgtype,
-            extraContent: req.body.extra_content,
-          });
-          return { status: 200, body: { event_id: eventId ?? null } };
-        }
-        if (req.method === 'POST' && req.path === '/bridge/v1/typing') {
-          validateBridgeTyping(req.body);
-          if (
-            principal.kind === 'agent' &&
-            this.intent.agentUserId(req.body.agent) !== principal.agentUserId
-          ) {
-            return {
-              status: 403,
-              body: { errcode: 'M_FORBIDDEN', error: 'token not scoped to this agent' },
-            };
-          }
-          await this.intent.setTyping(req.body.room_id, req.body.agent, req.body.typing);
-          return { status: 200, body: {} };
-        }
-        if (req.method === 'POST' && req.path === '/bridge/v1/provision/rooms') {
-          validateProvisionRoom(req.body);
-          const result = await this.intent.createRoom({
-            name: req.body.name,
-            alias: req.body.alias,
-            topic: req.body.topic,
-            invite: req.body.invite,
-            spaceId: req.body.space_id,
-          });
-          this.log(
-            `provisioned room ${result.roomId} (${req.body.name}) space_linked=${result.spaceLinked}`,
-          );
-          return {
-            status: 200,
-            body: {
-              room_id: result.roomId,
-              space_linked: result.spaceLinked,
-              ...(result.spaceError ? { space_error: result.spaceError } : {}),
-            },
-          };
-        }
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        this.log(`bridge error ${req.method} ${req.path}: ${message}`);
-        return { status: 400, body: { error: message } };
-      }
-      // Explicit: never fall out of the authenticated bridge block, so future
-      // sub-paths cannot accidentally route around the auth guard above.
-      return { status: 405, body: { error: 'unsupported bridge method/path' } };
-    }
-
-    return { status: 404, body: { error: 'not found' } };
-  }
-}
@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
@@ -1,93 +0,0 @@
-{
-  "name": "@mosaicstack/gateway",
-  "version": "0.0.6",
-  "repository": {
-    "type": "git",
-    "url": "https://git.mosaicstack.dev/mosaicstack/stack.git",
-    "directory": "apps/gateway"
-  },
-  "type": "module",
-  "main": "dist/main.js",
-  "bin": {
-    "mosaic-gateway": "dist/main.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "registry": "https://git.mosaicstack.dev/api/packages/mosaicstack/npm/",
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/main.ts",
-    "lint": "eslint src",
-    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
-    "test": "vitest run --passWithNoTests"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.80.0",
-    "@fastify/helmet": "^13.0.2",
-    "@mariozechner/pi-ai": "^0.65.0",
-    "@mariozechner/pi-coding-agent": "^0.65.0",
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@mosaicstack/auth": "workspace:^",
-    "@mosaicstack/brain": "workspace:^",
-    "@mosaicstack/config": "workspace:^",
-    "@mosaicstack/coord": "workspace:^",
-    "@mosaicstack/db": "workspace:^",
-    "@mosaicstack/discord-plugin": "workspace:^",
-    "@mosaicstack/log": "workspace:^",
-    "@mosaicstack/memory": "workspace:^",
-    "@mosaicstack/queue": "workspace:^",
-    "@mosaicstack/storage": "workspace:^",
-    "@mosaicstack/telegram-plugin": "workspace:^",
-    "@mosaicstack/types": "workspace:^",
-    "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
-    "@nestjs/platform-fastify": "^11.0.0",
-    "@nestjs/platform-socket.io": "^11.0.0",
-    "@nestjs/throttler": "^6.5.0",
-    "@nestjs/websockets": "^11.0.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.72.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.213.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
-    "@opentelemetry/resources": "^2.6.0",
-    "@opentelemetry/sdk-metrics": "^2.6.0",
-    "@opentelemetry/sdk-node": "^0.213.0",
-    "@opentelemetry/semantic-conventions": "^1.40.0",
-    "@peculiar/x509": "^2.0.0",
-    "@sinclair/typebox": "^0.34.48",
-    "better-auth": "^1.5.5",
-    "bullmq": "^5.71.0",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.15.1",
-    "dotenv": "^17.3.1",
-    "fastify": "^5.0.0",
-    "ioredis": "^5.10.0",
-    "jose": "^6.2.2",
-    "node-cron": "^4.2.1",
-    "openai": "^6.32.0",
-    "postgres": "^3.4.8",
-    "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.8.0",
-    "socket.io": "^4.8.0",
-    "uuid": "^11.0.0",
-    "undici": "^7.24.6",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@nestjs/testing": "^11.1.18",
-    "@swc/core": "^1.15.24",
-    "@swc/helpers": "^0.5.21",
-    "@types/node": "^22.0.0",
-    "@types/node-cron": "^3.0.11",
-    "@types/supertest": "^7.2.0",
-    "@types/uuid": "^10.0.0",
-    "supertest": "^7.2.2",
-    "tsx": "^4.0.0",
-    "typescript": "^5.8.0",
-    "unplugin-swc": "^1.5.9",
-    "vitest": "^2.0.0"
-  }
-}
@@ -1,605 +0,0 @@
-/**
- * Integration tests for conversation persistence and context resume (M1-008).
- *
- * Verifies the full flow end-to-end using in-memory mocks:
- * 1. User messages are persisted when sent via ChatGateway.
- * 2. Assistant responses are persisted with metadata on agent:end.
- * 3. Conversation history is loaded and injected into context on session resume.
- * 4. The search endpoint returns matching messages.
- */
-
-import { BadRequestException, NotFoundException } from '@nestjs/common';
-import { describe, expect, it, vi, beforeEach } from 'vitest';
-import type { ConversationHistoryMessage } from '../agent/agent.service.js';
-import { ConversationsController } from '../conversations/conversations.controller.js';
-import type { Message } from '@mosaicstack/brain';
-
-// ---------------------------------------------------------------------------
-// Shared test data
-// ---------------------------------------------------------------------------
-
-const USER_ID = 'user-test-001';
-const CONV_ID = 'conv-test-001';
-
-function makeConversation(overrides?: Record<string, unknown>) {
-  return {
-    id: CONV_ID,
-    userId: USER_ID,
-    title: null,
-    projectId: null,
-    archived: false,
-    createdAt: new Date('2026-01-01T00:00:00Z'),
-    updatedAt: new Date('2026-01-01T00:00:00Z'),
-    ...overrides,
-  };
-}
-
-function makeMessage(
-  role: 'user' | 'assistant' | 'system',
-  content: string,
-  overrides?: Record<string, unknown>,
-) {
-  return {
-    id: `msg-${role}-${Math.random().toString(36).slice(2)}`,
-    conversationId: CONV_ID,
-    role,
-    content,
-    metadata: null,
-    createdAt: new Date('2026-01-01T00:01:00Z'),
-    ...overrides,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Helper: build a mock ConversationsRepo
-// ---------------------------------------------------------------------------
-
-function createMockBrain(options?: {
-  conversation?: ReturnType<typeof makeConversation> | undefined;
-  messages?: ReturnType<typeof makeMessage>[];
-  searchResults?: Array<{
-    messageId: string;
-    conversationId: string;
-    conversationTitle: string | null;
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-    createdAt: Date;
-  }>;
-}) {
-  const conversation = options?.conversation;
-  const messages = options?.messages ?? [];
-  const searchResults = options?.searchResults ?? [];
-
-  return {
-    conversations: {
-      findAll: vi.fn().mockResolvedValue(conversation ? [conversation] : []),
-      findById: vi.fn().mockResolvedValue(conversation),
-      create: vi.fn().mockResolvedValue(conversation ?? makeConversation()),
-      update: vi.fn().mockResolvedValue(conversation),
-      remove: vi.fn().mockResolvedValue(true),
-      findMessages: vi.fn().mockResolvedValue(messages),
-      addMessage: vi.fn().mockImplementation((data: unknown) => {
-        const d = data as {
-          conversationId: string;
-          role: 'user' | 'assistant' | 'system';
-          content: string;
-          metadata?: Record<string, unknown>;
-        };
-        return Promise.resolve(makeMessage(d.role, d.content, { metadata: d.metadata ?? null }));
-      }),
-      searchMessages: vi.fn().mockResolvedValue(searchResults),
-    },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// 1. ConversationsRepo: addMessage persists user message
-// ---------------------------------------------------------------------------
-
-describe('ConversationsRepo.addMessage — user message persistence', () => {
-  it('persists a user message and returns the saved record', async () => {
-    const brain = createMockBrain({ conversation: makeConversation() });
-
-    const result = await brain.conversations.addMessage(
-      {
-        conversationId: CONV_ID,
-        role: 'user',
-        content: 'Hello, agent!',
-        metadata: { timestamp: '2026-01-01T00:01:00.000Z' },
-      },
-      USER_ID,
-    );
-
-    expect(brain.conversations.addMessage).toHaveBeenCalledOnce();
-    expect(result).toBeDefined();
-    expect(result!.role).toBe('user');
-    expect(result!.content).toBe('Hello, agent!');
-    expect(result!.conversationId).toBe(CONV_ID);
-  });
-
-  it('returns undefined when conversation does not belong to the user', async () => {
-    // Simulate the repo enforcement: ownership mismatch returns undefined
-    const brain = createMockBrain({ conversation: undefined });
-    brain.conversations.addMessage = vi.fn().mockResolvedValue(undefined);
-
-    const result = await brain.conversations.addMessage(
-      { conversationId: CONV_ID, role: 'user', content: 'Hello' },
-      'other-user',
-    );
-
-    expect(result).toBeUndefined();
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 2. ConversationsRepo.addMessage — assistant response with metadata
-// ---------------------------------------------------------------------------
-
-describe('ConversationsRepo.addMessage — assistant response metadata', () => {
-  it('persists assistant message with model, provider, tokens and toolCalls metadata', async () => {
-    const assistantMetadata = {
-      timestamp: '2026-01-01T00:02:00.000Z',
-      model: 'claude-3-5-sonnet-20241022',
-      provider: 'anthropic',
-      toolCalls: [
-        {
-          toolCallId: 'tc-001',
-          toolName: 'read_file',
-          args: { path: '/foo/bar.ts' },
-          isError: false,
-        },
-      ],
-      tokenUsage: {
-        input: 1000,
-        output: 250,
-        cacheRead: 0,
-        cacheWrite: 0,
-        total: 1250,
-      },
-    };
-
-    const brain = createMockBrain({ conversation: makeConversation() });
-
-    const result = await brain.conversations.addMessage(
-      {
-        conversationId: CONV_ID,
-        role: 'assistant',
-        content: 'Here is the file content you requested.',
-        metadata: assistantMetadata,
-      },
-      USER_ID,
-    );
-
-    expect(result).toBeDefined();
-    expect(result!.role).toBe('assistant');
-    expect(result!.content).toBe('Here is the file content you requested.');
-    expect(result!.metadata).toMatchObject({
-      model: 'claude-3-5-sonnet-20241022',
-      provider: 'anthropic',
-      tokenUsage: { input: 1000, output: 250, total: 1250 },
-    });
-    expect((result!.metadata as Record<string, unknown>)['toolCalls']).toHaveLength(1);
-    expect(
-      (
-        (result!.metadata as Record<string, unknown>)['toolCalls'] as Array<Record<string, unknown>>
-      )[0]!['toolName'],
-    ).toBe('read_file');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 3. ChatGateway.loadConversationHistory — session resume loads history
-// ---------------------------------------------------------------------------
-
-describe('Conversation resume — history loading', () => {
-  it('maps DB messages to ConversationHistoryMessage shape', () => {
-    // Simulate what ChatGateway.loadConversationHistory does:
-    // convert DB Message rows to ConversationHistoryMessage for context injection.
-    const dbMessages = [
-      makeMessage('user', 'What is the capital of France?', {
-        createdAt: new Date('2026-01-01T00:01:00Z'),
-      }),
-      makeMessage('assistant', 'The capital of France is Paris.', {
-        createdAt: new Date('2026-01-01T00:01:05Z'),
-      }),
-      makeMessage('user', 'And Germany?', { createdAt: new Date('2026-01-01T00:02:00Z') }),
-      makeMessage('assistant', 'The capital of Germany is Berlin.', {
-        createdAt: new Date('2026-01-01T00:02:05Z'),
-      }),
-    ];
-
-    // Replicate the mapping logic from ChatGateway
-    const history: ConversationHistoryMessage[] = dbMessages.map((msg) => ({
-      role: msg.role as 'user' | 'assistant' | 'system',
-      content: msg.content,
-      createdAt: msg.createdAt,
-    }));
-
-    expect(history).toHaveLength(4);
-    expect(history[0]).toEqual({
-      role: 'user',
-      content: 'What is the capital of France?',
-      createdAt: new Date('2026-01-01T00:01:00Z'),
-    });
-    expect(history[1]).toEqual({
-      role: 'assistant',
-      content: 'The capital of France is Paris.',
-      createdAt: new Date('2026-01-01T00:01:05Z'),
-    });
-    expect(history[2]!.role).toBe('user');
-    expect(history[3]!.role).toBe('assistant');
-  });
-
-  it('returns empty array when conversation has no messages', async () => {
-    const brain = createMockBrain({ conversation: makeConversation(), messages: [] });
-
-    const messages = await brain.conversations.findMessages(CONV_ID, USER_ID);
-    expect(messages).toHaveLength(0);
-
-    // Gateway produces empty history → no context injection
-    const history: ConversationHistoryMessage[] = (messages as Message[]).map((msg) => ({
-      role: msg.role as 'user' | 'assistant' | 'system',
-      content: msg.content,
-      createdAt: msg.createdAt,
-    }));
-    expect(history).toHaveLength(0);
-  });
-
-  it('returns empty array when conversation does not belong to the user', async () => {
-    const brain = createMockBrain({ conversation: undefined });
-    brain.conversations.findMessages = vi.fn().mockResolvedValue([]);
-
-    const messages = await brain.conversations.findMessages(CONV_ID, 'other-user');
-    expect(messages).toHaveLength(0);
-  });
-
-  it('preserves message order (ascending by createdAt)', async () => {
-    const ordered = [
-      makeMessage('user', 'First', { createdAt: new Date('2026-01-01T00:01:00Z') }),
-      makeMessage('assistant', 'Second', { createdAt: new Date('2026-01-01T00:01:05Z') }),
-      makeMessage('user', 'Third', { createdAt: new Date('2026-01-01T00:02:00Z') }),
-    ];
-    const brain = createMockBrain({ conversation: makeConversation(), messages: ordered });
-
-    const messages = await brain.conversations.findMessages(CONV_ID, USER_ID);
-    expect(messages[0]!.content).toBe('First');
-    expect(messages[1]!.content).toBe('Second');
-    expect(messages[2]!.content).toBe('Third');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 4. AgentService.buildHistoryPromptSection — context injection format
-// ---------------------------------------------------------------------------
-
-describe('AgentService — buildHistoryPromptSection (context injection)', () => {
-  /**
-   * Replicate the private method logic to test it in isolation.
-   * The real method lives in AgentService but is private; we mirror the
-   * exact logic here so the test is independent of the service's constructor.
-   */
-  function buildHistoryPromptSection(
-    history: ConversationHistoryMessage[],
-    contextWindow: number,
-    _sessionId: string,
-  ): string {
-    const TOKEN_BUDGET = Math.floor(contextWindow * 0.8);
-    const HISTORY_HEADER = '## Conversation History (resumed session)\n\n';
-
-    const formatMessage = (msg: ConversationHistoryMessage): string => {
-      const roleLabel =
-        msg.role === 'user' ? 'User' : msg.role === 'assistant' ? 'Assistant' : 'System';
-      return `**${roleLabel}:** ${msg.content}`;
-    };
-
-    const estimateTokens = (text: string) => Math.ceil(text.length / 4);
-
-    const formatted = history.map((msg) => formatMessage(msg));
-    const fullHistory = formatted.join('\n\n');
-    const fullTokens = estimateTokens(HISTORY_HEADER + fullHistory);
-
-    if (fullTokens <= TOKEN_BUDGET) {
-      return HISTORY_HEADER + fullHistory;
-    }
-
-    // History exceeds budget — summarize oldest messages, keep recent verbatim
-    const SUMMARY_RESERVE = Math.floor(TOKEN_BUDGET * 0.2);
-    const verbatimBudget = TOKEN_BUDGET - SUMMARY_RESERVE;
-
-    let verbatimTokens = 0;
-    let verbatimCutIndex = history.length;
-    for (let i = history.length - 1; i >= 0; i--) {
-      const t = estimateTokens(formatted[i]!);
-      if (verbatimTokens + t > verbatimBudget) break;
-      verbatimTokens += t;
-      verbatimCutIndex = i;
-    }
-
-    const summarizedMessages = history.slice(0, verbatimCutIndex);
-    const verbatimMessages = history.slice(verbatimCutIndex);
-
-    let summaryText = '';
-    if (summarizedMessages.length > 0) {
-      const topics = summarizedMessages
-        .filter((m) => m.role === 'user')
-        .map((m) => m.content.slice(0, 120).replace(/\n/g, ' '))
-        .join('; ');
-      summaryText =
-        `**Previous conversation summary** (${summarizedMessages.length} messages omitted for brevity):\n` +
-        `Topics discussed: ${topics || '(no user messages in summarized portion)'}`;
-    }
-
-    const verbatimSection = verbatimMessages.map((m) => formatMessage(m)).join('\n\n');
-
-    const parts: string[] = [HISTORY_HEADER];
-    if (summaryText) parts.push(summaryText);
-    if (verbatimSection) parts.push(verbatimSection);
-
-    return parts.join('\n\n');
-  }
-
-  it('includes header and all messages when history fits within context budget', () => {
-    const history: ConversationHistoryMessage[] = [
-      { role: 'user', content: 'Hello', createdAt: new Date() },
-      { role: 'assistant', content: 'Hi there!', createdAt: new Date() },
-    ];
-
-    const result = buildHistoryPromptSection(history, 8192, 'session-1');
-
-    expect(result).toContain('## Conversation History (resumed session)');
-    expect(result).toContain('**User:** Hello');
-    expect(result).toContain('**Assistant:** Hi there!');
-  });
-
-  it('labels roles correctly (user, assistant, system)', () => {
-    const history: ConversationHistoryMessage[] = [
-      { role: 'system', content: 'You are helpful.', createdAt: new Date() },
-      { role: 'user', content: 'Ping', createdAt: new Date() },
-      { role: 'assistant', content: 'Pong', createdAt: new Date() },
-    ];
-
-    const result = buildHistoryPromptSection(history, 8192, 'session-2');
-
-    expect(result).toContain('**System:** You are helpful.');
-    expect(result).toContain('**User:** Ping');
-    expect(result).toContain('**Assistant:** Pong');
-  });
-
-  it('summarizes old messages when history exceeds 80% of context window', () => {
-    // Create enough messages to exceed a tiny context window budget
-    const longContent = 'A'.repeat(200);
-    const history: ConversationHistoryMessage[] = Array.from({ length: 20 }, (_, i) => ({
-      role: (i % 2 === 0 ? 'user' : 'assistant') as 'user' | 'assistant',
-      content: `${longContent} message ${i}`,
-      createdAt: new Date(),
-    }));
-
-    // Use a small context window so history definitely exceeds 80%
-    const result = buildHistoryPromptSection(history, 512, 'session-3');
-
-    // Should contain the summary prefix
-    expect(result).toContain('messages omitted for brevity');
-    expect(result).toContain('Topics discussed:');
-  });
-
-  it('returns only header for empty history', () => {
-    const result = buildHistoryPromptSection([], 8192, 'session-4');
-    // With empty history, the full history join is '' and the section is just the header
-    expect(result).toContain('## Conversation History (resumed session)');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 5. ConversationsController.search — GET /api/conversations/search
-// ---------------------------------------------------------------------------
-
-describe('ConversationsController — search endpoint', () => {
-  let brain: ReturnType<typeof createMockBrain>;
-  let controller: ConversationsController;
-
-  beforeEach(() => {
-    const searchResults = [
-      {
-        messageId: 'msg-001',
-        conversationId: CONV_ID,
-        conversationTitle: 'Test Chat',
-        role: 'user' as const,
-        content: 'What is the capital of France?',
-        createdAt: new Date('2026-01-01T00:01:00Z'),
-      },
-      {
-        messageId: 'msg-002',
-        conversationId: CONV_ID,
-        conversationTitle: 'Test Chat',
-        role: 'assistant' as const,
-        content: 'The capital of France is Paris.',
-        createdAt: new Date('2026-01-01T00:01:05Z'),
-      },
-    ];
-    brain = createMockBrain({ searchResults });
-    controller = new ConversationsController(brain as never);
-  });
-
-  it('returns matching messages for a valid search query', async () => {
-    const results = await controller.search({ q: 'France' }, { id: USER_ID });
-
-    expect(brain.conversations.searchMessages).toHaveBeenCalledWith(USER_ID, 'France', 20, 0);
-    expect(results).toHaveLength(2);
-    expect(results[0]).toMatchObject({
-      messageId: 'msg-001',
-      role: 'user',
-      content: 'What is the capital of France?',
-    });
-    expect(results[1]).toMatchObject({
-      messageId: 'msg-002',
-      role: 'assistant',
-      content: 'The capital of France is Paris.',
-    });
-  });
-
-  it('uses custom limit and offset when provided', async () => {
-    await controller.search({ q: 'Paris', limit: 5, offset: 10 }, { id: USER_ID });
-
-    expect(brain.conversations.searchMessages).toHaveBeenCalledWith(USER_ID, 'Paris', 5, 10);
-  });
-
-  it('throws BadRequestException when query is empty', async () => {
-    await expect(controller.search({ q: '' }, { id: USER_ID })).rejects.toBeInstanceOf(
-      BadRequestException,
-    );
-    await expect(controller.search({ q: '   ' }, { id: USER_ID })).rejects.toBeInstanceOf(
-      BadRequestException,
-    );
-  });
-
-  it('trims whitespace from query before passing to repo', async () => {
-    await controller.search({ q: '  Berlin  ' }, { id: USER_ID });
-
-    expect(brain.conversations.searchMessages).toHaveBeenCalledWith(
-      USER_ID,
-      'Berlin',
-      expect.any(Number),
-      expect.any(Number),
-    );
-  });
-
-  it('returns empty array when no messages match', async () => {
-    brain.conversations.searchMessages = vi.fn().mockResolvedValue([]);
-
-    const results = await controller.search({ q: 'xyzzy-no-match' }, { id: USER_ID });
-
-    expect(results).toHaveLength(0);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 6. ConversationsController — messages CRUD
-// ---------------------------------------------------------------------------
-
-describe('ConversationsController — message CRUD', () => {
-  it('listMessages returns 404 when conversation is not owned by user', async () => {
-    const brain = createMockBrain({ conversation: undefined });
-    const controller = new ConversationsController(brain as never);
-
-    await expect(controller.listMessages(CONV_ID, { id: USER_ID })).rejects.toBeInstanceOf(
-      NotFoundException,
-    );
-  });
-
-  it('listMessages returns the messages for an owned conversation', async () => {
-    const msgs = [makeMessage('user', 'Test message'), makeMessage('assistant', 'Test reply')];
-    const brain = createMockBrain({ conversation: makeConversation(), messages: msgs });
-    const controller = new ConversationsController(brain as never);
-
-    const result = await controller.listMessages(CONV_ID, { id: USER_ID });
-
-    expect(result).toHaveLength(2);
-    expect(result[0]!.role).toBe('user');
-    expect(result[1]!.role).toBe('assistant');
-  });
-
-  it('addMessage returns the persisted message', async () => {
-    const brain = createMockBrain({ conversation: makeConversation() });
-    const controller = new ConversationsController(brain as never);
-
-    const result = await controller.addMessage(
-      CONV_ID,
-      { role: 'user', content: 'Persisted content' },
-      { id: USER_ID },
-    );
-
-    expect(result).toBeDefined();
-    expect(result.role).toBe('user');
-    expect(result.content).toBe('Persisted content');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 7. End-to-end persistence flow simulation
-// ---------------------------------------------------------------------------
-
-describe('End-to-end persistence flow', () => {
-  it('simulates a full conversation: persist user message → persist assistant response → resume with history', async () => {
-    // ── Step 1: Conversation is created ────────────────────────────────────
-    const brain = createMockBrain({ conversation: makeConversation() });
-
-    await brain.conversations.create({ id: CONV_ID, userId: USER_ID });
-    expect(brain.conversations.create).toHaveBeenCalledOnce();
-
-    // ── Step 2: User message is persisted ──────────────────────────────────
-    const userMsg = await brain.conversations.addMessage(
-      {
-        conversationId: CONV_ID,
-        role: 'user',
-        content: 'Explain monads in simple terms.',
-        metadata: { timestamp: '2026-01-01T00:01:00.000Z' },
-      },
-      USER_ID,
-    );
-
-    expect(userMsg).toBeDefined();
-    expect(userMsg!.role).toBe('user');
-
-    // ── Step 3: Assistant response is persisted with metadata ───────────────
-    const assistantMeta = {
-      timestamp: '2026-01-01T00:01:10.000Z',
-      model: 'claude-3-5-sonnet-20241022',
-      provider: 'anthropic',
-      toolCalls: [],
-      tokenUsage: { input: 500, output: 120, cacheRead: 0, cacheWrite: 0, total: 620 },
-    };
-
-    const assistantMsg = await brain.conversations.addMessage(
-      {
-        conversationId: CONV_ID,
-        role: 'assistant',
-        content: 'A monad is a design pattern that wraps values in a context...',
-        metadata: assistantMeta,
-      },
-      USER_ID,
-    );
-
-    expect(assistantMsg).toBeDefined();
-    expect(assistantMsg!.role).toBe('assistant');
-
-    // ── Step 4: On session resume, history is loaded ────────────────────────
-    const storedMessages = [
-      makeMessage('user', 'Explain monads in simple terms.', {
-        createdAt: new Date('2026-01-01T00:01:00Z'),
-        metadata: { timestamp: '2026-01-01T00:01:00.000Z' },
-      }),
-      makeMessage('assistant', 'A monad is a design pattern that wraps values in a context...', {
-        createdAt: new Date('2026-01-01T00:01:10Z'),
-        metadata: assistantMeta,
-      }),
-    ];
-
-    brain.conversations.findMessages = vi.fn().mockResolvedValue(storedMessages);
-
-    const dbMessages = await brain.conversations.findMessages(CONV_ID, USER_ID);
-    expect(dbMessages).toHaveLength(2);
-
-    // ── Step 5: History is mapped for context injection ─────────────────────
-    const history: ConversationHistoryMessage[] = (dbMessages as Message[]).map((msg) => ({
-      role: msg.role as 'user' | 'assistant' | 'system',
-      content: msg.content,
-      createdAt: msg.createdAt,
-    }));
-
-    expect(history[0]).toMatchObject({
-      role: 'user',
-      content: 'Explain monads in simple terms.',
-    });
-    expect(history[1]).toMatchObject({
-      role: 'assistant',
-      content: 'A monad is a design pattern that wraps values in a context...',
-    });
-
-    // ── Step 6: History roles are valid for injection ───────────────────────
-    for (const msg of history) {
-      expect(['user', 'assistant', 'system']).toContain(msg.role);
-      expect(typeof msg.content).toBe('string');
-      expect(msg.createdAt).toBeInstanceOf(Date);
-    }
-  });
-});
@@ -1,485 +0,0 @@
-/**
- * Integration test: Cross-user data isolation (M2-007)
- *
- * Verifies that every repository query path is scoped to the requesting user —
- * no user can read, write, or enumerate another user's records.
- *
- * Test strategy:
- *  - Two real users (User A, User B) are inserted directly into the database.
- *  - Realistic data (conversations + messages, agent configs, preferences,
- *    insights) is created for each user.
- *  - A shared system agent is inserted so both users can see it via
- *    findAccessible().
- *  - All assertions are made against the live database (no mocks).
- *  - All inserted rows are cleaned up in the afterAll hook.
- *
- * Requires: DATABASE_URL pointing at a running PostgreSQL instance with
- * pgvector enabled and the Mosaic schema already applied.
- */
-
-import { afterAll, beforeAll, beforeEach, describe, expect, it } from 'vitest';
-import { createDb } from '@mosaicstack/db';
-import { createConversationsRepo } from '@mosaicstack/brain';
-import { createAgentsRepo } from '@mosaicstack/brain';
-import { createPreferencesRepo, createInsightsRepo } from '@mosaicstack/memory';
-import { users, conversations, messages, agents, preferences, insights } from '@mosaicstack/db';
-import { eq } from '@mosaicstack/db';
-import type { DbHandle } from '@mosaicstack/db';
-
-// ─── Fixed IDs so the afterAll cleanup is deterministic ──────────────────────
-
-const USER_A_ID = 'test-iso-user-a';
-const USER_B_ID = 'test-iso-user-b';
-const CONV_A_ID = 'aaaaaaaa-0000-0000-0000-000000000001';
-const CONV_B_ID = 'bbbbbbbb-0000-0000-0000-000000000001';
-const MSG_A_ID = 'aaaaaaaa-0000-0000-0000-000000000002';
-const MSG_B_ID = 'bbbbbbbb-0000-0000-0000-000000000002';
-const AGENT_A_ID = 'aaaaaaaa-0000-0000-0000-000000000003';
-const AGENT_B_ID = 'bbbbbbbb-0000-0000-0000-000000000003';
-const AGENT_SYS_ID = 'ffffffff-0000-0000-0000-000000000001';
-const PREF_A_ID = 'aaaaaaaa-0000-0000-0000-000000000004';
-const PREF_B_ID = 'bbbbbbbb-0000-0000-0000-000000000004';
-const INSIGHT_A_ID = 'aaaaaaaa-0000-0000-0000-000000000005';
-const INSIGHT_B_ID = 'bbbbbbbb-0000-0000-0000-000000000005';
-
-// ─── Test fixture ─────────────────────────────────────────────────────────────
-
-let handle: DbHandle;
-let dbAvailable = false;
-
-beforeAll(async () => {
-  try {
-    handle = createDb();
-    const db = handle.db;
-
-    // Insert two users
-    await db
-      .insert(users)
-      .values([
-        {
-          id: USER_A_ID,
-          name: 'Isolation Test User A',
-          email: '[email protected]',
-          emailVerified: false,
-        },
-        {
-          id: USER_B_ID,
-          name: 'Isolation Test User B',
-          email: '[email protected]',
-          emailVerified: false,
-        },
-      ])
-      .onConflictDoNothing();
-
-    // Conversations — one per user
-    await db
-      .insert(conversations)
-      .values([
-        { id: CONV_A_ID, userId: USER_A_ID, title: 'User A conversation' },
-        { id: CONV_B_ID, userId: USER_B_ID, title: 'User B conversation' },
-      ])
-      .onConflictDoNothing();
-
-    // Messages — one per conversation
-    await db
-      .insert(messages)
-      .values([
-        {
-          id: MSG_A_ID,
-          conversationId: CONV_A_ID,
-          role: 'user',
-          content: 'Hello from User A',
-        },
-        {
-          id: MSG_B_ID,
-          conversationId: CONV_B_ID,
-          role: 'user',
-          content: 'Hello from User B',
-        },
-      ])
-      .onConflictDoNothing();
-
-    // Agent configs — private agents (one per user) + one system agent
-    await db
-      .insert(agents)
-      .values([
-        {
-          id: AGENT_A_ID,
-          name: 'Agent A (private)',
-          provider: 'test',
-          model: 'test-model',
-          ownerId: USER_A_ID,
-          isSystem: false,
-        },
-        {
-          id: AGENT_B_ID,
-          name: 'Agent B (private)',
-          provider: 'test',
-          model: 'test-model',
-          ownerId: USER_B_ID,
-          isSystem: false,
-        },
-        {
-          id: AGENT_SYS_ID,
-          name: 'Shared System Agent',
-          provider: 'test',
-          model: 'test-model',
-          ownerId: null,
-          isSystem: true,
-        },
-      ])
-      .onConflictDoNothing();
-
-    // Preferences — one per user (same key, different values)
-    await db
-      .insert(preferences)
-      .values([
-        {
-          id: PREF_A_ID,
-          userId: USER_A_ID,
-          key: 'theme',
-          value: 'dark',
-          category: 'appearance',
-        },
-        {
-          id: PREF_B_ID,
-          userId: USER_B_ID,
-          key: 'theme',
-          value: 'light',
-          category: 'appearance',
-        },
-      ])
-      .onConflictDoNothing();
-
-    // Insights — no embedding to keep the fixture simple; embedding-based search
-    // is tested separately with a zero-vector that falls outside maxDistance
-    await db
-      .insert(insights)
-      .values([
-        {
-          id: INSIGHT_A_ID,
-          userId: USER_A_ID,
-          content: 'User A insight',
-          source: 'user',
-          category: 'general',
-          relevanceScore: 1.0,
-        },
-        {
-          id: INSIGHT_B_ID,
-          userId: USER_B_ID,
-          content: 'User B insight',
-          source: 'user',
-          category: 'general',
-          relevanceScore: 1.0,
-        },
-      ])
-      .onConflictDoNothing();
-
-    dbAvailable = true;
-  } catch {
-    // Database is not reachable (e.g., CI environment without Postgres on port 5433).
-    // All tests in this suite will be skipped.
-  }
-});
-
-// Skip all tests in this file when the database is not reachable (e.g., CI without Postgres).
-beforeEach((ctx) => {
-  if (!dbAvailable) {
-    ctx.skip();
-  }
-});
-
-afterAll(async () => {
-  if (!handle) return;
-  const db = handle.db;
-
-  // Delete in dependency order (FK constraints)
-  await db.delete(messages).where(eq(messages.id, MSG_A_ID));
-  await db.delete(messages).where(eq(messages.id, MSG_B_ID));
-  await db.delete(conversations).where(eq(conversations.id, CONV_A_ID));
-  await db.delete(conversations).where(eq(conversations.id, CONV_B_ID));
-  await db.delete(agents).where(eq(agents.id, AGENT_A_ID));
-  await db.delete(agents).where(eq(agents.id, AGENT_B_ID));
-  await db.delete(agents).where(eq(agents.id, AGENT_SYS_ID));
-  await db.delete(preferences).where(eq(preferences.id, PREF_A_ID));
-  await db.delete(preferences).where(eq(preferences.id, PREF_B_ID));
-  await db.delete(insights).where(eq(insights.id, INSIGHT_A_ID));
-  await db.delete(insights).where(eq(insights.id, INSIGHT_B_ID));
-  await db.delete(users).where(eq(users.id, USER_A_ID));
-  await db.delete(users).where(eq(users.id, USER_B_ID));
-
-  await handle.close();
-});
-
-// ─── Conversations isolation ──────────────────────────────────────────────────
-
-describe('ConversationsRepo — cross-user isolation', () => {
-  it('User A can find their own conversation by id', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const conv = await repo.findById(CONV_A_ID, USER_A_ID);
-    expect(conv).toBeDefined();
-    expect(conv!.id).toBe(CONV_A_ID);
-  });
-
-  it('User B cannot find User A conversation by id (returns undefined)', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const conv = await repo.findById(CONV_A_ID, USER_B_ID);
-    expect(conv).toBeUndefined();
-  });
-
-  it('User A cannot find User B conversation by id (returns undefined)', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const conv = await repo.findById(CONV_B_ID, USER_A_ID);
-    expect(conv).toBeUndefined();
-  });
-
-  it('findAll returns only own conversations for User A', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const convs = await repo.findAll(USER_A_ID);
-    const ids = convs.map((c) => c.id);
-    expect(ids).toContain(CONV_A_ID);
-    expect(ids).not.toContain(CONV_B_ID);
-  });
-
-  it('findAll returns only own conversations for User B', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const convs = await repo.findAll(USER_B_ID);
-    const ids = convs.map((c) => c.id);
-    expect(ids).toContain(CONV_B_ID);
-    expect(ids).not.toContain(CONV_A_ID);
-  });
-});
-
-// ─── Messages isolation ───────────────────────────────────────────────────────
-
-describe('ConversationsRepo.findMessages — cross-user isolation', () => {
-  it('User A can read messages from their own conversation', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const msgs = await repo.findMessages(CONV_A_ID, USER_A_ID);
-    const ids = msgs.map((m) => m.id);
-    expect(ids).toContain(MSG_A_ID);
-  });
-
-  it('User B cannot read messages from User A conversation (returns empty array)', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const msgs = await repo.findMessages(CONV_A_ID, USER_B_ID);
-    expect(msgs).toHaveLength(0);
-  });
-
-  it('User A cannot read messages from User B conversation (returns empty array)', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const msgs = await repo.findMessages(CONV_B_ID, USER_A_ID);
-    expect(msgs).toHaveLength(0);
-  });
-
-  it('addMessage is rejected when user does not own the conversation', async () => {
-    const repo = createConversationsRepo(handle.db);
-    const result = await repo.addMessage(
-      {
-        conversationId: CONV_A_ID,
-        role: 'user',
-        content: 'Attempted injection by User B',
-      },
-      USER_B_ID,
-    );
-    expect(result).toBeUndefined();
-  });
-});
-
-// ─── Agent configs isolation ──────────────────────────────────────────────────
-
-describe('AgentsRepo.findAccessible — cross-user isolation', () => {
-  it('User A sees their own private agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const accessible = await repo.findAccessible(USER_A_ID);
-    const ids = accessible.map((a) => a.id);
-    expect(ids).toContain(AGENT_A_ID);
-  });
-
-  it('User A does NOT see User B private agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const accessible = await repo.findAccessible(USER_A_ID);
-    const ids = accessible.map((a) => a.id);
-    expect(ids).not.toContain(AGENT_B_ID);
-  });
-
-  it('User B does NOT see User A private agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const accessible = await repo.findAccessible(USER_B_ID);
-    const ids = accessible.map((a) => a.id);
-    expect(ids).not.toContain(AGENT_A_ID);
-  });
-
-  it('Both users can see the shared system agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const accessibleA = await repo.findAccessible(USER_A_ID);
-    const accessibleB = await repo.findAccessible(USER_B_ID);
-    expect(accessibleA.map((a) => a.id)).toContain(AGENT_SYS_ID);
-    expect(accessibleB.map((a) => a.id)).toContain(AGENT_SYS_ID);
-  });
-
-  it('findSystem returns the system agent for any caller', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const system = await repo.findSystem();
-    const ids = system.map((a) => a.id);
-    expect(ids).toContain(AGENT_SYS_ID);
-  });
-
-  it('update with ownerId prevents User B from modifying User A agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const result = await repo.update(AGENT_A_ID, { model: 'hacked' }, USER_B_ID);
-    expect(result).toBeUndefined();
-
-    // Verify the agent was not actually mutated
-    const unchanged = await repo.findById(AGENT_A_ID);
-    expect(unchanged?.model).toBe('test-model');
-  });
-
-  it('remove prevents User B from deleting User A agent', async () => {
-    const repo = createAgentsRepo(handle.db);
-    const deleted = await repo.remove(AGENT_A_ID, USER_B_ID);
-    expect(deleted).toBe(false);
-
-    // Verify the agent still exists
-    const still = await repo.findById(AGENT_A_ID);
-    expect(still).toBeDefined();
-  });
-});
-
-// ─── Preferences isolation ────────────────────────────────────────────────────
-
-describe('PreferencesRepo — cross-user isolation', () => {
-  it('User A can retrieve their own preferences', async () => {
-    const repo = createPreferencesRepo(handle.db);
-    const prefs = await repo.findByUser(USER_A_ID);
-    const ids = prefs.map((p) => p.id);
-    expect(ids).toContain(PREF_A_ID);
-  });
-
-  it('User A preferences do not contain User B preferences', async () => {
-    const repo = createPreferencesRepo(handle.db);
-    const prefs = await repo.findByUser(USER_A_ID);
-    const ids = prefs.map((p) => p.id);
-    expect(ids).not.toContain(PREF_B_ID);
-  });
-
-  it('User B preferences do not contain User A preferences', async () => {
-    const repo = createPreferencesRepo(handle.db);
-    const prefs = await repo.findByUser(USER_B_ID);
-    const ids = prefs.map((p) => p.id);
-    expect(ids).not.toContain(PREF_A_ID);
-  });
-
-  it('findByUserAndKey is scoped to the requesting user', async () => {
-    const repo = createPreferencesRepo(handle.db);
-    // Both users have key "theme" — each should only see their own value
-    const prefA = await repo.findByUserAndKey(USER_A_ID, 'theme');
-    const prefB = await repo.findByUserAndKey(USER_B_ID, 'theme');
-
-    expect(prefA).toBeDefined();
-    // Drizzle returns JSONB values as parsed JS values; '"dark"' (JSON string) → 'dark'
-    expect(prefA!.value).toBe('dark');
-    expect(prefB).toBeDefined();
-    expect(prefB!.value).toBe('light');
-  });
-
-  it('remove is scoped to the requesting user (cannot delete another user pref)', async () => {
-    const repo = createPreferencesRepo(handle.db);
-    // User B tries to delete User A's "theme" preference — should silently fail
-    const deleted = await repo.remove(USER_B_ID, 'theme');
-    // This only deletes USER_B's own "theme" row; re-insert it for afterAll cleanup
-    expect(deleted).toBe(true); // deletes User B's OWN theme pref
-
-    // User A's theme pref must be untouched
-    const prefA = await repo.findByUserAndKey(USER_A_ID, 'theme');
-    expect(prefA).toBeDefined();
-
-    // Re-insert User B's preference so afterAll cleanup still finds it
-    await repo.upsert({
-      id: PREF_B_ID,
-      userId: USER_B_ID,
-      key: 'theme',
-      value: 'light',
-      category: 'appearance',
-    });
-  });
-});
-
-// ─── Insights isolation ───────────────────────────────────────────────────────
-
-describe('InsightsRepo — cross-user isolation', () => {
-  it('User A can retrieve their own insights', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const list = await repo.findByUser(USER_A_ID);
-    const ids = list.map((i) => i.id);
-    expect(ids).toContain(INSIGHT_A_ID);
-  });
-
-  it('User A insights do not contain User B insights', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const list = await repo.findByUser(USER_A_ID);
-    const ids = list.map((i) => i.id);
-    expect(ids).not.toContain(INSIGHT_B_ID);
-  });
-
-  it('User B insights do not contain User A insights', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const list = await repo.findByUser(USER_B_ID);
-    const ids = list.map((i) => i.id);
-    expect(ids).not.toContain(INSIGHT_A_ID);
-  });
-
-  it('findById is scoped to the requesting user', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const own = await repo.findById(INSIGHT_A_ID, USER_A_ID);
-    const cross = await repo.findById(INSIGHT_A_ID, USER_B_ID);
-
-    expect(own).toBeDefined();
-    expect(cross).toBeUndefined();
-  });
-
-  it('searchByEmbedding returns only own insights', async () => {
-    const repo = createInsightsRepo(handle.db);
-    // Our test insights have no embedding — the query filters WHERE embedding IS NOT NULL
-    // so the result set is empty, which already proves no cross-user leakage.
-    // Using a 1536-dimension zero vector as the query embedding.
-    const zeroVector = Array<number>(1536).fill(0);
-
-    const resultsA = await repo.searchByEmbedding(USER_A_ID, zeroVector, 50, 2.0);
-    const resultsB = await repo.searchByEmbedding(USER_B_ID, zeroVector, 50, 2.0);
-
-    // The raw SQL query returns row objects directly (not wrapped in { insight }).
-    // Cast via unknown to extract id safely regardless of the return shape.
-    const toId = (r: unknown): string =>
-      ((r as Record<string, unknown>)['id'] as string | undefined) ??
-      ((r as Record<string, Record<string, unknown>>)['insight']?.['id'] as string | undefined) ??
-      '';
-    const idsInA = resultsA.map(toId);
-    const idsInB = resultsB.map(toId);
-
-    // User B's insight must never appear in User A's search results
-    expect(idsInA).not.toContain(INSIGHT_B_ID);
-    // User A's insight must never appear in User B's search results
-    expect(idsInB).not.toContain(INSIGHT_A_ID);
-  });
-
-  it('update is scoped to the requesting user', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const result = await repo.update(INSIGHT_A_ID, USER_B_ID, { content: 'hacked' });
-    expect(result).toBeUndefined();
-
-    // Verify the insight was not mutated
-    const unchanged = await repo.findById(INSIGHT_A_ID, USER_A_ID);
-    expect(unchanged?.content).toBe('User A insight');
-  });
-
-  it('remove is scoped to the requesting user', async () => {
-    const repo = createInsightsRepo(handle.db);
-    const deleted = await repo.remove(INSIGHT_A_ID, USER_B_ID);
-    expect(deleted).toBe(false);
-
-    // Verify the insight still exists
-    const still = await repo.findById(INSIGHT_A_ID, USER_A_ID);
-    expect(still).toBeDefined();
-  });
-});
@@ -1,64 +0,0 @@
-/**
- * Test B — Gateway boot refuses (fail-fast) when PG is unreachable.
- *
- * Prereq: docker compose -f docker-compose.federated.yml --profile federated up -d
- *         (Valkey must be running; only PG is intentionally misconfigured.)
- * Run:    FEDERATED_INTEGRATION=1 pnpm --filter @mosaicstack/gateway test src/__tests__/integration/federated-boot.pg-unreachable.integration.test.ts
- *
- * Skipped when FEDERATED_INTEGRATION !== '1'.
- */
-
-import net from 'node:net';
-import { beforeAll, describe, expect, it } from 'vitest';
-import { TierDetectionError, detectAndAssertTier } from '@mosaicstack/storage';
-
-const run = process.env['FEDERATED_INTEGRATION'] === '1';
-
-const VALKEY_URL = 'redis://localhost:6380';
-
-/**
- * Reserves a guaranteed-closed port at runtime by binding to an ephemeral OS
- * port (port 0) and immediately releasing it. The OS will not reassign the
- * port during the TIME_WAIT window, so it remains closed for the duration of
- * this test.
- */
-async function reserveClosedPort(): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const server = net.createServer();
-    server.listen(0, '127.0.0.1', () => {
-      const addr = server.address();
-      if (typeof addr !== 'object' || !addr) return reject(new Error('no addr'));
-      const port = addr.port;
-      server.close(() => resolve(port));
-    });
-    server.on('error', reject);
-  });
-}
-
-describe.skipIf(!run)('federated boot — PG unreachable', () => {
-  let badPgUrl: string;
-
-  beforeAll(async () => {
-    const closedPort = await reserveClosedPort();
-    badPgUrl = `postgresql://mosaic:mosaic@localhost:${closedPort}/mosaic`;
-  });
-
-  it('detectAndAssertTier throws TierDetectionError with service: postgres when PG is down', async () => {
-    const brokenConfig = {
-      tier: 'federated' as const,
-      storage: {
-        type: 'postgres' as const,
-        url: badPgUrl,
-        enableVector: true,
-      },
-      queue: {
-        type: 'bullmq',
-        url: VALKEY_URL,
-      },
-    };
-
-    await expect(detectAndAssertTier(brokenConfig)).rejects.toSatisfy(
-      (err: unknown) => err instanceof TierDetectionError && err.service === 'postgres',
-    );
-  }, 10_000);
-});
@@ -1,50 +0,0 @@
-/**
- * Test A — Gateway boot succeeds when federated services are up.
- *
- * Prereq: docker compose -f docker-compose.federated.yml --profile federated up -d
- * Run:    FEDERATED_INTEGRATION=1 pnpm --filter @mosaicstack/gateway test src/__tests__/integration/federated-boot.success.integration.test.ts
- *
- * Skipped when FEDERATED_INTEGRATION !== '1'.
- */
-
-import postgres from 'postgres';
-import { afterAll, describe, expect, it } from 'vitest';
-import { detectAndAssertTier } from '@mosaicstack/storage';
-
-const run = process.env['FEDERATED_INTEGRATION'] === '1';
-
-const PG_URL = 'postgresql://mosaic:mosaic@localhost:5433/mosaic';
-const VALKEY_URL = 'redis://localhost:6380';
-
-const federatedConfig = {
-  tier: 'federated' as const,
-  storage: {
-    type: 'postgres' as const,
-    url: PG_URL,
-    enableVector: true,
-  },
-  queue: {
-    type: 'bullmq',
-    url: VALKEY_URL,
-  },
-};
-
-describe.skipIf(!run)('federated boot — success path', () => {
-  let sql: ReturnType<typeof postgres> | undefined;
-
-  afterAll(async () => {
-    if (sql) {
-      await sql.end({ timeout: 2 }).catch(() => {});
-    }
-  });
-
-  it('detectAndAssertTier resolves without throwing when federated services are up', async () => {
-    await expect(detectAndAssertTier(federatedConfig)).resolves.toBeUndefined();
-  }, 10_000);
-
-  it('pgvector extension is registered (pg_extension row exists)', async () => {
-    sql = postgres(PG_URL, { max: 1, connect_timeout: 5, idle_timeout: 5 });
-    const rows = await sql`SELECT * FROM pg_extension WHERE extname = 'vector'`;
-    expect(rows).toHaveLength(1);
-  }, 10_000);
-});
@@ -1,43 +0,0 @@
-/**
- * Test C — pgvector extension is functional end-to-end.
- *
- * Creates a temp table with a vector(3) column, inserts a row, and queries it
- * back — confirming the extension is not just registered but operational.
- *
- * Prereq: docker compose -f docker-compose.federated.yml --profile federated up -d
- * Run:    FEDERATED_INTEGRATION=1 pnpm --filter @mosaicstack/gateway test src/__tests__/integration/federated-pgvector.integration.test.ts
- *
- * Skipped when FEDERATED_INTEGRATION !== '1'.
- */
-
-import postgres from 'postgres';
-import { afterAll, describe, expect, it } from 'vitest';
-
-const run = process.env['FEDERATED_INTEGRATION'] === '1';
-
-const PG_URL = 'postgresql://mosaic:mosaic@localhost:5433/mosaic';
-
-let sql: ReturnType<typeof postgres> | undefined;
-
-afterAll(async () => {
-  if (sql) {
-    await sql.end({ timeout: 2 }).catch(() => {});
-  }
-});
-
-describe.skipIf(!run)('federated pgvector — functional end-to-end', () => {
-  it('vector ops round-trip: INSERT [1,2,3] and SELECT returns [1,2,3]', async () => {
-    sql = postgres(PG_URL, { max: 1, connect_timeout: 5, idle_timeout: 5 });
-
-    await sql`CREATE TEMP TABLE t (id int, embedding vector(3))`;
-    await sql`INSERT INTO t VALUES (1, '[1,2,3]')`;
-    const rows = await sql`SELECT embedding FROM t`;
-
-    expect(rows).toHaveLength(1);
-    // The postgres driver returns vector columns as strings like '[1,2,3]'.
-    // Normalise by parsing the string representation.
-    const raw = rows[0]?.['embedding'] as string;
-    const parsed = JSON.parse(raw) as number[];
-    expect(parsed).toEqual([1, 2, 3]);
-  }, 10_000);
-});
@@ -1,243 +0,0 @@
-/**
- * Federation M2 E2E test — peer-add enrollment flow (FED-M2-10).
- *
- * Covers MILESTONES.md acceptance test #6:
- *   "`peer add <url>` on Server A yields an `active` peer record with a valid cert + key"
- *
- * This test simulates two gateways using a single bootstrapped NestJS app:
- *   - "Server A": the admin API that generates a keypair and stores the cert
- *   - "Server B": the enrollment endpoint that signs the CSR
- *   Both share the same DB + Step-CA in the test environment.
- *
- * Prerequisites:
- *   docker compose -f docker-compose.federated.yml --profile federated up -d
- *
- * Run:
- *   FEDERATED_INTEGRATION=1 STEP_CA_AVAILABLE=1 \
- *   STEP_CA_URL=https://localhost:9000 \
- *   STEP_CA_PROVISIONER_KEY_JSON="$(docker exec $(docker ps -qf name=step-ca) cat /home/step/secrets/mosaic-fed.json)" \
- *   STEP_CA_ROOT_CERT_PATH=/tmp/step-ca-root.crt \
- *   pnpm --filter @mosaicstack/gateway test \
- *     src/__tests__/integration/federation-m2-e2e.integration.test.ts
- *
- * Obtaining Step-CA credentials:
- *   # Extract provisioner key from running container:
- *   #   docker exec $(docker ps -qf name=step-ca) cat /home/step/secrets/mosaic-fed.json
- *   # Copy root cert from container:
- *   #   docker cp $(docker ps -qf name=step-ca):/home/step/certs/root_ca.crt /tmp/step-ca-root.crt
- *   # Then: export STEP_CA_ROOT_CERT_PATH=/tmp/step-ca-root.crt
- *
- * Skipped unless both FEDERATED_INTEGRATION=1 and STEP_CA_AVAILABLE=1 are set.
- */
-
-import * as crypto from 'node:crypto';
-import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-import { Test } from '@nestjs/testing';
-import { ValidationPipe } from '@nestjs/common';
-import { FastifyAdapter, type NestFastifyApplication } from '@nestjs/platform-fastify';
-import supertest from 'supertest';
-import {
-  createDb,
-  type Db,
-  type DbHandle,
-  federationPeers,
-  federationGrants,
-  federationEnrollmentTokens,
-  inArray,
-  eq,
-} from '@mosaicstack/db';
-import * as schema from '@mosaicstack/db';
-import { DB } from '../../database/database.module.js';
-import { AdminGuard } from '../../admin/admin.guard.js';
-import { FederationModule } from '../../federation/federation.module.js';
-import { GrantsService } from '../../federation/grants.service.js';
-import { EnrollmentService } from '../../federation/enrollment.service.js';
-
-const run = process.env['FEDERATED_INTEGRATION'] === '1';
-const stepCaRun =
-  run &&
-  process.env['STEP_CA_AVAILABLE'] === '1' &&
-  !!process.env['STEP_CA_URL'] &&
-  !!process.env['STEP_CA_PROVISIONER_KEY_JSON'] &&
-  !!process.env['STEP_CA_ROOT_CERT_PATH'];
-
-const PG_URL = 'postgresql://mosaic:mosaic@localhost:5433/mosaic';
-
-const RUN_ID = crypto.randomUUID();
-
-describe.skipIf(!stepCaRun)('federation M2 E2E — peer add enrollment flow', () => {
-  let handle: DbHandle;
-  let db: Db;
-  let app: NestFastifyApplication;
-  let agent: ReturnType<typeof supertest>;
-  let grantsService: GrantsService;
-  let enrollmentService: EnrollmentService;
-
-  const createdTokenGrantIds: string[] = [];
-  const createdGrantIds: string[] = [];
-  const createdPeerIds: string[] = [];
-  const createdUserIds: string[] = [];
-
-  beforeAll(async () => {
-    process.env['BETTER_AUTH_SECRET'] ??= 'test-e2e-sealing-key';
-
-    handle = createDb(PG_URL);
-    db = handle.db;
-
-    const moduleRef = await Test.createTestingModule({
-      imports: [FederationModule],
-      providers: [{ provide: DB, useValue: db }],
-    })
-      .overrideGuard(AdminGuard)
-      .useValue({ canActivate: () => true })
-      .compile();
-
-    app = moduleRef.createNestApplication<NestFastifyApplication>(new FastifyAdapter());
-    app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
-    await app.init();
-    await app.getHttpAdapter().getInstance().ready();
-
-    agent = supertest(app.getHttpServer());
-
-    grantsService = moduleRef.get(GrantsService);
-    enrollmentService = moduleRef.get(EnrollmentService);
-  }, 30_000);
-
-  afterAll(async () => {
-    if (db && createdTokenGrantIds.length > 0) {
-      await db
-        .delete(federationEnrollmentTokens)
-        .where(inArray(federationEnrollmentTokens.grantId, createdTokenGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-    }
-    if (db && createdGrantIds.length > 0) {
-      await db
-        .delete(federationGrants)
-        .where(inArray(federationGrants.id, createdGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-    }
-    if (db && createdPeerIds.length > 0) {
-      await db
-        .delete(federationPeers)
-        .where(inArray(federationPeers.id, createdPeerIds))
-        .catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-    }
-    if (db && createdUserIds.length > 0) {
-      await db
-        .delete(schema.users)
-        .where(inArray(schema.users.id, createdUserIds))
-        .catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-    }
-    if (app)
-      await app.close().catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-    if (handle)
-      await handle.close().catch((e: unknown) => console.error('[federation-m2-e2e cleanup]', e));
-  });
-
-  // -------------------------------------------------------------------------
-  // #6 — peer add: keypair → enrollment → cert storage → active peer record
-  // -------------------------------------------------------------------------
-  it('#6 — peer add flow: keypair → enrollment → cert storage → active peer record', async () => {
-    // Create a subject user to satisfy FK on federation_grants.subject_user_id
-    const userId = crypto.randomUUID();
-    await db
-      .insert(schema.users)
-      .values({
-        id: userId,
-        name: `e2e-user-${RUN_ID}`,
-        email: `e2e-${RUN_ID}@federation-test.invalid`,
-        emailVerified: false,
-      })
-      .onConflictDoNothing();
-    createdUserIds.push(userId);
-
-    // ── Step A: "Server B" setup ─────────────────────────────────────────
-    // Server B admin creates a grant and generates an enrollment token to
-    // share out-of-band with Server A's operator.
-
-    // Insert a placeholder peer on "Server B" to satisfy the grant FK
-    const serverBPeerId = crypto.randomUUID();
-    await db
-      .insert(federationPeers)
-      .values({
-        id: serverBPeerId,
-        commonName: `server-b-peer-${RUN_ID}`,
-        displayName: 'Server B Placeholder',
-        certPem: '-----BEGIN CERTIFICATE-----\nMOCK\n-----END CERTIFICATE-----\n',
-        certSerial: `serial-b-${serverBPeerId}`,
-        certNotAfter: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000),
-        state: 'pending',
-      })
-      .onConflictDoNothing();
-    createdPeerIds.push(serverBPeerId);
-
-    const grant = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: { resources: ['tasks'], excluded_resources: [], max_rows_per_query: 100 },
-      peerId: serverBPeerId,
-    });
-    createdGrantIds.push(grant.id);
-    createdTokenGrantIds.push(grant.id);
-
-    const { token } = await enrollmentService.createToken({
-      grantId: grant.id,
-      peerId: serverBPeerId,
-      ttlSeconds: 900,
-    });
-
-    // ── Step B: "Server A" generates keypair ─────────────────────────────
-    const keypairRes = await agent
-      .post('/api/admin/federation/peers/keypair')
-      .send({
-        commonName: `e2e-peer-${RUN_ID.slice(0, 8)}`,
-        displayName: 'E2E Test Peer',
-        endpointUrl: 'https://test.invalid',
-      })
-      .set('Content-Type', 'application/json');
-
-    expect(keypairRes.status).toBe(201);
-    const { peerId, csrPem } = keypairRes.body as { peerId: string; csrPem: string };
-    expect(typeof peerId).toBe('string');
-    expect(csrPem).toContain('-----BEGIN CERTIFICATE REQUEST-----');
-    createdPeerIds.push(peerId);
-
-    // ── Step C: Enrollment (simulates Server A sending CSR to Server B) ──
-    const enrollRes = await agent
-      .post(`/api/federation/enrollment/${token}`)
-      .send({ csrPem })
-      .set('Content-Type', 'application/json');
-
-    expect(enrollRes.status).toBe(200);
-    const { certPem, certChainPem } = enrollRes.body as {
-      certPem: string;
-      certChainPem: string;
-    };
-    expect(certPem).toContain('-----BEGIN CERTIFICATE-----');
-    expect(certChainPem).toContain('-----BEGIN CERTIFICATE-----');
-
-    // ── Step D: "Server A" stores the cert ───────────────────────────────
-    const storeRes = await agent
-      .patch(`/api/admin/federation/peers/${peerId}/cert`)
-      .send({ certPem })
-      .set('Content-Type', 'application/json');
-
-    expect(storeRes.status).toBe(200);
-
-    // ── Step E: Verify peer record in DB ─────────────────────────────────
-    const [peer] = await db
-      .select()
-      .from(federationPeers)
-      .where(eq(federationPeers.id, peerId))
-      .limit(1);
-
-    expect(peer).toBeDefined();
-    expect(peer?.state).toBe('active');
-    expect(peer?.certPem).toContain('-----BEGIN CERTIFICATE-----');
-    expect(typeof peer?.certSerial).toBe('string');
-    expect((peer?.certSerial ?? '').length).toBeGreaterThan(0);
-    // clientKeyPem is a sealed ciphertext — must not be a raw PEM
-    expect(peer?.clientKeyPem?.startsWith('-----BEGIN')).toBe(false);
-    // certNotAfter must be in the future
-    expect(peer?.certNotAfter?.getTime()).toBeGreaterThan(Date.now());
-  }, 60_000);
-});
@@ -1,483 +0,0 @@
-/**
- * Federation M2 integration tests (FED-M2-09).
- *
- * Covers MILESTONES.md acceptance tests #1, #2, #3, #5, #7, #8.
- *
- * Prerequisites:
- *   docker compose -f docker-compose.federated.yml --profile federated up -d
- *
- * Run DB-only tests (no Step-CA):
- *   FEDERATED_INTEGRATION=1 BETTER_AUTH_SECRET=test-secret pnpm --filter @mosaicstack/gateway test \
- *     src/__tests__/integration/federation-m2.integration.test.ts
- *
- * Run all tests including Step-CA-dependent ones:
- *   FEDERATED_INTEGRATION=1 STEP_CA_AVAILABLE=1 \
- *   STEP_CA_URL=https://localhost:9000 \
- *   STEP_CA_PROVISIONER_KEY_JSON="$(docker exec $(docker ps -qf name=step-ca) cat /home/step/secrets/mosaic-fed.json)" \
- *   STEP_CA_ROOT_CERT_PATH=/tmp/step-ca-root.crt \
- *   pnpm --filter @mosaicstack/gateway test \
- *     src/__tests__/integration/federation-m2.integration.test.ts
- *
- * Obtaining Step-CA credentials:
- *   # Extract provisioner key from running container:
- *   #   docker exec $(docker ps -qf name=step-ca) cat /home/step/secrets/mosaic-fed.json
- *   # Copy root cert from container:
- *   #   docker cp $(docker ps -qf name=step-ca):/home/step/certs/root_ca.crt /tmp/step-ca-root.crt
- *   # Then: export STEP_CA_ROOT_CERT_PATH=/tmp/step-ca-root.crt
- */
-
-import * as crypto from 'node:crypto';
-import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-import { Test } from '@nestjs/testing';
-import { GoneException } from '@nestjs/common';
-import { Pkcs10CertificateRequestGenerator, X509Certificate as PeculiarX509 } from '@peculiar/x509';
-import {
-  createDb,
-  type Db,
-  type DbHandle,
-  federationPeers,
-  federationGrants,
-  federationEnrollmentTokens,
-  inArray,
-  eq,
-} from '@mosaicstack/db';
-import * as schema from '@mosaicstack/db';
-import { seal } from '@mosaicstack/auth';
-import { DB } from '../../database/database.module.js';
-import { GrantsService } from '../../federation/grants.service.js';
-import { EnrollmentService } from '../../federation/enrollment.service.js';
-import { CaService } from '../../federation/ca.service.js';
-import { FederationScopeError } from '../../federation/scope-schema.js';
-
-const run = process.env['FEDERATED_INTEGRATION'] === '1';
-const stepCaRun = run && process.env['STEP_CA_AVAILABLE'] === '1';
-
-const PG_URL = 'postgresql://mosaic:mosaic@localhost:5433/mosaic';
-
-// ---------------------------------------------------------------------------
-// Helpers for test data isolation
-// ---------------------------------------------------------------------------
-
-/** Unique run prefix to identify rows created by this test run. */
-const RUN_ID = crypto.randomUUID();
-
-/** Insert a minimal user row to satisfy the FK on federation_grants.subject_user_id. */
-async function insertTestUser(db: Db, id: string): Promise<void> {
-  await db
-    .insert(schema.users)
-    .values({
-      id,
-      name: `test-user-${id}`,
-      email: `test-${id}@federation-test.invalid`,
-      emailVerified: false,
-    })
-    .onConflictDoNothing();
-}
-
-/** Insert a minimal peer row to satisfy the FK on federation_grants.peer_id. */
-async function insertTestPeer(db: Db, id: string, suffix: string = ''): Promise<void> {
-  await db
-    .insert(federationPeers)
-    .values({
-      id,
-      commonName: `test-peer-${RUN_ID}-${suffix}`,
-      displayName: `Test Peer ${suffix}`,
-      certPem: '-----BEGIN CERTIFICATE-----\nMOCK\n-----END CERTIFICATE-----\n',
-      certSerial: `test-serial-${id}`,
-      certNotAfter: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000),
-      state: 'pending',
-    })
-    .onConflictDoNothing();
-}
-
-// ---------------------------------------------------------------------------
-// DB-only test module (CaService mocked so env vars not required)
-// ---------------------------------------------------------------------------
-
-function buildDbModule(db: Db) {
-  return Test.createTestingModule({
-    providers: [
-      { provide: DB, useValue: db },
-      GrantsService,
-      {
-        provide: CaService,
-        useValue: {
-          issueCert: async () => {
-            throw new Error('CaService.issueCert should not be called in DB-only tests');
-          },
-        },
-      },
-      EnrollmentService,
-    ],
-  }).compile();
-}
-
-// ---------------------------------------------------------------------------
-// Test suite — DB-only (no Step-CA)
-// ---------------------------------------------------------------------------
-
-describe.skipIf(!run)('federation M2 — DB-only tests', () => {
-  let handle: DbHandle;
-  let db: Db;
-  let grantsService: GrantsService;
-
-  /** IDs created during this run — cleaned up in afterAll. */
-  const createdGrantIds: string[] = [];
-  const createdPeerIds: string[] = [];
-  const createdUserIds: string[] = [];
-
-  beforeAll(async () => {
-    process.env['BETTER_AUTH_SECRET'] ??= 'test-integration-sealing-key-not-for-prod';
-
-    handle = createDb(PG_URL);
-    db = handle.db;
-
-    const moduleRef = await buildDbModule(db);
-    grantsService = moduleRef.get(GrantsService);
-  });
-
-  afterAll(async () => {
-    // Clean up in FK-safe order: tokens → grants → peers → users
-    if (db && createdGrantIds.length > 0) {
-      await db
-        .delete(federationEnrollmentTokens)
-        .where(inArray(federationEnrollmentTokens.grantId, createdGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-      await db
-        .delete(federationGrants)
-        .where(inArray(federationGrants.id, createdGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (db && createdPeerIds.length > 0) {
-      await db
-        .delete(federationPeers)
-        .where(inArray(federationPeers.id, createdPeerIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (db && createdUserIds.length > 0) {
-      await db
-        .delete(schema.users)
-        .where(inArray(schema.users.id, createdUserIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (handle)
-      await handle.close().catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-  });
-
-  // -------------------------------------------------------------------------
-  // #1 — grant create writes a pending row
-  // -------------------------------------------------------------------------
-  it('#1 — createGrant writes a pending row to DB', async () => {
-    const userId = crypto.randomUUID();
-    const peerId = crypto.randomUUID();
-    const validScope = {
-      resources: ['tasks'],
-      excluded_resources: [],
-      max_rows_per_query: 100,
-    };
-
-    await insertTestUser(db, userId);
-    await insertTestPeer(db, peerId, 'test1');
-    createdUserIds.push(userId);
-    createdPeerIds.push(peerId);
-
-    const grant = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: validScope,
-      peerId,
-    });
-
-    createdGrantIds.push(grant.id);
-
-    // Verify the row exists in DB with correct shape
-    const [row] = await db
-      .select()
-      .from(federationGrants)
-      .where(eq(federationGrants.id, grant.id))
-      .limit(1);
-
-    expect(row).toBeDefined();
-    expect(row?.status).toBe('pending');
-    expect(row?.peerId).toBe(peerId);
-    expect(row?.subjectUserId).toBe(userId);
-    const storedScope = row?.scope as Record<string, unknown>;
-    expect(storedScope['resources']).toEqual(['tasks']);
-    expect(storedScope['max_rows_per_query']).toBe(100);
-  }, 15_000);
-
-  // -------------------------------------------------------------------------
-  // #7 — scope with unknown resource type rejected
-  // -------------------------------------------------------------------------
-  it('#7 — createGrant rejects scope with unknown resource type', async () => {
-    const userId = crypto.randomUUID();
-    const peerId = crypto.randomUUID();
-    const invalidScope = {
-      resources: ['totally_unknown_resource'],
-      excluded_resources: [],
-      max_rows_per_query: 100,
-    };
-
-    await insertTestUser(db, userId);
-    await insertTestPeer(db, peerId, 'test7');
-    createdUserIds.push(userId);
-    createdPeerIds.push(peerId);
-
-    await expect(
-      grantsService.createGrant({
-        subjectUserId: userId,
-        scope: invalidScope,
-        peerId,
-      }),
-    ).rejects.toThrow(FederationScopeError);
-  }, 15_000);
-
-  // -------------------------------------------------------------------------
-  // #8 — listGrants returns accurate status for grants in various states
-  // -------------------------------------------------------------------------
-  it('#8 — listGrants returns accurate status for grants in various states', async () => {
-    const userId = crypto.randomUUID();
-    const peerId = crypto.randomUUID();
-    const validScope = {
-      resources: ['notes'],
-      excluded_resources: [],
-      max_rows_per_query: 50,
-    };
-
-    await insertTestUser(db, userId);
-    await insertTestPeer(db, peerId, 'test8');
-    createdUserIds.push(userId);
-    createdPeerIds.push(peerId);
-
-    // Create two pending grants via GrantsService
-    const grantA = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: validScope,
-      peerId,
-    });
-    const grantB = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: { resources: ['tasks'], excluded_resources: [], max_rows_per_query: 50 },
-      peerId,
-    });
-    createdGrantIds.push(grantA.id, grantB.id);
-
-    // Insert a third grant directly in 'revoked' state to test status variety
-    const [grantC] = await db
-      .insert(federationGrants)
-      .values({
-        id: crypto.randomUUID(),
-        subjectUserId: userId,
-        peerId,
-        scope: validScope,
-        status: 'revoked',
-        revokedAt: new Date(),
-      })
-      .returning();
-    createdGrantIds.push(grantC!.id);
-
-    // List all grants for this peer
-    const allForPeer = await grantsService.listGrants({ peerId });
-
-    const ourGrantIds = new Set([grantA.id, grantB.id, grantC!.id]);
-    const ourGrants = allForPeer.filter((g) => ourGrantIds.has(g.id));
-    expect(ourGrants).toHaveLength(3);
-
-    const pendingGrants = ourGrants.filter((g) => g.status === 'pending');
-    const revokedGrants = ourGrants.filter((g) => g.status === 'revoked');
-    expect(pendingGrants).toHaveLength(2);
-    expect(revokedGrants).toHaveLength(1);
-
-    // Status-filtered query
-    const pendingOnly = await grantsService.listGrants({ peerId, status: 'pending' });
-    const ourPending = pendingOnly.filter((g) => ourGrantIds.has(g.id));
-    expect(ourPending.every((g) => g.status === 'pending')).toBe(true);
-
-    // Verify peer list from DB also shows the peer rows with correct state
-    const peers = await db.select().from(federationPeers).where(eq(federationPeers.id, peerId));
-    expect(peers).toHaveLength(1);
-    expect(peers[0]?.state).toBe('pending');
-  }, 15_000);
-
-  // -------------------------------------------------------------------------
-  // #5 — client_key_pem encrypted at rest
-  // -------------------------------------------------------------------------
-  it('#5 — clientKeyPem stored in DB is a sealed ciphertext (not a valid PEM)', async () => {
-    const peerId = crypto.randomUUID();
-    const rawPem = '-----BEGIN PRIVATE KEY-----\nMOCK\n-----END PRIVATE KEY-----\n';
-    const sealed = seal(rawPem);
-
-    await db.insert(federationPeers).values({
-      id: peerId,
-      commonName: `test-peer-${RUN_ID}-sealed`,
-      displayName: 'Sealed Key Test Peer',
-      certPem: '-----BEGIN CERTIFICATE-----\nMOCK\n-----END CERTIFICATE-----\n',
-      certSerial: `test-serial-sealed-${peerId}`,
-      certNotAfter: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000),
-      state: 'pending',
-      clientKeyPem: sealed,
-    });
-    createdPeerIds.push(peerId);
-
-    const [row] = await db
-      .select()
-      .from(federationPeers)
-      .where(eq(federationPeers.id, peerId))
-      .limit(1);
-
-    expect(row).toBeDefined();
-    // The stored value must NOT be a valid PEM — it's a sealed ciphertext blob
-    expect(row?.clientKeyPem).toBeDefined();
-    expect(row?.clientKeyPem?.startsWith('-----BEGIN')).toBe(false);
-    // The sealed value should be non-trivial (at least 20 chars)
-    expect((row?.clientKeyPem ?? '').length).toBeGreaterThan(20);
-  }, 15_000);
-});
-
-// ---------------------------------------------------------------------------
-// Test suite — Step-CA gated
-// ---------------------------------------------------------------------------
-
-describe.skipIf(!stepCaRun)('federation M2 — Step-CA tests', () => {
-  let handle: DbHandle;
-  let db: Db;
-  let grantsService: GrantsService;
-  let enrollmentService: EnrollmentService;
-
-  const createdGrantIds: string[] = [];
-  const createdPeerIds: string[] = [];
-  const createdUserIds: string[] = [];
-
-  beforeAll(async () => {
-    handle = createDb(PG_URL);
-    db = handle.db;
-
-    // Use real CaService — env vars (STEP_CA_URL, STEP_CA_PROVISIONER_KEY_JSON,
-    // STEP_CA_ROOT_CERT_PATH) must be set when STEP_CA_AVAILABLE=1
-    const moduleRef = await Test.createTestingModule({
-      providers: [{ provide: DB, useValue: db }, CaService, GrantsService, EnrollmentService],
-    }).compile();
-
-    grantsService = moduleRef.get(GrantsService);
-    enrollmentService = moduleRef.get(EnrollmentService);
-  });
-
-  afterAll(async () => {
-    if (db && createdGrantIds.length > 0) {
-      await db
-        .delete(federationEnrollmentTokens)
-        .where(inArray(federationEnrollmentTokens.grantId, createdGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-      await db
-        .delete(federationGrants)
-        .where(inArray(federationGrants.id, createdGrantIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (db && createdPeerIds.length > 0) {
-      await db
-        .delete(federationPeers)
-        .where(inArray(federationPeers.id, createdPeerIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (db && createdUserIds.length > 0) {
-      await db
-        .delete(schema.users)
-        .where(inArray(schema.users.id, createdUserIds))
-        .catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-    }
-    if (handle)
-      await handle.close().catch((e: unknown) => console.error('[federation-m2-test cleanup]', e));
-  });
-
-  /** Generate a P-256 key pair and PKCS#10 CSR, returning the CSR as PEM. */
-  async function generateCsrPem(cn: string): Promise<string> {
-    const alg = { name: 'ECDSA', namedCurve: 'P-256', hash: 'SHA-256' };
-    const keyPair = await crypto.subtle.generateKey(alg, true, ['sign', 'verify']);
-    const csr = await Pkcs10CertificateRequestGenerator.create({
-      name: `CN=${cn}`,
-      keys: keyPair,
-      signingAlgorithm: alg,
-    });
-    return csr.toString('pem');
-  }
-
-  // -------------------------------------------------------------------------
-  // #2 — enrollment signs CSR and returns cert
-  // -------------------------------------------------------------------------
-  it('#2 — redeem returns a certPem containing a valid PEM certificate', async () => {
-    const userId = crypto.randomUUID();
-    const peerId = crypto.randomUUID();
-    const validScope = {
-      resources: ['tasks'],
-      excluded_resources: [],
-      max_rows_per_query: 100,
-    };
-
-    await insertTestUser(db, userId);
-    await insertTestPeer(db, peerId, 'ca-test2');
-    createdUserIds.push(userId);
-    createdPeerIds.push(peerId);
-
-    const grant = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: validScope,
-      peerId,
-    });
-    createdGrantIds.push(grant.id);
-
-    const { token } = await enrollmentService.createToken({
-      grantId: grant.id,
-      peerId,
-      ttlSeconds: 900,
-    });
-
-    const csrPem = await generateCsrPem(`gateway-test-${RUN_ID.slice(0, 8)}`);
-    const result = await enrollmentService.redeem(token, csrPem);
-
-    expect(result.certPem).toContain('-----BEGIN CERTIFICATE-----');
-    expect(result.certChainPem).toContain('-----BEGIN CERTIFICATE-----');
-
-    // Verify the issued cert parses cleanly
-    const cert = new PeculiarX509(result.certPem);
-    expect(cert.serialNumber).toBeTruthy();
-  }, 30_000);
-
-  // -------------------------------------------------------------------------
-  // #3 — token single-use; second attempt returns GoneException
-  // -------------------------------------------------------------------------
-  it('#3 — second redeem of the same token throws GoneException', async () => {
-    const userId = crypto.randomUUID();
-    const peerId = crypto.randomUUID();
-    const validScope = {
-      resources: ['notes'],
-      excluded_resources: [],
-      max_rows_per_query: 50,
-    };
-
-    await insertTestUser(db, userId);
-    await insertTestPeer(db, peerId, 'ca-test3');
-    createdUserIds.push(userId);
-    createdPeerIds.push(peerId);
-
-    const grant = await grantsService.createGrant({
-      subjectUserId: userId,
-      scope: validScope,
-      peerId,
-    });
-    createdGrantIds.push(grant.id);
-
-    const { token } = await enrollmentService.createToken({
-      grantId: grant.id,
-      peerId,
-      ttlSeconds: 900,
-    });
-
-    const csrPem = await generateCsrPem(`gateway-test-replay-${RUN_ID.slice(0, 8)}`);
-
-    // First redeem must succeed
-    const result = await enrollmentService.redeem(token, csrPem);
-    expect(result.certPem).toContain('-----BEGIN CERTIFICATE-----');
-
-    // Second redeem with the same token must be rejected
-    await expect(enrollmentService.redeem(token, csrPem)).rejects.toThrow(GoneException);
-  }, 30_000);
-});
@@ -1,150 +0,0 @@
-import { ForbiddenException, NotFoundException } from '@nestjs/common';
-import { describe, expect, it, vi } from 'vitest';
-import { ConversationsController } from '../conversations/conversations.controller.js';
-import { MissionsController } from '../missions/missions.controller.js';
-import { ProjectsController } from '../projects/projects.controller.js';
-import { TasksController } from '../tasks/tasks.controller.js';
-
-function createBrain() {
-  return {
-    conversations: {
-      findAll: vi.fn(),
-      findById: vi.fn(),
-      create: vi.fn(),
-      update: vi.fn(),
-      remove: vi.fn(),
-      findMessages: vi.fn(),
-      addMessage: vi.fn(),
-    },
-    projects: {
-      findAll: vi.fn(),
-      findAllForUser: vi.fn(),
-      findById: vi.fn(),
-      create: vi.fn(),
-      update: vi.fn(),
-      remove: vi.fn(),
-    },
-    missions: {
-      findAll: vi.fn(),
-      findAllByUser: vi.fn(),
-      findById: vi.fn(),
-      findByIdAndUser: vi.fn(),
-      findByProject: vi.fn(),
-      create: vi.fn(),
-      update: vi.fn(),
-      remove: vi.fn(),
-    },
-    missionTasks: {
-      findByMissionAndUser: vi.fn(),
-      findByIdAndUser: vi.fn(),
-      create: vi.fn(),
-      update: vi.fn(),
-      remove: vi.fn(),
-    },
-    tasks: {
-      findAll: vi.fn(),
-      findById: vi.fn(),
-      findByProject: vi.fn(),
-      findByMission: vi.fn(),
-      findByStatus: vi.fn(),
-      create: vi.fn(),
-      update: vi.fn(),
-      remove: vi.fn(),
-    },
-  };
-}
-
-describe('Resource ownership checks', () => {
-  it('forbids access to another user conversation', async () => {
-    const brain = createBrain();
-    // The repo enforces ownership via the WHERE clause; it returns undefined when the
-    // conversation does not belong to the requesting user.
-    brain.conversations.findById.mockResolvedValue(undefined);
-    const controller = new ConversationsController(brain as never);
-
-    await expect(controller.findOne('conv-1', { id: 'user-1' })).rejects.toBeInstanceOf(
-      NotFoundException,
-    );
-  });
-
-  it('forbids access to another user project', async () => {
-    const brain = createBrain();
-    brain.projects.findById.mockResolvedValue({ id: 'project-1', ownerId: 'user-2' });
-    const teamsService = { canAccessProject: vi.fn().mockResolvedValue(false) };
-    const controller = new ProjectsController(brain as never, teamsService as never);
-
-    await expect(controller.findOne('project-1', { id: 'user-1' })).rejects.toBeInstanceOf(
-      ForbiddenException,
-    );
-  });
-
-  it('forbids access to a mission owned by another user', async () => {
-    const brain = createBrain();
-    // findByIdAndUser returns undefined when the mission doesn't belong to the user
-    brain.missions.findByIdAndUser.mockResolvedValue(undefined);
-    const controller = new MissionsController(brain as never);
-
-    await expect(controller.findOne('mission-1', { id: 'user-1' })).rejects.toBeInstanceOf(
-      NotFoundException,
-    );
-  });
-
-  it('forbids access to a task owned by another project owner', async () => {
-    const brain = createBrain();
-    brain.tasks.findById.mockResolvedValue({ id: 'task-1', projectId: 'project-1' });
-    brain.projects.findById.mockResolvedValue({ id: 'project-1', ownerId: 'user-2' });
-    const controller = new TasksController(brain as never);
-
-    await expect(controller.findOne('task-1', { id: 'user-1' })).rejects.toBeInstanceOf(
-      ForbiddenException,
-    );
-  });
-
-  it('forbids creating a task with an unowned project', async () => {
-    const brain = createBrain();
-    brain.projects.findById.mockResolvedValue({ id: 'project-1', ownerId: 'user-2' });
-    const controller = new TasksController(brain as never);
-
-    await expect(
-      controller.create(
-        {
-          title: 'Task',
-          projectId: 'project-1',
-        },
-        { id: 'user-1' },
-      ),
-    ).rejects.toBeInstanceOf(ForbiddenException);
-  });
-
-  it('forbids listing tasks for an unowned project', async () => {
-    const brain = createBrain();
-    brain.projects.findById.mockResolvedValue({ id: 'project-1', ownerId: 'user-2' });
-    const controller = new TasksController(brain as never);
-
-    await expect(
-      controller.list({ id: 'user-1' }, 'project-1', undefined, undefined),
-    ).rejects.toBeInstanceOf(ForbiddenException);
-  });
-
-  it('lists only tasks for the current user owned projects when no filter is provided', async () => {
-    const brain = createBrain();
-    brain.projects.findAll.mockResolvedValue([
-      { id: 'project-1', ownerId: 'user-1' },
-      { id: 'project-2', ownerId: 'user-2' },
-    ]);
-    brain.missions.findAll.mockResolvedValue([{ id: 'mission-1', projectId: 'project-1' }]);
-    brain.tasks.findAll.mockResolvedValue([
-      { id: 'task-1', projectId: 'project-1' },
-      { id: 'task-2', missionId: 'mission-1' },
-      { id: 'task-3', projectId: 'project-2' },
-    ]);
-    const controller = new TasksController(brain as never);
-
-    await expect(
-      controller.list({ id: 'user-1' }, undefined, undefined, undefined),
-    ).resolves.toEqual([
-      { id: 'task-1', projectId: 'project-1' },
-      { id: 'task-2', missionId: 'mission-1' },
-    ]);
-  });
-});
@@ -1,377 +0,0 @@
-/**
- * M5-008: Session hardening verification tests.
- *
- * Verifies:
- * 1. /model command switches model → session:info reflects updated modelId
- * 2. /agent command switches agent config → system prompt / agentName changes
- * 3. Session resume binds to a conversation (history injected via conversationHistory option)
- * 4. Session metrics track token usage and message count correctly
- */
-
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import type {
-  AgentSession,
-  AgentSessionOptions,
-  ConversationHistoryMessage,
-} from '../agent/agent.service.js';
-import type { SessionInfoDto, SessionMetrics, SessionTokenMetrics } from '../agent/session.dto.js';
-
-// ---------------------------------------------------------------------------
-// Helpers — minimal AgentSession fixture
-// ---------------------------------------------------------------------------
-
-function makeMetrics(overrides?: Partial<SessionMetrics>): SessionMetrics {
-  return {
-    tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-    modelSwitches: 0,
-    messageCount: 0,
-    lastActivityAt: new Date().toISOString(),
-    ...overrides,
-  };
-}
-
-function makeSession(overrides?: Partial<AgentSession>): AgentSession {
-  return {
-    id: 'session-001',
-    provider: 'anthropic',
-    modelId: 'claude-3-5-sonnet-20241022',
-    piSession: {} as AgentSession['piSession'],
-    listeners: new Set(),
-    unsubscribe: vi.fn(),
-    createdAt: Date.now(),
-    promptCount: 0,
-    channels: new Set(),
-    skillPromptAdditions: [],
-    sandboxDir: '/tmp',
-    allowedTools: null,
-    metrics: makeMetrics(),
-    ...overrides,
-  };
-}
-
-function sessionToInfo(session: AgentSession): SessionInfoDto {
-  return {
-    id: session.id,
-    provider: session.provider,
-    modelId: session.modelId,
-    ...(session.agentName ? { agentName: session.agentName } : {}),
-    createdAt: new Date(session.createdAt).toISOString(),
-    promptCount: session.promptCount,
-    channels: Array.from(session.channels),
-    durationMs: Date.now() - session.createdAt,
-    metrics: { ...session.metrics },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Replicated AgentService methods (tested in isolation without full DI setup)
-// ---------------------------------------------------------------------------
-
-function updateSessionModel(session: AgentSession, modelId: string): void {
-  session.modelId = modelId;
-  session.metrics.modelSwitches += 1;
-  session.metrics.lastActivityAt = new Date().toISOString();
-}
-
-function applyAgentConfig(
-  session: AgentSession,
-  agentConfigId: string,
-  agentName: string,
-  modelId?: string,
-): void {
-  session.agentConfigId = agentConfigId;
-  session.agentName = agentName;
-  if (modelId) {
-    updateSessionModel(session, modelId);
-  }
-}
-
-function recordTokenUsage(session: AgentSession, tokens: SessionTokenMetrics): void {
-  session.metrics.tokens.input += tokens.input;
-  session.metrics.tokens.output += tokens.output;
-  session.metrics.tokens.cacheRead += tokens.cacheRead;
-  session.metrics.tokens.cacheWrite += tokens.cacheWrite;
-  session.metrics.tokens.total += tokens.total;
-  session.metrics.lastActivityAt = new Date().toISOString();
-}
-
-function recordMessage(session: AgentSession): void {
-  session.metrics.messageCount += 1;
-  session.metrics.lastActivityAt = new Date().toISOString();
-}
-
-// ---------------------------------------------------------------------------
-// 1. /model command — switches model → session:info updated
-// ---------------------------------------------------------------------------
-
-describe('/model command — model switch reflected in session:info', () => {
-  let session: AgentSession;
-
-  beforeEach(() => {
-    session = makeSession();
-  });
-
-  it('updates modelId when /model is called with a model name', () => {
-    updateSessionModel(session, 'claude-opus-4-5-20251001');
-
-    expect(session.modelId).toBe('claude-opus-4-5-20251001');
-  });
-
-  it('increments modelSwitches metric after /model command', () => {
-    expect(session.metrics.modelSwitches).toBe(0);
-
-    updateSessionModel(session, 'gpt-4o');
-    expect(session.metrics.modelSwitches).toBe(1);
-
-    updateSessionModel(session, 'claude-3-5-sonnet-20241022');
-    expect(session.metrics.modelSwitches).toBe(2);
-  });
-
-  it('session:info DTO reflects the new modelId after switch', () => {
-    updateSessionModel(session, 'claude-haiku-3-5-20251001');
-
-    const info = sessionToInfo(session);
-
-    expect(info.modelId).toBe('claude-haiku-3-5-20251001');
-    expect(info.metrics.modelSwitches).toBe(1);
-  });
-
-  it('lastActivityAt is updated after model switch', () => {
-    const before = session.metrics.lastActivityAt;
-    // Ensure at least 1ms passes
-    vi.setSystemTime(Date.now() + 1);
-    updateSessionModel(session, 'new-model');
-    vi.useRealTimers();
-
-    expect(session.metrics.lastActivityAt).not.toBe(before);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 2. /agent command — switches agent config → system prompt / agentName updated
-// ---------------------------------------------------------------------------
-
-describe('/agent command — agent config applied to session', () => {
-  let session: AgentSession;
-
-  beforeEach(() => {
-    session = makeSession();
-  });
-
-  it('sets agentConfigId and agentName on the session', () => {
-    applyAgentConfig(session, 'agent-uuid-001', 'CodeReviewer');
-
-    expect(session.agentConfigId).toBe('agent-uuid-001');
-    expect(session.agentName).toBe('CodeReviewer');
-  });
-
-  it('also updates modelId when agent config carries a model', () => {
-    applyAgentConfig(session, 'agent-uuid-002', 'DataAnalyst', 'gpt-4o-mini');
-
-    expect(session.agentName).toBe('DataAnalyst');
-    expect(session.modelId).toBe('gpt-4o-mini');
-    expect(session.metrics.modelSwitches).toBe(1);
-  });
-
-  it('does NOT update modelId when agent config has no model', () => {
-    const originalModel = session.modelId;
-    applyAgentConfig(session, 'agent-uuid-003', 'Planner', undefined);
-
-    expect(session.modelId).toBe(originalModel);
-    expect(session.metrics.modelSwitches).toBe(0);
-  });
-
-  it('session:info DTO reflects agentName after /agent switch', () => {
-    applyAgentConfig(session, 'agent-uuid-004', 'DevBot');
-
-    const info = sessionToInfo(session);
-
-    expect(info.agentName).toBe('DevBot');
-  });
-
-  it('multiple /agent calls update to the latest agent', () => {
-    applyAgentConfig(session, 'agent-001', 'FirstAgent');
-    applyAgentConfig(session, 'agent-002', 'SecondAgent');
-
-    expect(session.agentConfigId).toBe('agent-002');
-    expect(session.agentName).toBe('SecondAgent');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 3. Session resume — binds to conversation via conversationHistory
-// ---------------------------------------------------------------------------
-
-describe('Session resume — binds to conversation', () => {
-  it('conversationHistory option is preserved in session options', () => {
-    const history: ConversationHistoryMessage[] = [
-      {
-        role: 'user',
-        content: 'Hello, what is TypeScript?',
-        createdAt: new Date('2026-01-01T00:01:00Z'),
-      },
-      {
-        role: 'assistant',
-        content: 'TypeScript is a typed superset of JavaScript.',
-        createdAt: new Date('2026-01-01T00:01:05Z'),
-      },
-    ];
-
-    const options: AgentSessionOptions = {
-      conversationHistory: history,
-      provider: 'anthropic',
-      modelId: 'claude-3-5-sonnet-20241022',
-    };
-
-    expect(options.conversationHistory).toHaveLength(2);
-    expect(options.conversationHistory![0]!.role).toBe('user');
-    expect(options.conversationHistory![1]!.role).toBe('assistant');
-  });
-
-  it('session with conversationHistory option carries the conversation binding', () => {
-    const CONV_ID = 'conv-resume-001';
-    const history: ConversationHistoryMessage[] = [
-      { role: 'user', content: 'Prior question', createdAt: new Date('2026-01-01T00:01:00Z') },
-    ];
-
-    // Simulate what ChatGateway does: pass conversationId + history to createSession
-    const options: AgentSessionOptions = {
-      conversationHistory: history,
-    };
-
-    // The session ID is the conversationId in the gateway
-    const session = makeSession({ id: CONV_ID });
-
-    expect(session.id).toBe(CONV_ID);
-    expect(options.conversationHistory).toHaveLength(1);
-  });
-
-  it('empty conversationHistory is valid (new conversation)', () => {
-    const options: AgentSessionOptions = {
-      conversationHistory: [],
-    };
-
-    expect(options.conversationHistory).toHaveLength(0);
-  });
-
-  it('resumed session preserves all message roles', () => {
-    const history: ConversationHistoryMessage[] = [
-      { role: 'system', content: 'You are a helpful assistant.', createdAt: new Date() },
-      { role: 'user', content: 'Question 1', createdAt: new Date() },
-      { role: 'assistant', content: 'Answer 1', createdAt: new Date() },
-      { role: 'user', content: 'Question 2', createdAt: new Date() },
-    ];
-
-    const roles = history.map((m) => m.role);
-    expect(roles).toEqual(['system', 'user', 'assistant', 'user']);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 4. Session metrics — token usage and message count
-// ---------------------------------------------------------------------------
-
-describe('Session metrics — token usage and message count', () => {
-  let session: AgentSession;
-
-  beforeEach(() => {
-    session = makeSession();
-  });
-
-  it('starts with zero metrics', () => {
-    expect(session.metrics.tokens.input).toBe(0);
-    expect(session.metrics.tokens.output).toBe(0);
-    expect(session.metrics.tokens.total).toBe(0);
-    expect(session.metrics.messageCount).toBe(0);
-    expect(session.metrics.modelSwitches).toBe(0);
-  });
-
-  it('accumulates token usage across multiple turns', () => {
-    recordTokenUsage(session, {
-      input: 100,
-      output: 50,
-      cacheRead: 0,
-      cacheWrite: 0,
-      total: 150,
-    });
-    recordTokenUsage(session, {
-      input: 200,
-      output: 80,
-      cacheRead: 10,
-      cacheWrite: 5,
-      total: 295,
-    });
-
-    expect(session.metrics.tokens.input).toBe(300);
-    expect(session.metrics.tokens.output).toBe(130);
-    expect(session.metrics.tokens.cacheRead).toBe(10);
-    expect(session.metrics.tokens.cacheWrite).toBe(5);
-    expect(session.metrics.tokens.total).toBe(445);
-  });
-
-  it('increments message count with each recordMessage call', () => {
-    expect(session.metrics.messageCount).toBe(0);
-
-    recordMessage(session);
-    expect(session.metrics.messageCount).toBe(1);
-
-    recordMessage(session);
-    recordMessage(session);
-    expect(session.metrics.messageCount).toBe(3);
-  });
-
-  it('session:info DTO exposes correct metrics snapshot', () => {
-    recordTokenUsage(session, {
-      input: 500,
-      output: 100,
-      cacheRead: 20,
-      cacheWrite: 10,
-      total: 630,
-    });
-    recordMessage(session);
-    recordMessage(session);
-    updateSessionModel(session, 'claude-haiku-3-5-20251001');
-
-    const info = sessionToInfo(session);
-
-    expect(info.metrics.tokens.input).toBe(500);
-    expect(info.metrics.tokens.output).toBe(100);
-    expect(info.metrics.tokens.total).toBe(630);
-    expect(info.metrics.messageCount).toBe(2);
-    expect(info.metrics.modelSwitches).toBe(1);
-  });
-
-  it('metrics are independent per session', () => {
-    const sessionA = makeSession({ id: 'session-A' });
-    const sessionB = makeSession({ id: 'session-B' });
-
-    recordTokenUsage(sessionA, { input: 100, output: 50, cacheRead: 0, cacheWrite: 0, total: 150 });
-    recordMessage(sessionA);
-
-    // Session B should remain at zero
-    expect(sessionB.metrics.tokens.input).toBe(0);
-    expect(sessionB.metrics.messageCount).toBe(0);
-
-    // Session A should have updated values
-    expect(sessionA.metrics.tokens.input).toBe(100);
-    expect(sessionA.metrics.messageCount).toBe(1);
-  });
-
-  it('lastActivityAt is updated after recording tokens', () => {
-    const before = session.metrics.lastActivityAt;
-    vi.setSystemTime(new Date(Date.now() + 100));
-    recordTokenUsage(session, { input: 10, output: 5, cacheRead: 0, cacheWrite: 0, total: 15 });
-    vi.useRealTimers();
-
-    expect(session.metrics.lastActivityAt).not.toBe(before);
-  });
-
-  it('lastActivityAt is updated after recording a message', () => {
-    const before = session.metrics.lastActivityAt;
-    vi.setSystemTime(new Date(Date.now() + 100));
-    recordMessage(session);
-    vi.useRealTimers();
-
-    expect(session.metrics.lastActivityAt).not.toBe(before);
-  });
-});
@@ -1,86 +0,0 @@
-import { Controller, Get, Inject, Optional, UseGuards } from '@nestjs/common';
-import { sql, type Db } from '@mosaicstack/db';
-import { createQueue } from '@mosaicstack/queue';
-import type { MosaicConfig } from '@mosaicstack/config';
-import { DB } from '../database/database.module.js';
-import { AgentService } from '../agent/agent.service.js';
-import { ProviderService } from '../agent/provider.service.js';
-import { MOSAIC_CONFIG } from '../config/config.module.js';
-import { AdminGuard } from './admin.guard.js';
-import type { HealthStatusDto, ServiceStatusDto } from './admin.dto.js';
-
-@Controller('api/admin/health')
-@UseGuards(AdminGuard)
-export class AdminHealthController {
-  constructor(
-    @Inject(DB) private readonly db: Db,
-    @Inject(AgentService) private readonly agentService: AgentService,
-    @Inject(ProviderService) private readonly providerService: ProviderService,
-    @Optional()
-    @Inject(MOSAIC_CONFIG)
-    private readonly mosaicConfig: MosaicConfig | null,
-  ) {}
-
-  @Get()
-  async check(): Promise<HealthStatusDto> {
-    const [database, cache] = await Promise.all([this.checkDatabase(), this.checkCache()]);
-
-    const sessions = this.agentService.listSessions();
-    const providers = this.providerService.listProviders();
-
-    const allOk = database.status === 'ok' && cache.status === 'ok';
-
-    return {
-      status: allOk ? 'ok' : 'degraded',
-      database,
-      cache,
-      agentPool: { activeSessions: sessions.length },
-      providers: providers.map((p) => ({
-        id: p.id,
-        name: p.name,
-        available: p.available,
-        modelCount: p.models.length,
-      })),
-      checkedAt: new Date().toISOString(),
-    };
-  }
-
-  private async checkDatabase(): Promise<ServiceStatusDto> {
-    const start = Date.now();
-    try {
-      await this.db.execute(sql`SELECT 1`);
-      return { status: 'ok', latencyMs: Date.now() - start };
-    } catch (err) {
-      return {
-        status: 'error',
-        latencyMs: Date.now() - start,
-        error: err instanceof Error ? err.message : String(err),
-      };
-    }
-  }
-
-  private async checkCache(): Promise<ServiceStatusDto> {
-    // On Local tier there is no Redis. The cache is intentionally absent, which
-    // is a healthy state for this tier — report 'ok' rather than opening a new
-    // ioredis connection on every admin health check (which would spam
-    // ECONNREFUSED and create/destroy a connection per request). latencyMs 0
-    // signals "no cache backend to measure" for this tier.
-    if (this.mosaicConfig?.queue?.type === 'local') {
-      return { status: 'ok', latencyMs: 0 };
-    }
-    const start = Date.now();
-    const handle = createQueue();
-    try {
-      await handle.redis.ping();
-      return { status: 'ok', latencyMs: Date.now() - start };
-    } catch (err) {
-      return {
-        status: 'error',
-        latencyMs: Date.now() - start,
-        error: err instanceof Error ? err.message : String(err),
-      };
-    } finally {
-      await handle.close().catch(() => {});
-    }
-  }
-}
@@ -1,128 +0,0 @@
-import {
-  Controller,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  NotFoundException,
-  Optional,
-  Param,
-  Post,
-  Query,
-  UseGuards,
-} from '@nestjs/common';
-import { AdminGuard } from './admin.guard.js';
-import { QueueService } from '../queue/queue.service.js';
-import type { JobDto, JobListDto, JobStatus, QueueListDto } from '../queue/queue-admin.dto.js';
-
-@Controller('api/admin/jobs')
-@UseGuards(AdminGuard)
-export class AdminJobsController {
-  constructor(
-    @Optional()
-    @Inject(QueueService)
-    private readonly queueService: QueueService | null,
-  ) {}
-
-  /**
-   * GET /api/admin/jobs
-   * List jobs across all queues. Optional ?status=active|completed|failed|waiting|delayed
-   */
-  @Get()
-  async listJobs(@Query('status') status?: string): Promise<JobListDto> {
-    if (!this.queueService) {
-      return { jobs: [], total: 0 };
-    }
-
-    const validStatuses: JobStatus[] = ['active', 'completed', 'failed', 'waiting', 'delayed'];
-    const normalised = status as JobStatus | undefined;
-
-    if (normalised && !validStatuses.includes(normalised)) {
-      return { jobs: [], total: 0 };
-    }
-
-    const jobs: JobDto[] = await this.queueService.listJobs(normalised);
-    return { jobs, total: jobs.length };
-  }
-
-  /**
-   * POST /api/admin/jobs/:id/retry
-   * Retry a specific failed job.  The id is "<queue>__<bullmq-job-id>".
-   */
-  @Post(':id/retry')
-  @HttpCode(HttpStatus.OK)
-  async retryJob(@Param('id') id: string): Promise<{ ok: boolean; message: string }> {
-    if (!this.queueService) {
-      throw new NotFoundException('Queue service is not available');
-    }
-
-    const result = await this.queueService.retryJob(id);
-    if (!result.ok) {
-      throw new NotFoundException(result.message);
-    }
-
-    return result;
-  }
-
-  /**
-   * GET /api/admin/jobs/queues
-   * Return status for all managed queues.
-   */
-  @Get('queues')
-  async listQueues(): Promise<QueueListDto> {
-    if (!this.queueService) {
-      return { queues: [] };
-    }
-
-    const health = await this.queueService.getHealthStatus();
-    const queues = Object.entries(health.queues).map(([name, stats]) => ({
-      name,
-      waiting: stats.waiting,
-      active: stats.active,
-      completed: stats.completed,
-      failed: stats.failed,
-      delayed: 0,
-      paused: stats.paused,
-    }));
-
-    return { queues };
-  }
-
-  /**
-   * POST /api/admin/jobs/queues/:name/pause
-   * Pause the named queue.
-   */
-  @Post('queues/:name/pause')
-  @HttpCode(HttpStatus.OK)
-  async pauseQueue(@Param('name') name: string): Promise<{ ok: boolean; message: string }> {
-    if (!this.queueService) {
-      throw new NotFoundException('Queue service is not available');
-    }
-
-    const result = await this.queueService.pauseQueue(name);
-    if (!result.ok) {
-      throw new NotFoundException(result.message);
-    }
-
-    return result;
-  }
-
-  /**
-   * POST /api/admin/jobs/queues/:name/resume
-   * Resume the named queue.
-   */
-  @Post('queues/:name/resume')
-  @HttpCode(HttpStatus.OK)
-  async resumeQueue(@Param('name') name: string): Promise<{ ok: boolean; message: string }> {
-    if (!this.queueService) {
-      throw new NotFoundException('Queue service is not available');
-    }
-
-    const result = await this.queueService.resumeQueue(name);
-    if (!result.ok) {
-      throw new NotFoundException(result.message);
-    }
-
-    return result;
-  }
-}
@@ -1,90 +0,0 @@
-import {
-  Body,
-  Controller,
-  Delete,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  Param,
-  Post,
-  UseGuards,
-} from '@nestjs/common';
-import { randomBytes, createHash } from 'node:crypto';
-import { eq, type Db, adminTokens } from '@mosaicstack/db';
-import { v4 as uuid } from 'uuid';
-import { DB } from '../database/database.module.js';
-import { AdminGuard } from './admin.guard.js';
-import { CurrentUser } from '../auth/current-user.decorator.js';
-import type {
-  CreateTokenDto,
-  TokenCreatedDto,
-  TokenDto,
-  TokenListDto,
-} from './admin-tokens.dto.js';
-
-function hashToken(plaintext: string): string {
-  return createHash('sha256').update(plaintext).digest('hex');
-}
-
-function toTokenDto(row: typeof adminTokens.$inferSelect): TokenDto {
-  return {
-    id: row.id,
-    label: row.label,
-    scope: row.scope,
-    expiresAt: row.expiresAt?.toISOString() ?? null,
-    lastUsedAt: row.lastUsedAt?.toISOString() ?? null,
-    createdAt: row.createdAt.toISOString(),
-  };
-}
-
-@Controller('api/admin/tokens')
-@UseGuards(AdminGuard)
-export class AdminTokensController {
-  constructor(@Inject(DB) private readonly db: Db) {}
-
-  @Post()
-  async create(
-    @Body() dto: CreateTokenDto,
-    @CurrentUser() user: { id: string },
-  ): Promise<TokenCreatedDto> {
-    const plaintext = randomBytes(32).toString('hex');
-    const tokenHash = hashToken(plaintext);
-    const id = uuid();
-
-    const expiresAt = dto.expiresInDays
-      ? new Date(Date.now() + dto.expiresInDays * 24 * 60 * 60 * 1000)
-      : null;
-
-    const [row] = await this.db
-      .insert(adminTokens)
-      .values({
-        id,
-        userId: user.id,
-        tokenHash,
-        label: dto.label ?? 'CLI token',
-        scope: dto.scope ?? 'admin',
-        expiresAt,
-      })
-      .returning();
-
-    return { ...toTokenDto(row!), plaintext };
-  }
-
-  @Get()
-  async list(@CurrentUser() user: { id: string }): Promise<TokenListDto> {
-    const rows = await this.db
-      .select()
-      .from(adminTokens)
-      .where(eq(adminTokens.userId, user.id))
-      .orderBy(adminTokens.createdAt);
-
-    return { tokens: rows.map(toTokenDto), total: rows.length };
-  }
-
-  @Delete(':id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  async revoke(@Param('id') id: string, @CurrentUser() _user: { id: string }): Promise<void> {
-    await this.db.delete(adminTokens).where(eq(adminTokens.id, id));
-  }
-}
@@ -1,33 +0,0 @@
-import { IsString, IsOptional, IsInt, Min } from 'class-validator';
-
-export class CreateTokenDto {
-  @IsString()
-  label!: string;
-
-  @IsOptional()
-  @IsString()
-  scope?: string;
-
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  expiresInDays?: number;
-}
-
-export interface TokenDto {
-  id: string;
-  label: string;
-  scope: string;
-  expiresAt: string | null;
-  lastUsedAt: string | null;
-  createdAt: string;
-}
-
-export interface TokenCreatedDto extends TokenDto {
-  plaintext: string;
-}
-
-export interface TokenListDto {
-  tokens: TokenDto[];
-  total: number;
-}
@@ -1,146 +0,0 @@
-import {
-  Body,
-  Controller,
-  Delete,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  InternalServerErrorException,
-  NotFoundException,
-  Param,
-  Patch,
-  Post,
-  UseGuards,
-} from '@nestjs/common';
-import { eq, type Db, users as usersTable } from '@mosaicstack/db';
-import type { Auth } from '@mosaicstack/auth';
-import { AUTH } from '../auth/auth.tokens.js';
-import { DB } from '../database/database.module.js';
-import { AdminGuard } from './admin.guard.js';
-import type {
-  BanUserDto,
-  CreateUserDto,
-  UpdateUserRoleDto,
-  UserDto,
-  UserListDto,
-} from './admin.dto.js';
-
-type UserRow = typeof usersTable.$inferSelect;
-
-function toUserDto(u: UserRow): UserDto {
-  return {
-    id: u.id,
-    name: u.name,
-    email: u.email,
-    role: u.role,
-    banned: u.banned ?? false,
-    banReason: u.banReason ?? null,
-    createdAt: u.createdAt.toISOString(),
-    updatedAt: u.updatedAt.toISOString(),
-  };
-}
-
-async function requireUpdated(
-  db: Db,
-  id: string,
-  update: Partial<Omit<UserRow, 'id' | 'createdAt'>>,
-): Promise<UserDto> {
-  const [updated] = await db
-    .update(usersTable)
-    .set({ ...update, updatedAt: new Date() })
-    .where(eq(usersTable.id, id))
-    .returning();
-  if (!updated) throw new InternalServerErrorException('Update returned no rows');
-  return toUserDto(updated);
-}
-
-@Controller('api/admin/users')
-@UseGuards(AdminGuard)
-export class AdminController {
-  constructor(
-    @Inject(DB) private readonly db: Db,
-    @Inject(AUTH) private readonly auth: Auth,
-  ) {}
-
-  @Get()
-  async listUsers(): Promise<UserListDto> {
-    const rows = await this.db.select().from(usersTable).orderBy(usersTable.createdAt);
-    const userList: UserDto[] = rows.map(toUserDto);
-    return { users: userList, total: userList.length };
-  }
-
-  @Get(':id')
-  async getUser(@Param('id') id: string): Promise<UserDto> {
-    const [user] = await this.db.select().from(usersTable).where(eq(usersTable.id, id)).limit(1);
-    if (!user) throw new NotFoundException('User not found');
-    return toUserDto(user);
-  }
-
-  @Post()
-  async createUser(@Body() body: CreateUserDto): Promise<UserDto> {
-    // Use auth API to create user so password is properly hashed
-    const authApi = this.auth.api as unknown as {
-      createUser: (opts: {
-        body: { name: string; email: string; password: string; role?: string };
-      }) => Promise<{
-        user: { id: string; name: string; email: string; createdAt: unknown; updatedAt: unknown };
-      }>;
-    };
-
-    const result = await authApi.createUser({
-      body: {
-        name: body.name,
-        email: body.email,
-        password: body.password,
-        role: body.role ?? 'member',
-      },
-    });
-
-    // Re-fetch from DB to get full row with our schema
-    const [user] = await this.db
-      .select()
-      .from(usersTable)
-      .where(eq(usersTable.id, result.user.id))
-      .limit(1);
-
-    if (!user) throw new InternalServerErrorException('User created but not found in DB');
-    return toUserDto(user);
-  }
-
-  @Patch(':id/role')
-  async setRole(@Param('id') id: string, @Body() body: UpdateUserRoleDto): Promise<UserDto> {
-    await this.ensureExists(id);
-    return requireUpdated(this.db, id, { role: body.role });
-  }
-
-  @Post(':id/ban')
-  @HttpCode(HttpStatus.OK)
-  async banUser(@Param('id') id: string, @Body() body: BanUserDto): Promise<UserDto> {
-    await this.ensureExists(id);
-    return requireUpdated(this.db, id, { banned: true, banReason: body.reason ?? null });
-  }
-
-  @Post(':id/unban')
-  @HttpCode(HttpStatus.OK)
-  async unbanUser(@Param('id') id: string): Promise<UserDto> {
-    await this.ensureExists(id);
-    return requireUpdated(this.db, id, { banned: false, banReason: null, banExpires: null });
-  }
-
-  @Delete(':id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  async deleteUser(@Param('id') id: string): Promise<void> {
-    await this.ensureExists(id);
-    await this.db.delete(usersTable).where(eq(usersTable.id, id));
-  }
-
-  private async ensureExists(id: string): Promise<void> {
-    const [existing] = await this.db
-      .select({ id: usersTable.id })
-      .from(usersTable)
-      .where(eq(usersTable.id, id))
-      .limit(1);
-    if (!existing) throw new NotFoundException('User not found');
-  }
-}
@@ -1,56 +0,0 @@
-export interface UserDto {
-  id: string;
-  name: string;
-  email: string;
-  role: string;
-  banned: boolean;
-  banReason: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface UserListDto {
-  users: UserDto[];
-  total: number;
-}
-
-export interface CreateUserDto {
-  name: string;
-  email: string;
-  password: string;
-  role?: string;
-}
-
-export interface UpdateUserRoleDto {
-  role: string;
-}
-
-export interface BanUserDto {
-  reason?: string;
-}
-
-export interface HealthStatusDto {
-  status: 'ok' | 'degraded' | 'error';
-  database: ServiceStatusDto;
-  cache: ServiceStatusDto;
-  agentPool: AgentPoolStatusDto;
-  providers: ProviderStatusDto[];
-  checkedAt: string;
-}
-
-export interface ServiceStatusDto {
-  status: 'ok' | 'error';
-  latencyMs?: number;
-  error?: string;
-}
-
-export interface AgentPoolStatusDto {
-  activeSessions: number;
-}
-
-export interface ProviderStatusDto {
-  id: string;
-  name: string;
-  available: boolean;
-  modelCount: number;
-}
@@ -1,121 +0,0 @@
-import {
-  CanActivate,
-  ExecutionContext,
-  ForbiddenException,
-  Inject,
-  Injectable,
-  UnauthorizedException,
-} from '@nestjs/common';
-import { createHash } from 'node:crypto';
-import { fromNodeHeaders } from 'better-auth/node';
-import type { Auth } from '@mosaicstack/auth';
-import type { Db } from '@mosaicstack/db';
-import { eq, adminTokens, users as usersTable } from '@mosaicstack/db';
-import type { FastifyRequest } from 'fastify';
-import { AUTH } from '../auth/auth.tokens.js';
-import { DB } from '../database/database.module.js';
-
-interface UserWithRole {
-  id: string;
-  role?: string;
-}
-
-type AuthenticatedRequest = FastifyRequest & { user: unknown; session: unknown };
-
-@Injectable()
-export class AdminGuard implements CanActivate {
-  constructor(
-    @Inject(AUTH) private readonly auth: Auth,
-    @Inject(DB) private readonly db: Db,
-  ) {}
-
-  async canActivate(context: ExecutionContext): Promise<boolean> {
-    const request = context.switchToHttp().getRequest<FastifyRequest>();
-
-    // Try bearer token auth first
-    const authHeader = request.raw.headers['authorization'];
-    if (authHeader?.startsWith('Bearer ')) {
-      return this.validateBearerToken(request, authHeader.slice(7));
-    }
-
-    // Fall back to BetterAuth session
-    return this.validateSession(request);
-  }
-
-  private async validateBearerToken(request: FastifyRequest, plaintext: string): Promise<boolean> {
-    const tokenHash = createHash('sha256').update(plaintext).digest('hex');
-
-    const [row] = await this.db
-      .select({
-        tokenId: adminTokens.id,
-        userId: adminTokens.userId,
-        scope: adminTokens.scope,
-        expiresAt: adminTokens.expiresAt,
-        userName: usersTable.name,
-        userEmail: usersTable.email,
-        userRole: usersTable.role,
-      })
-      .from(adminTokens)
-      .innerJoin(usersTable, eq(adminTokens.userId, usersTable.id))
-      .where(eq(adminTokens.tokenHash, tokenHash))
-      .limit(1);
-
-    if (!row) {
-      throw new UnauthorizedException('Invalid API token');
-    }
-
-    if (row.expiresAt && row.expiresAt < new Date()) {
-      throw new UnauthorizedException('API token expired');
-    }
-
-    if (row.userRole !== 'admin') {
-      throw new ForbiddenException('Admin access required');
-    }
-
-    // Update last-used timestamp (fire-and-forget)
-    this.db
-      .update(adminTokens)
-      .set({ lastUsedAt: new Date() })
-      .where(eq(adminTokens.id, row.tokenId))
-      .then(() => {})
-      .catch(() => {});
-
-    const req = request as AuthenticatedRequest;
-    req.user = { id: row.userId, name: row.userName, email: row.userEmail, role: row.userRole };
-    req.session = { id: `token:${row.tokenId}`, userId: row.userId };
-
-    return true;
-  }
-
-  private async validateSession(request: FastifyRequest): Promise<boolean> {
-    const headers = fromNodeHeaders(request.raw.headers);
-    const result = await this.auth.api.getSession({ headers });
-
-    if (!result) {
-      throw new UnauthorizedException('Invalid or expired session');
-    }
-
-    const user = result.user as UserWithRole;
-
-    let userRole = user.role;
-    if (!userRole) {
-      const [dbUser] = await this.db
-        .select({ role: usersTable.role })
-        .from(usersTable)
-        .where(eq(usersTable.id, user.id))
-        .limit(1);
-      userRole = dbUser?.role ?? 'member';
-      (user as UserWithRole).role = userRole;
-    }
-
-    if (userRole !== 'admin') {
-      throw new ForbiddenException('Admin access required');
-    }
-
-    const req = request as AuthenticatedRequest;
-    req.user = result.user;
-    req.session = result.session;
-
-    return true;
-  }
-}
@@ -1,19 +0,0 @@
-import { Module } from '@nestjs/common';
-import { AdminController } from './admin.controller.js';
-import { AdminHealthController } from './admin-health.controller.js';
-import { AdminJobsController } from './admin-jobs.controller.js';
-import { AdminTokensController } from './admin-tokens.controller.js';
-import { BootstrapController } from './bootstrap.controller.js';
-import { AdminGuard } from './admin.guard.js';
-
-@Module({
-  controllers: [
-    AdminController,
-    AdminHealthController,
-    AdminJobsController,
-    AdminTokensController,
-    BootstrapController,
-  ],
-  providers: [AdminGuard],
-})
-export class AdminModule {}
@@ -1,102 +0,0 @@
-import {
-  Body,
-  Controller,
-  ForbiddenException,
-  Get,
-  Inject,
-  InternalServerErrorException,
-  Post,
-} from '@nestjs/common';
-import { randomBytes, createHash } from 'node:crypto';
-import { count, eq, type Db, users as usersTable, adminTokens } from '@mosaicstack/db';
-import type { Auth } from '@mosaicstack/auth';
-import { v4 as uuid } from 'uuid';
-import { AUTH } from '../auth/auth.tokens.js';
-import { DB } from '../database/database.module.js';
-import { BootstrapSetupDto } from './bootstrap.dto.js';
-import type { BootstrapStatusDto, BootstrapResultDto } from './bootstrap.dto.js';
-
-@Controller('api/bootstrap')
-export class BootstrapController {
-  constructor(
-    @Inject(AUTH) private readonly auth: Auth,
-    @Inject(DB) private readonly db: Db,
-  ) {}
-
-  @Get('status')
-  async status(): Promise<BootstrapStatusDto> {
-    const [result] = await this.db.select({ total: count() }).from(usersTable);
-    return { needsSetup: (result?.total ?? 0) === 0 };
-  }
-
-  @Post('setup')
-  async setup(@Body() dto: BootstrapSetupDto): Promise<BootstrapResultDto> {
-    // Only allow setup when zero users exist
-    const [result] = await this.db.select({ total: count() }).from(usersTable);
-    if ((result?.total ?? 0) > 0) {
-      throw new ForbiddenException('Setup already completed — users exist');
-    }
-
-    // Create admin user via BetterAuth API
-    const authApi = this.auth.api as unknown as {
-      createUser: (opts: {
-        body: { name: string; email: string; password: string; role?: string };
-      }) => Promise<{
-        user: { id: string; name: string; email: string };
-      }>;
-    };
-
-    const created = await authApi.createUser({
-      body: {
-        name: dto.name,
-        email: dto.email,
-        password: dto.password,
-        role: 'admin',
-      },
-    });
-
-    // Verify user was created
-    const [user] = await this.db
-      .select()
-      .from(usersTable)
-      .where(eq(usersTable.id, created.user.id))
-      .limit(1);
-
-    if (!user) throw new InternalServerErrorException('User created but not found');
-
-    // Ensure role is admin (createUser may not set it via BetterAuth)
-    if (user.role !== 'admin') {
-      await this.db.update(usersTable).set({ role: 'admin' }).where(eq(usersTable.id, user.id));
-    }
-
-    // Generate admin API token
-    const plaintext = randomBytes(32).toString('hex');
-    const tokenHash = createHash('sha256').update(plaintext).digest('hex');
-    const tokenId = uuid();
-
-    const [token] = await this.db
-      .insert(adminTokens)
-      .values({
-        id: tokenId,
-        userId: user.id,
-        tokenHash,
-        label: 'Initial setup token',
-        scope: 'admin',
-      })
-      .returning();
-
-    return {
-      user: {
-        id: user.id,
-        name: user.name,
-        email: user.email,
-        role: 'admin',
-      },
-      token: {
-        id: token!.id,
-        plaintext,
-        label: token!.label,
-      },
-    };
-  }
-}
@@ -1,31 +0,0 @@
-import { IsString, IsEmail, MinLength } from 'class-validator';
-
-export class BootstrapSetupDto {
-  @IsString()
-  name!: string;
-
-  @IsEmail()
-  email!: string;
-
-  @IsString()
-  @MinLength(8)
-  password!: string;
-}
-
-export interface BootstrapStatusDto {
-  needsSetup: boolean;
-}
-
-export interface BootstrapResultDto {
-  user: {
-    id: string;
-    name: string;
-    email: string;
-    role: string;
-  };
-  token: {
-    id: string;
-    plaintext: string;
-    label: string;
-  };
-}
@@ -1,190 +0,0 @@
-/**
- * E2E integration test — POST /api/bootstrap/setup
- *
- * Regression guard for the `import type { BootstrapSetupDto }` class-erasure
- * bug (IUV-M01, issue #436).
- *
- * When `BootstrapSetupDto` is imported with `import type`, TypeScript erases
- * the class at compile time. NestJS then sees `Object` as the `@Body()`
- * metatype, and ValidationPipe with `whitelist:true + forbidNonWhitelisted:true`
- * treats every property as non-whitelisted, returning:
- *
- *   400 { message: ["property email should not exist", "property password should not exist"] }
- *
- * The fix is a plain value import (`import { BootstrapSetupDto }`), which
- * preserves the class reference so Nest can read the class-validator decorators.
- *
- * This test MUST fail if `import type` is re-introduced on `BootstrapSetupDto`.
- * A controller unit test that constructs ValidationPipe manually won't catch
- * this — only the real DI binding path exercises the metatype lookup.
- */
-
-import 'reflect-metadata';
-import { describe, it, expect, afterAll, beforeAll } from 'vitest';
-import { Test } from '@nestjs/testing';
-import { ValidationPipe, type INestApplication } from '@nestjs/common';
-import { FastifyAdapter, type NestFastifyApplication } from '@nestjs/platform-fastify';
-import request from 'supertest';
-import { BootstrapController } from './bootstrap.controller.js';
-import type { BootstrapResultDto } from './bootstrap.dto.js';
-
-// ─── Minimal mock dependencies ───────────────────────────────────────────────
-
-/**
- * We use explicit `@Inject(AUTH)` / `@Inject(DB)` in the controller so we
- * can provide mock values by token without spinning up the real DB or Auth.
- */
-import { AUTH } from '../auth/auth.tokens.js';
-import { DB } from '../database/database.module.js';
-
-const MOCK_USER_ID = 'mock-user-id-001';
-
-const mockAuth = {
-  api: {
-    createUser: () =>
-      Promise.resolve({
-        user: {
-          id: MOCK_USER_ID,
-          name: 'Admin',
-          email: '[email protected]',
-        },
-      }),
-  },
-};
-
-// Override db.select() so the second query (verify user exists) returns a user.
-// The bootstrap controller calls select().from() twice:
-//   1. count() to check zero users  → returns [{total: 0}]
-//   2. select().where().limit()     → returns [the created user]
-let selectCallCount = 0;
-const mockDbWithUser = {
-  select: () => {
-    selectCallCount++;
-    return {
-      from: () => {
-        if (selectCallCount === 1) {
-          // First call: count — zero users
-          return Promise.resolve([{ total: 0 }]);
-        }
-        // Subsequent calls: return a mock user row
-        return {
-          where: () => ({
-            limit: () =>
-              Promise.resolve([
-                {
-                  id: MOCK_USER_ID,
-                  name: 'Admin',
-                  email: '[email protected]',
-                  role: 'admin',
-                },
-              ]),
-          }),
-        };
-      },
-    };
-  },
-  update: () => ({
-    set: () => ({
-      where: () => Promise.resolve([]),
-    }),
-  }),
-  insert: () => ({
-    values: () => ({
-      returning: () =>
-        Promise.resolve([
-          {
-            id: 'token-id-001',
-            label: 'Initial setup token',
-          },
-        ]),
-    }),
-  }),
-};
-
-// ─── Test suite ───────────────────────────────────────────────────────────────
-
-describe('POST /api/bootstrap/setup — ValidationPipe DTO binding', () => {
-  let app: INestApplication;
-
-  beforeAll(async () => {
-    selectCallCount = 0;
-
-    const moduleRef = await Test.createTestingModule({
-      controllers: [BootstrapController],
-      providers: [
-        { provide: AUTH, useValue: mockAuth },
-        { provide: DB, useValue: mockDbWithUser },
-      ],
-    }).compile();
-
-    app = moduleRef.createNestApplication<NestFastifyApplication>(new FastifyAdapter());
-
-    // Mirror main.ts configuration exactly — this is what reproduced the 400.
-    app.useGlobalPipes(
-      new ValidationPipe({
-        whitelist: true,
-        forbidNonWhitelisted: true,
-        transform: true,
-      }),
-    );
-
-    await app.init();
-    // Fastify requires waiting for the adapter to be ready
-    await app.getHttpAdapter().getInstance().ready();
-  });
-
-  afterAll(async () => {
-    await app.close();
-  });
-
-  it('returns 201 (not 400) when a valid {name, email, password} body is sent', async () => {
-    const res = await request(app.getHttpServer())
-      .post('/api/bootstrap/setup')
-      .send({ name: 'Admin', email: '[email protected]', password: 'password123' })
-      .set('Content-Type', 'application/json');
-
-    // Before the fix (import type), Nest ValidationPipe returned 400 with
-    // "property email should not exist" / "property password should not exist"
-    // because the DTO class was erased and every field looked non-whitelisted.
-    expect(res.status).not.toBe(400);
-    expect(res.status).toBe(201);
-    const body = res.body as BootstrapResultDto;
-    expect(body.user).toBeDefined();
-    expect(body.user.email).toBe('[email protected]');
-    expect(body.token).toBeDefined();
-    expect(body.token.plaintext).toBeDefined();
-  });
-
-  it('returns 400 when extra forbidden properties are sent', async () => {
-    // This proves ValidationPipe IS active and working (forbidNonWhitelisted).
-    const res = await request(app.getHttpServer())
-      .post('/api/bootstrap/setup')
-      .send({
-        name: 'Admin',
-        email: '[email protected]',
-        password: 'password123',
-        extraField: 'should-be-rejected',
-      })
-      .set('Content-Type', 'application/json');
-
-    expect(res.status).toBe(400);
-  });
-
-  it('returns 400 when email is invalid', async () => {
-    const res = await request(app.getHttpServer())
-      .post('/api/bootstrap/setup')
-      .send({ name: 'Admin', email: 'not-an-email', password: 'password123' })
-      .set('Content-Type', 'application/json');
-
-    expect(res.status).toBe(400);
-  });
-
-  it('returns 400 when password is too short', async () => {
-    const res = await request(app.getHttpServer())
-      .post('/api/bootstrap/setup')
-      .send({ name: 'Admin', email: '[email protected]', password: 'short' })
-      .set('Content-Type', 'application/json');
-
-    expect(res.status).toBe(400);
-  });
-});
@@ -1,770 +0,0 @@
-/**
- * Provider Adapter Integration Tests — M3-012
- *
- * Verifies that all five provider adapters (Anthropic, OpenAI, OpenRouter, Z.ai, Ollama)
- * are properly integrated: registration, model listing, graceful degradation without
- * API keys, capability matrix correctness, and ProviderCredentialsService behaviour.
- *
- * These tests are designed to run in CI with no real API keys; they test graceful
- * degradation and static configuration rather than live network calls.
- */
-
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { ModelRegistry, AuthStorage } from '@mariozechner/pi-coding-agent';
-import { AnthropicAdapter } from '../adapters/anthropic.adapter.js';
-import { OpenAIAdapter } from '../adapters/openai.adapter.js';
-import { OpenRouterAdapter } from '../adapters/openrouter.adapter.js';
-import { ZaiAdapter } from '../adapters/zai.adapter.js';
-import { OllamaAdapter } from '../adapters/ollama.adapter.js';
-import { ProviderService } from '../provider.service.js';
-import {
-  getModelCapability,
-  MODEL_CAPABILITIES,
-  findModelsByCapability,
-} from '../model-capabilities.js';
-
-// ---------------------------------------------------------------------------
-// Environment helpers
-// ---------------------------------------------------------------------------
-
-const ALL_PROVIDER_KEYS = [
-  'ANTHROPIC_API_KEY',
-  'OPENAI_API_KEY',
-  'OPENROUTER_API_KEY',
-  'ZAI_API_KEY',
-  'ZAI_BASE_URL',
-  'OLLAMA_BASE_URL',
-  'OLLAMA_HOST',
-  'OLLAMA_MODELS',
-  'BETTER_AUTH_SECRET',
-] as const;
-
-type EnvKey = (typeof ALL_PROVIDER_KEYS)[number];
-
-function saveAndClearEnv(): Map<EnvKey, string | undefined> {
-  const saved = new Map<EnvKey, string | undefined>();
-  for (const key of ALL_PROVIDER_KEYS) {
-    saved.set(key, process.env[key]);
-    delete process.env[key];
-  }
-  return saved;
-}
-
-function restoreEnv(saved: Map<EnvKey, string | undefined>): void {
-  for (const key of ALL_PROVIDER_KEYS) {
-    const value = saved.get(key);
-    if (value === undefined) {
-      delete process.env[key];
-    } else {
-      process.env[key] = value;
-    }
-  }
-}
-
-function makeRegistry(): ModelRegistry {
-  return ModelRegistry.inMemory(AuthStorage.inMemory());
-}
-
-// ---------------------------------------------------------------------------
-// 1. Adapter registration tests
-// ---------------------------------------------------------------------------
-
-describe('AnthropicAdapter', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  it('skips registration gracefully when ANTHROPIC_API_KEY is missing', async () => {
-    const adapter = new AnthropicAdapter(makeRegistry());
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('registers and listModels returns expected models when ANTHROPIC_API_KEY is set', async () => {
-    process.env['ANTHROPIC_API_KEY'] = 'sk-ant-test';
-    const adapter = new AnthropicAdapter(makeRegistry());
-    await adapter.register();
-
-    const models = adapter.listModels();
-    expect(models.length).toBeGreaterThan(0);
-
-    const ids = models.map((m) => m.id);
-    expect(ids).toContain('claude-opus-4-6');
-    expect(ids).toContain('claude-sonnet-4-6');
-    expect(ids).toContain('claude-haiku-4-5');
-
-    for (const model of models) {
-      expect(model.provider).toBe('anthropic');
-      expect(model.contextWindow).toBe(200000);
-    }
-  });
-
-  it('healthCheck returns down with error when ANTHROPIC_API_KEY is missing', async () => {
-    const adapter = new AnthropicAdapter(makeRegistry());
-    const health = await adapter.healthCheck();
-    expect(health.status).toBe('down');
-    expect(health.error).toMatch(/ANTHROPIC_API_KEY/);
-    expect(health.lastChecked).toBeTruthy();
-  });
-
-  it('adapter name is "anthropic"', () => {
-    expect(new AnthropicAdapter(makeRegistry()).name).toBe('anthropic');
-  });
-});
-
-describe('OpenAIAdapter', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  it('skips registration gracefully when OPENAI_API_KEY is missing', async () => {
-    const adapter = new OpenAIAdapter(makeRegistry());
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('registers and listModels returns Codex model when OPENAI_API_KEY is set', async () => {
-    process.env['OPENAI_API_KEY'] = 'sk-openai-test';
-    const adapter = new OpenAIAdapter(makeRegistry());
-    await adapter.register();
-
-    const models = adapter.listModels();
-    expect(models.length).toBeGreaterThan(0);
-
-    const ids = models.map((m) => m.id);
-    expect(ids).toContain(OpenAIAdapter.CODEX_MODEL_ID);
-
-    const codex = models.find((m) => m.id === OpenAIAdapter.CODEX_MODEL_ID)!;
-    expect(codex.provider).toBe('openai');
-    expect(codex.contextWindow).toBe(128_000);
-    expect(codex.maxTokens).toBe(16_384);
-  });
-
-  it('healthCheck returns down with error when OPENAI_API_KEY is missing', async () => {
-    const adapter = new OpenAIAdapter(makeRegistry());
-    const health = await adapter.healthCheck();
-    expect(health.status).toBe('down');
-    expect(health.error).toMatch(/OPENAI_API_KEY/);
-  });
-
-  it('adapter name is "openai"', () => {
-    expect(new OpenAIAdapter(makeRegistry()).name).toBe('openai');
-  });
-});
-
-describe('OpenRouterAdapter', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-    // Prevent real network calls during registration — stub global fetch
-    vi.stubGlobal(
-      'fetch',
-      vi.fn().mockResolvedValue({
-        ok: true,
-        json: () =>
-          Promise.resolve({
-            data: [
-              {
-                id: 'openai/gpt-4o',
-                name: 'GPT-4o',
-                context_length: 128000,
-                top_provider: { max_completion_tokens: 4096 },
-                pricing: { prompt: '0.000005', completion: '0.000015' },
-                architecture: { input_modalities: ['text', 'image'] },
-              },
-            ],
-          }),
-      }),
-    );
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-    vi.unstubAllGlobals();
-  });
-
-  it('skips registration gracefully when OPENROUTER_API_KEY is missing', async () => {
-    vi.unstubAllGlobals(); // no fetch call expected
-    const adapter = new OpenRouterAdapter();
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('registers and listModels returns models when OPENROUTER_API_KEY is set', async () => {
-    process.env['OPENROUTER_API_KEY'] = 'sk-or-test';
-    const adapter = new OpenRouterAdapter();
-    await adapter.register();
-
-    const models = adapter.listModels();
-    expect(models.length).toBeGreaterThan(0);
-
-    const first = models[0]!;
-    expect(first.provider).toBe('openrouter');
-    expect(first.id).toBe('openai/gpt-4o');
-    expect(first.inputTypes).toContain('image');
-  });
-
-  it('healthCheck returns down with error when OPENROUTER_API_KEY is missing', async () => {
-    vi.unstubAllGlobals(); // no fetch call expected
-    const adapter = new OpenRouterAdapter();
-    const health = await adapter.healthCheck();
-    expect(health.status).toBe('down');
-    expect(health.error).toMatch(/OPENROUTER_API_KEY/);
-  });
-
-  it('continues registration with empty model list when model fetch fails', async () => {
-    process.env['OPENROUTER_API_KEY'] = 'sk-or-test';
-    vi.stubGlobal(
-      'fetch',
-      vi.fn().mockResolvedValue({
-        ok: false,
-        status: 500,
-      }),
-    );
-    const adapter = new OpenRouterAdapter();
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('adapter name is "openrouter"', () => {
-    expect(new OpenRouterAdapter().name).toBe('openrouter');
-  });
-});
-
-describe('ZaiAdapter', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  it('skips registration gracefully when ZAI_API_KEY is missing', async () => {
-    const adapter = new ZaiAdapter();
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('registers and listModels returns glm-5 when ZAI_API_KEY is set', async () => {
-    process.env['ZAI_API_KEY'] = 'zai-test-key';
-    const adapter = new ZaiAdapter();
-    await adapter.register();
-
-    const models = adapter.listModels();
-    expect(models.length).toBeGreaterThan(0);
-
-    const ids = models.map((m) => m.id);
-    expect(ids).toContain('glm-5');
-
-    const glm = models.find((m) => m.id === 'glm-5')!;
-    expect(glm.provider).toBe('zai');
-  });
-
-  it('healthCheck returns down with error when ZAI_API_KEY is missing', async () => {
-    const adapter = new ZaiAdapter();
-    const health = await adapter.healthCheck();
-    expect(health.status).toBe('down');
-    expect(health.error).toMatch(/ZAI_API_KEY/);
-  });
-
-  it('adapter name is "zai"', () => {
-    expect(new ZaiAdapter().name).toBe('zai');
-  });
-});
-
-describe('OllamaAdapter', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  it('skips registration gracefully when OLLAMA_BASE_URL is missing', async () => {
-    const adapter = new OllamaAdapter(makeRegistry());
-    await expect(adapter.register()).resolves.toBeUndefined();
-    expect(adapter.listModels()).toEqual([]);
-  });
-
-  it('registers via OLLAMA_HOST fallback when OLLAMA_BASE_URL is absent', async () => {
-    process.env['OLLAMA_HOST'] = 'http://localhost:11434';
-    const adapter = new OllamaAdapter(makeRegistry());
-    await adapter.register();
-    const models = adapter.listModels();
-    expect(models.length).toBeGreaterThan(0);
-  });
-
-  it('registers default models (llama3.2, codellama, mistral) + embedding models', async () => {
-    process.env['OLLAMA_BASE_URL'] = 'http://localhost:11434';
-    const adapter = new OllamaAdapter(makeRegistry());
-    await adapter.register();
-
-    const models = adapter.listModels();
-    const ids = models.map((m) => m.id);
-
-    // Default completion models
-    expect(ids).toContain('llama3.2');
-    expect(ids).toContain('codellama');
-    expect(ids).toContain('mistral');
-
-    // Embedding models
-    expect(ids).toContain('nomic-embed-text');
-    expect(ids).toContain('mxbai-embed-large');
-
-    for (const model of models) {
-      expect(model.provider).toBe('ollama');
-    }
-  });
-
-  it('registers custom OLLAMA_MODELS list', async () => {
-    process.env['OLLAMA_BASE_URL'] = 'http://localhost:11434';
-    process.env['OLLAMA_MODELS'] = 'phi3,gemma2';
-    const adapter = new OllamaAdapter(makeRegistry());
-    await adapter.register();
-
-    const completionIds = adapter.listModels().map((m) => m.id);
-    expect(completionIds).toContain('phi3');
-    expect(completionIds).toContain('gemma2');
-    expect(completionIds).not.toContain('llama3.2');
-  });
-
-  it('healthCheck returns down with error when OLLAMA_BASE_URL is missing', async () => {
-    const adapter = new OllamaAdapter(makeRegistry());
-    const health = await adapter.healthCheck();
-    expect(health.status).toBe('down');
-    expect(health.error).toMatch(/OLLAMA_BASE_URL/);
-  });
-
-  it('adapter name is "ollama"', () => {
-    expect(new OllamaAdapter(makeRegistry()).name).toBe('ollama');
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 2. ProviderService integration
-// ---------------------------------------------------------------------------
-
-describe('ProviderService — adapter array integration', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  it('contains all 5 adapters (ollama, anthropic, openai, openrouter, zai)', async () => {
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    // Exercise getAdapter for all five known provider names
-    const expectedProviders = ['ollama', 'anthropic', 'openai', 'openrouter', 'zai'];
-    for (const name of expectedProviders) {
-      const adapter = service.getAdapter(name);
-      expect(adapter, `Expected adapter "${name}" to be registered`).toBeDefined();
-      expect(adapter!.name).toBe(name);
-    }
-  });
-
-  it('healthCheckAll runs without crashing and returns status for all 5 providers', async () => {
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const results = await service.healthCheckAll();
-    expect(typeof results).toBe('object');
-
-    const expectedProviders = ['ollama', 'anthropic', 'openai', 'openrouter', 'zai'];
-    for (const name of expectedProviders) {
-      const health = results[name];
-      expect(health, `Expected health result for provider "${name}"`).toBeDefined();
-      expect(['healthy', 'degraded', 'down']).toContain(health!.status);
-      expect(health!.lastChecked).toBeTruthy();
-    }
-  });
-
-  it('healthCheckAll reports "down" for all providers when no keys are set', async () => {
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const results = await service.healthCheckAll();
-    // All unconfigured providers should be down (not healthy)
-    for (const [, health] of Object.entries(results)) {
-      expect(['down', 'degraded']).toContain(health.status);
-    }
-  });
-
-  it('getProvidersHealth returns entries for all 5 providers', async () => {
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const healthList = service.getProvidersHealth();
-    const names = healthList.map((h) => h.name);
-
-    for (const expected of ['ollama', 'anthropic', 'openai', 'openrouter', 'zai']) {
-      expect(names).toContain(expected);
-    }
-
-    for (const entry of healthList) {
-      expect(entry).toHaveProperty('name');
-      expect(entry).toHaveProperty('status');
-      expect(entry).toHaveProperty('lastChecked');
-      expect(typeof entry.modelCount).toBe('number');
-    }
-  });
-
-  it('service initialises without error when all env keys are absent', async () => {
-    const service = new ProviderService(null);
-    await expect(service.onModuleInit()).resolves.toBeUndefined();
-    service.onModuleDestroy();
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 3. Model capability matrix
-// ---------------------------------------------------------------------------
-
-describe('Model capability matrix', () => {
-  const expectedModels: Array<{
-    id: string;
-    provider: string;
-    tier: string;
-    contextWindow: number;
-    reasoning?: boolean;
-    vision?: boolean;
-    embedding?: boolean;
-  }> = [
-    {
-      id: 'claude-opus-4-6',
-      provider: 'anthropic',
-      tier: 'premium',
-      contextWindow: 200000,
-      reasoning: true,
-      vision: true,
-    },
-    {
-      id: 'claude-sonnet-4-6',
-      provider: 'anthropic',
-      tier: 'standard',
-      contextWindow: 200000,
-      reasoning: true,
-      vision: true,
-    },
-    {
-      id: 'claude-haiku-4-5',
-      provider: 'anthropic',
-      tier: 'cheap',
-      contextWindow: 200000,
-      reasoning: false,
-      vision: true,
-    },
-    {
-      id: 'codex-gpt-5.4',
-      provider: 'openai',
-      tier: 'premium',
-      contextWindow: 128000,
-    },
-    {
-      id: 'glm-5',
-      provider: 'zai',
-      tier: 'standard',
-      contextWindow: 128000,
-    },
-    {
-      id: 'llama3.2',
-      provider: 'ollama',
-      tier: 'local',
-      contextWindow: 128000,
-    },
-    {
-      id: 'codellama',
-      provider: 'ollama',
-      tier: 'local',
-      contextWindow: 16000,
-    },
-    {
-      id: 'mistral',
-      provider: 'ollama',
-      tier: 'local',
-      contextWindow: 32000,
-    },
-    {
-      id: 'nomic-embed-text',
-      provider: 'ollama',
-      tier: 'local',
-      contextWindow: 8192,
-      embedding: true,
-    },
-    {
-      id: 'mxbai-embed-large',
-      provider: 'ollama',
-      tier: 'local',
-      contextWindow: 8192,
-      embedding: true,
-    },
-  ];
-
-  it('MODEL_CAPABILITIES contains all expected model IDs', () => {
-    const allIds = MODEL_CAPABILITIES.map((m) => m.id);
-    for (const { id } of expectedModels) {
-      expect(allIds, `Expected model "${id}" in capability matrix`).toContain(id);
-    }
-  });
-
-  it('getModelCapability() returns correct tier and context window for each model', () => {
-    for (const expected of expectedModels) {
-      const cap = getModelCapability(expected.id);
-      expect(cap, `getModelCapability("${expected.id}") should be defined`).toBeDefined();
-      expect(cap!.provider).toBe(expected.provider);
-      expect(cap!.tier).toBe(expected.tier);
-      expect(cap!.contextWindow).toBe(expected.contextWindow);
-    }
-  });
-
-  it('Anthropic models have correct capability flags (tools, streaming, vision, reasoning)', () => {
-    for (const expected of expectedModels.filter((m) => m.provider === 'anthropic')) {
-      const cap = getModelCapability(expected.id)!;
-      expect(cap.capabilities.tools).toBe(true);
-      expect(cap.capabilities.streaming).toBe(true);
-      if (expected.vision !== undefined) {
-        expect(cap.capabilities.vision).toBe(expected.vision);
-      }
-      if (expected.reasoning !== undefined) {
-        expect(cap.capabilities.reasoning).toBe(expected.reasoning);
-      }
-    }
-  });
-
-  it('Embedding models have embedding flag=true and other flags=false', () => {
-    for (const expected of expectedModels.filter((m) => m.embedding)) {
-      const cap = getModelCapability(expected.id)!;
-      expect(cap.capabilities.embedding).toBe(true);
-      expect(cap.capabilities.tools).toBe(false);
-      expect(cap.capabilities.streaming).toBe(false);
-      expect(cap.capabilities.reasoning).toBe(false);
-    }
-  });
-
-  it('findModelsByCapability filters by tier correctly', () => {
-    const premiumModels = findModelsByCapability({ tier: 'premium' });
-    expect(premiumModels.length).toBeGreaterThan(0);
-    for (const m of premiumModels) {
-      expect(m.tier).toBe('premium');
-    }
-  });
-
-  it('findModelsByCapability filters by provider correctly', () => {
-    const anthropicModels = findModelsByCapability({ provider: 'anthropic' });
-    expect(anthropicModels.length).toBe(3);
-    for (const m of anthropicModels) {
-      expect(m.provider).toBe('anthropic');
-    }
-  });
-
-  it('findModelsByCapability filters by capability flags correctly', () => {
-    const reasoningModels = findModelsByCapability({ capabilities: { reasoning: true } });
-    expect(reasoningModels.length).toBeGreaterThan(0);
-    for (const m of reasoningModels) {
-      expect(m.capabilities.reasoning).toBe(true);
-    }
-
-    const embeddingModels = findModelsByCapability({ capabilities: { embedding: true } });
-    expect(embeddingModels.length).toBeGreaterThan(0);
-    for (const m of embeddingModels) {
-      expect(m.capabilities.embedding).toBe(true);
-    }
-  });
-
-  it('getModelCapability returns undefined for unknown model IDs', () => {
-    expect(getModelCapability('not-a-real-model')).toBeUndefined();
-    expect(getModelCapability('')).toBeUndefined();
-  });
-
-  it('all Anthropic models have maxOutputTokens > 0', () => {
-    const anthropicModels = MODEL_CAPABILITIES.filter((m) => m.provider === 'anthropic');
-    for (const m of anthropicModels) {
-      expect(m.maxOutputTokens).toBeGreaterThan(0);
-    }
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 4. ProviderCredentialsService — unit-level tests (encrypt/decrypt logic)
-// ---------------------------------------------------------------------------
-
-describe('ProviderCredentialsService — encryption helpers', () => {
-  let savedEnv: Map<EnvKey, string | undefined>;
-
-  beforeEach(() => {
-    savedEnv = saveAndClearEnv();
-  });
-
-  afterEach(() => {
-    restoreEnv(savedEnv);
-  });
-
-  /**
-   * The service uses module-level functions (encrypt/decrypt) that depend on
-   * BETTER_AUTH_SECRET. We test the behaviour through the service's public API
-   * using an in-memory mock DB so no real Postgres connection is needed.
-   */
-  it('store/retrieve/remove work correctly with mock DB and BETTER_AUTH_SECRET set', async () => {
-    process.env['BETTER_AUTH_SECRET'] = 'test-secret-for-unit-tests-only';
-
-    // Build a minimal in-memory DB mock
-    const rows = new Map<
-      string,
-      {
-        encryptedValue: string;
-        credentialType: string;
-        expiresAt: Date | null;
-        metadata: null;
-        createdAt: Date;
-        updatedAt: Date;
-      }
-    >();
-
-    // We import the service but mock its DB dependency manually
-    // by testing the encrypt/decrypt indirectly — using the real module.
-    const { ProviderCredentialsService } = await import('../provider-credentials.service.js');
-
-    // Capture stored value from upsert call
-    let storedEncryptedValue = '';
-    let storedCredentialType = '';
-    const captureInsert = vi.fn().mockImplementation(() => ({
-      values: vi
-        .fn()
-        .mockImplementation((data: { encryptedValue: string; credentialType: string }) => {
-          storedEncryptedValue = data.encryptedValue;
-          storedCredentialType = data.credentialType;
-          rows.set('user1:anthropic', {
-            encryptedValue: data.encryptedValue,
-            credentialType: data.credentialType,
-            expiresAt: null,
-            metadata: null,
-            createdAt: new Date(),
-            updatedAt: new Date(),
-          });
-          return {
-            onConflictDoUpdate: vi.fn().mockResolvedValue(undefined),
-          };
-        }),
-    }));
-
-    const captureSelect = vi.fn().mockReturnValue({
-      from: vi.fn().mockReturnValue({
-        where: vi.fn().mockReturnValue({
-          limit: vi.fn().mockImplementation(() => {
-            const row = rows.get('user1:anthropic');
-            return Promise.resolve(row ? [row] : []);
-          }),
-        }),
-      }),
-    });
-
-    const captureDelete = vi.fn().mockReturnValue({
-      where: vi.fn().mockResolvedValue(undefined),
-    });
-
-    const db = {
-      insert: captureInsert,
-      select: captureSelect,
-      delete: captureDelete,
-    };
-
-    const service = new ProviderCredentialsService(db as never);
-
-    // store
-    await service.store('user1', 'anthropic', 'api_key', 'sk-ant-secret-value');
-
-    // verify encrypted value is not plain text
-    expect(storedEncryptedValue).not.toBe('sk-ant-secret-value');
-    expect(storedEncryptedValue.length).toBeGreaterThan(0);
-    expect(storedCredentialType).toBe('api_key');
-
-    // retrieve
-    const retrieved = await service.retrieve('user1', 'anthropic');
-    expect(retrieved).toBe('sk-ant-secret-value');
-
-    // remove (clears the row)
-    rows.delete('user1:anthropic');
-    const afterRemove = await service.retrieve('user1', 'anthropic');
-    expect(afterRemove).toBeNull();
-  });
-
-  it('retrieve returns null when no credential is stored', async () => {
-    process.env['BETTER_AUTH_SECRET'] = 'test-secret-for-unit-tests-only';
-
-    const { ProviderCredentialsService } = await import('../provider-credentials.service.js');
-
-    const emptyDb = {
-      select: vi.fn().mockReturnValue({
-        from: vi.fn().mockReturnValue({
-          where: vi.fn().mockReturnValue({
-            limit: vi.fn().mockResolvedValue([]),
-          }),
-        }),
-      }),
-    };
-
-    const service = new ProviderCredentialsService(emptyDb as never);
-    const result = await service.retrieve('user-nobody', 'anthropic');
-    expect(result).toBeNull();
-  });
-
-  it('listProviders returns only metadata, never decrypted values', async () => {
-    process.env['BETTER_AUTH_SECRET'] = 'test-secret-for-unit-tests-only';
-
-    const { ProviderCredentialsService } = await import('../provider-credentials.service.js');
-
-    const fakeRow = {
-      provider: 'anthropic',
-      credentialType: 'api_key',
-      expiresAt: null,
-      metadata: null,
-      createdAt: new Date(),
-      updatedAt: new Date(),
-    };
-
-    const listDb = {
-      select: vi.fn().mockReturnValue({
-        from: vi.fn().mockReturnValue({
-          where: vi.fn().mockResolvedValue([fakeRow]),
-        }),
-      }),
-    };
-
-    const service = new ProviderCredentialsService(listDb as never);
-    const providers = await service.listProviders('user1');
-
-    expect(providers).toHaveLength(1);
-    expect(providers[0]!.provider).toBe('anthropic');
-    expect(providers[0]!.credentialType).toBe('api_key');
-    expect(providers[0]!.exists).toBe(true);
-
-    // Critically: no encrypted or plain-text value is exposed
-    expect(providers[0]).not.toHaveProperty('encryptedValue');
-    expect(providers[0]).not.toHaveProperty('value');
-    expect(providers[0]).not.toHaveProperty('apiKey');
-  });
-});
@@ -1,142 +0,0 @@
-import { beforeEach, afterEach, describe, expect, it } from 'vitest';
-import { ProviderService } from '../provider.service.js';
-
-const ENV_KEYS = [
-  'ANTHROPIC_API_KEY',
-  'OPENAI_API_KEY',
-  'ZAI_API_KEY',
-  'OLLAMA_BASE_URL',
-  'OLLAMA_HOST',
-  'OLLAMA_MODELS',
-  'MOSAIC_CUSTOM_PROVIDERS',
-] as const;
-
-type EnvKey = (typeof ENV_KEYS)[number];
-
-describe('ProviderService', () => {
-  const savedEnv = new Map<EnvKey, string | undefined>();
-
-  beforeEach(() => {
-    for (const key of ENV_KEYS) {
-      savedEnv.set(key, process.env[key]);
-      delete process.env[key];
-    }
-  });
-
-  afterEach(() => {
-    for (const key of ENV_KEYS) {
-      const value = savedEnv.get(key);
-      if (value === undefined) {
-        delete process.env[key];
-      } else {
-        process.env[key] = value;
-      }
-    }
-  });
-
-  it('skips API-key providers when env vars are missing (no models become available)', async () => {
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    // Pi's built-in registry may include model definitions for all providers, but
-    // without API keys none of them should be available (usable).
-    const availableModels = service.listAvailableModels();
-    const availableProviderIds = new Set(availableModels.map((m) => m.provider));
-
-    expect(availableProviderIds).not.toContain('anthropic');
-    expect(availableProviderIds).not.toContain('openai');
-    expect(availableProviderIds).not.toContain('zai');
-
-    // Providers list may show built-in providers, but they should not be marked available
-    const providers = service.listProviders();
-    for (const p of providers.filter((p) => ['anthropic', 'openai', 'zai'].includes(p.id))) {
-      expect(p.available).toBe(false);
-    }
-  });
-
-  it('registers Anthropic provider with correct models when ANTHROPIC_API_KEY is set', async () => {
-    process.env['ANTHROPIC_API_KEY'] = 'test-anthropic';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const providers = service.listProviders();
-    const anthropic = providers.find((p) => p.id === 'anthropic');
-    expect(anthropic).toBeDefined();
-    expect(anthropic!.available).toBe(true);
-    expect(anthropic!.models.map((m) => m.id)).toEqual([
-      'claude-opus-4-6',
-      'claude-sonnet-4-6',
-      'claude-haiku-4-5',
-    ]);
-    // All Anthropic models have 200k context window
-    for (const m of anthropic!.models) {
-      expect(m.contextWindow).toBe(200000);
-    }
-  });
-
-  it('registers OpenAI provider with correct models when OPENAI_API_KEY is set', async () => {
-    process.env['OPENAI_API_KEY'] = 'test-openai';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const providers = service.listProviders();
-    const openai = providers.find((p) => p.id === 'openai');
-    expect(openai).toBeDefined();
-    expect(openai!.available).toBe(true);
-    expect(openai!.models.map((m) => m.id)).toEqual(['codex-gpt-5-4']);
-  });
-
-  it('registers Z.ai provider with correct models when ZAI_API_KEY is set', async () => {
-    process.env['ZAI_API_KEY'] = 'test-zai';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const providers = service.listProviders();
-    const zai = providers.find((p) => p.id === 'zai');
-    expect(zai).toBeDefined();
-    expect(zai!.available).toBe(true);
-    // Pi's registry may include additional glm variants; verify our registered model is present
-    expect(zai!.models.map((m) => m.id)).toContain('glm-5');
-  });
-
-  it('registers all three providers when all keys are set', async () => {
-    process.env['ANTHROPIC_API_KEY'] = 'test-anthropic';
-    process.env['OPENAI_API_KEY'] = 'test-openai';
-    process.env['ZAI_API_KEY'] = 'test-zai';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const providerIds = service.listProviders().map((p) => p.id);
-    expect(providerIds).toContain('anthropic');
-    expect(providerIds).toContain('openai');
-    expect(providerIds).toContain('zai');
-  });
-
-  it('can find registered Anthropic models by provider+id', async () => {
-    process.env['ANTHROPIC_API_KEY'] = 'test-anthropic';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const sonnet = service.findModel('anthropic', 'claude-sonnet-4-6');
-    expect(sonnet).toBeDefined();
-    expect(sonnet!.provider).toBe('anthropic');
-    expect(sonnet!.id).toBe('claude-sonnet-4-6');
-  });
-
-  it('can find registered Z.ai models by provider+id', async () => {
-    process.env['ZAI_API_KEY'] = 'test-zai';
-
-    const service = new ProviderService(null);
-    await service.onModuleInit();
-
-    const glm = service.findModel('zai', 'glm-4.5');
-    expect(glm).toBeDefined();
-    expect(glm!.provider).toBe('zai');
-    expect(glm!.id).toBe('glm-4.5');
-  });
-});
@@ -1,138 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { RoutingService } from '../routing.service.js';
-import type { ModelInfo } from '@mosaicstack/types';
-
-const mockModels: ModelInfo[] = [
-  {
-    id: 'claude-3-haiku',
-    provider: 'anthropic',
-    name: 'Claude 3 Haiku',
-    reasoning: false,
-    contextWindow: 200_000,
-    maxTokens: 4096,
-    inputTypes: ['text', 'image'],
-    cost: { input: 0.25, output: 1.25, cacheRead: 0.03, cacheWrite: 0.3 },
-  },
-  {
-    id: 'claude-3-sonnet',
-    provider: 'anthropic',
-    name: 'Claude 3 Sonnet',
-    reasoning: true,
-    contextWindow: 200_000,
-    maxTokens: 8192,
-    inputTypes: ['text', 'image'],
-    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-  },
-  {
-    id: 'llama3.2',
-    provider: 'ollama',
-    name: 'Llama 3.2',
-    reasoning: false,
-    contextWindow: 128_000,
-    maxTokens: 4096,
-    inputTypes: ['text'],
-    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-  },
-];
-
-function createMockProviderService() {
-  return {
-    listAvailableModels: vi.fn().mockReturnValue(mockModels),
-    findModel: vi.fn(),
-    getDefaultModel: vi.fn(),
-    getRegistry: vi.fn(),
-    listProviders: vi.fn(),
-    registerCustomProvider: vi.fn(),
-  };
-}
-
-describe('RoutingService', () => {
-  let routingService: RoutingService;
-  let mockProviderService: ReturnType<typeof createMockProviderService>;
-
-  beforeEach(() => {
-    mockProviderService = createMockProviderService();
-    routingService = new RoutingService(mockProviderService as never);
-  });
-
-  it('returns a model when no criteria specified', () => {
-    const result = routingService.route();
-    expect(result).not.toBeNull();
-    expect(result!.provider).toBeDefined();
-    expect(result!.modelId).toBeDefined();
-    expect(result!.score).toBeGreaterThan(0);
-  });
-
-  it('returns null when no models available', () => {
-    mockProviderService.listAvailableModels.mockReturnValue([]);
-    const result = routingService.route();
-    expect(result).toBeNull();
-  });
-
-  it('selects preferred model when specified', () => {
-    const result = routingService.route({
-      preferredProvider: 'anthropic',
-      preferredModel: 'claude-3-sonnet',
-    });
-    expect(result).not.toBeNull();
-    expect(result!.provider).toBe('anthropic');
-    expect(result!.modelId).toBe('claude-3-sonnet');
-    expect(result!.score).toBe(100);
-  });
-
-  it('disqualifies models without reasoning when required', () => {
-    const result = routingService.route({ requireReasoning: true });
-    expect(result).not.toBeNull();
-    expect(result!.modelId).toBe('claude-3-sonnet');
-  });
-
-  it('disqualifies models without image input when required', () => {
-    const result = routingService.route({ requireImageInput: true });
-    expect(result).not.toBeNull();
-    // Llama doesn't support images, should be excluded
-    expect(result!.provider).toBe('anthropic');
-  });
-
-  it('respects minimum context window', () => {
-    const result = routingService.route({ minContextWindow: 150_000 });
-    expect(result).not.toBeNull();
-    // Only anthropic models have 200k context
-    expect(result!.provider).toBe('anthropic');
-  });
-
-  it('favors cheap models when costTier is cheap', () => {
-    const result = routingService.route({ costTier: 'cheap' });
-    expect(result).not.toBeNull();
-    // Ollama (free) and Haiku ($0.25/M) are cheap
-    expect(['ollama', 'anthropic'].includes(result!.provider)).toBe(true);
-    if (result!.provider === 'anthropic') {
-      expect(result!.modelId).toBe('claude-3-haiku');
-    }
-  });
-
-  it('ranks all models and returns sorted results', () => {
-    const ranked = routingService.rank({ taskType: 'coding' });
-    expect(ranked.length).toBeGreaterThan(0);
-    // Should be sorted by score descending
-    for (let i = 1; i < ranked.length; i++) {
-      expect(ranked[i]!.score).toBeLessThanOrEqual(ranked[i - 1]!.score);
-    }
-  });
-
-  it('gives reasoning bonus for coding tasks', () => {
-    const ranked = routingService.rank({ taskType: 'coding' });
-    const sonnet = ranked.find((r) => r.modelId === 'claude-3-sonnet');
-    const haiku = ranked.find((r) => r.modelId === 'claude-3-haiku');
-    expect(sonnet).toBeDefined();
-    expect(haiku).toBeDefined();
-    // Sonnet (reasoning) should score higher for coding than haiku (no reasoning)
-    expect(sonnet!.score).toBeGreaterThan(haiku!.score);
-  });
-
-  it('prefers specified provider', () => {
-    const ranked = routingService.rank({ preferredProvider: 'ollama' });
-    const ollamaModel = ranked.find((r) => r.provider === 'ollama');
-    expect(ollamaModel).toBeDefined();
-    expect(ollamaModel!.reasoning).toContain('preferred provider');
-  });
-});
@@ -1,191 +0,0 @@
-import { Logger } from '@nestjs/common';
-import Anthropic from '@anthropic-ai/sdk';
-import type { ModelRegistry } from '@mariozechner/pi-coding-agent';
-import type {
-  CompletionEvent,
-  CompletionParams,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-} from '@mosaicstack/types';
-
-/**
- * Anthropic provider adapter.
- *
- * Registers Claude models with the Pi ModelRegistry via the Anthropic SDK.
- * Configuration is driven by environment variables:
- *   ANTHROPIC_API_KEY — Anthropic API key (required)
- */
-export class AnthropicAdapter implements IProviderAdapter {
-  readonly name = 'anthropic';
-
-  private readonly logger = new Logger(AnthropicAdapter.name);
-  private client: Anthropic | null = null;
-  private registeredModels: ModelInfo[] = [];
-
-  constructor(private readonly registry: ModelRegistry) {}
-
-  async register(): Promise<void> {
-    const apiKey = process.env['ANTHROPIC_API_KEY'];
-    if (!apiKey) {
-      this.logger.warn('Skipping Anthropic provider registration: ANTHROPIC_API_KEY not set');
-      return;
-    }
-
-    this.client = new Anthropic({ apiKey });
-
-    const models: ModelInfo[] = [
-      {
-        id: 'claude-opus-4-6',
-        provider: 'anthropic',
-        name: 'Claude Opus 4.6',
-        reasoning: true,
-        contextWindow: 200000,
-        maxTokens: 32000,
-        inputTypes: ['text', 'image'],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-      },
-      {
-        id: 'claude-sonnet-4-6',
-        provider: 'anthropic',
-        name: 'Claude Sonnet 4.6',
-        reasoning: true,
-        contextWindow: 200000,
-        maxTokens: 16000,
-        inputTypes: ['text', 'image'],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-      },
-      {
-        id: 'claude-haiku-4-5',
-        provider: 'anthropic',
-        name: 'Claude Haiku 4.5',
-        reasoning: false,
-        contextWindow: 200000,
-        maxTokens: 8192,
-        inputTypes: ['text', 'image'],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-      },
-    ];
-
-    this.registry.registerProvider('anthropic', {
-      apiKey,
-      baseUrl: 'https://api.anthropic.com',
-      api: 'anthropic' as never,
-      models: models.map((m) => ({
-        id: m.id,
-        name: m.name,
-        reasoning: m.reasoning,
-        input: m.inputTypes as ('text' | 'image')[],
-        cost: m.cost,
-        contextWindow: m.contextWindow,
-        maxTokens: m.maxTokens,
-      })),
-    });
-
-    this.registeredModels = models;
-
-    this.logger.log(
-      `Anthropic provider registered with models: ${models.map((m) => m.id).join(', ')}`,
-    );
-  }
-
-  listModels(): ModelInfo[] {
-    return this.registeredModels;
-  }
-
-  async healthCheck(): Promise<ProviderHealth> {
-    const apiKey = process.env['ANTHROPIC_API_KEY'];
-    if (!apiKey) {
-      return {
-        status: 'down',
-        lastChecked: new Date().toISOString(),
-        error: 'ANTHROPIC_API_KEY not configured',
-      };
-    }
-
-    const start = Date.now();
-
-    try {
-      const client = this.client ?? new Anthropic({ apiKey });
-      await client.models.list({ limit: 1 });
-      const latencyMs = Date.now() - start;
-      return { status: 'healthy', latencyMs, lastChecked: new Date().toISOString() };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const error = err instanceof Error ? err.message : String(err);
-      const status = error.includes('401') || error.includes('403') ? 'degraded' : 'down';
-      return { status, latencyMs, lastChecked: new Date().toISOString(), error };
-    }
-  }
-
-  /**
-   * Stream a completion from Anthropic using the messages API.
-   * Maps Anthropic streaming events to the CompletionEvent format.
-   *
-   * Note: Currently reserved for future direct-completion use. The Pi SDK
-   * integration routes completions through ModelRegistry / AgentSession.
-   */
-  async *createCompletion(params: CompletionParams): AsyncIterable<CompletionEvent> {
-    const apiKey = process.env['ANTHROPIC_API_KEY'];
-    if (!apiKey) {
-      throw new Error('AnthropicAdapter: ANTHROPIC_API_KEY not configured');
-    }
-
-    const client = this.client ?? new Anthropic({ apiKey });
-
-    // Separate system messages from user/assistant messages
-    const systemMessages = params.messages.filter((m) => m.role === 'system');
-    const conversationMessages = params.messages.filter((m) => m.role !== 'system');
-
-    const systemPrompt =
-      systemMessages.length > 0 ? systemMessages.map((m) => m.content).join('\n') : undefined;
-
-    const stream = await client.messages.stream({
-      model: params.model,
-      max_tokens: params.maxTokens ?? 1024,
-      ...(systemPrompt !== undefined ? { system: systemPrompt } : {}),
-      messages: conversationMessages.map((m) => ({
-        role: m.role as 'user' | 'assistant',
-        content: m.content,
-      })),
-      ...(params.temperature !== undefined ? { temperature: params.temperature } : {}),
-      ...(params.tools && params.tools.length > 0
-        ? {
-            tools: params.tools.map((t) => ({
-              name: t.name,
-              description: t.description,
-              input_schema: t.parameters as Anthropic.Tool['input_schema'],
-            })),
-          }
-        : {}),
-    });
-
-    for await (const event of stream) {
-      if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
-        yield { type: 'text_delta', content: event.delta.text };
-      } else if (event.type === 'content_block_delta' && event.delta.type === 'input_json_delta') {
-        yield { type: 'tool_call', name: '', arguments: event.delta.partial_json };
-      } else if (event.type === 'message_delta' && event.usage) {
-        yield {
-          type: 'done',
-          usage: {
-            inputTokens:
-              (event as { usage: { input_tokens?: number; output_tokens: number } }).usage
-                .input_tokens ?? 0,
-            outputTokens: event.usage.output_tokens,
-          },
-        };
-      }
-    }
-
-    // Emit final done event with full usage from the completed message
-    const finalMessage = await stream.finalMessage();
-    yield {
-      type: 'done',
-      usage: {
-        inputTokens: finalMessage.usage.input_tokens,
-        outputTokens: finalMessage.usage.output_tokens,
-      },
-    };
-  }
-}
@@ -1,5 +0,0 @@
-export { OllamaAdapter } from './ollama.adapter.js';
-export { AnthropicAdapter } from './anthropic.adapter.js';
-export { OpenAIAdapter } from './openai.adapter.js';
-export { OpenRouterAdapter } from './openrouter.adapter.js';
-export { ZaiAdapter } from './zai.adapter.js';
@@ -1,197 +0,0 @@
-import { Logger } from '@nestjs/common';
-import type { ModelRegistry } from '@mariozechner/pi-coding-agent';
-import type {
-  CompletionEvent,
-  CompletionParams,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-} from '@mosaicstack/types';
-
-/** Embedding models that Ollama ships with out of the box */
-const OLLAMA_EMBEDDING_MODELS: ReadonlyArray<{
-  id: string;
-  contextWindow: number;
-  dimensions: number;
-}> = [
-  { id: 'nomic-embed-text', contextWindow: 8192, dimensions: 768 },
-  { id: 'mxbai-embed-large', contextWindow: 512, dimensions: 1024 },
-];
-
-interface OllamaEmbeddingResponse {
-  embedding?: number[];
-}
-
-/**
- * Ollama provider adapter.
- *
- * Registers local Ollama models with the Pi ModelRegistry via the OpenAI-compatible
- * completions API. Also exposes embedding models and an `embed()` method for
- * vector generation (used by EmbeddingService / M3-009).
- *
- * Configuration is driven by environment variables:
- *   OLLAMA_BASE_URL or OLLAMA_HOST — base URL of the Ollama instance
- *   OLLAMA_MODELS              — comma-separated list of model IDs (default: llama3.2,codellama,mistral)
- */
-export class OllamaAdapter implements IProviderAdapter {
-  readonly name = 'ollama';
-
-  private readonly logger = new Logger(OllamaAdapter.name);
-  private registeredModels: ModelInfo[] = [];
-
-  constructor(private readonly registry: ModelRegistry) {}
-
-  async register(): Promise<void> {
-    const ollamaUrl = process.env['OLLAMA_BASE_URL'] ?? process.env['OLLAMA_HOST'];
-    if (!ollamaUrl) {
-      this.logger.debug('Skipping Ollama provider registration: OLLAMA_BASE_URL not set');
-      return;
-    }
-
-    const modelsEnv = process.env['OLLAMA_MODELS'] ?? 'llama3.2,codellama,mistral';
-    const modelIds = modelsEnv
-      .split(',')
-      .map((id: string) => id.trim())
-      .filter(Boolean);
-
-    this.registry.registerProvider('ollama', {
-      baseUrl: `${ollamaUrl}/v1`,
-      apiKey: 'ollama',
-      api: 'openai-completions' as never,
-      models: modelIds.map((id) => ({
-        id,
-        name: id,
-        reasoning: false,
-        input: ['text'] as ('text' | 'image')[],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-        contextWindow: 8192,
-        maxTokens: 4096,
-      })),
-    });
-
-    // Chat / completion models
-    const completionModels: ModelInfo[] = modelIds.map((id) => ({
-      id,
-      provider: 'ollama',
-      name: id,
-      reasoning: false,
-      contextWindow: 8192,
-      maxTokens: 4096,
-      inputTypes: ['text'] as ('text' | 'image')[],
-      cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-    }));
-
-    // Embedding models (tracked in registeredModels but not in Pi registry,
-    // which only handles completion models)
-    const embeddingModels: ModelInfo[] = OLLAMA_EMBEDDING_MODELS.map((em) => ({
-      id: em.id,
-      provider: 'ollama',
-      name: em.id,
-      reasoning: false,
-      contextWindow: em.contextWindow,
-      maxTokens: 0,
-      inputTypes: ['text'] as ('text' | 'image')[],
-      cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-    }));
-
-    this.registeredModels = [...completionModels, ...embeddingModels];
-
-    this.logger.log(
-      `Ollama provider registered at ${ollamaUrl} with models: ${modelIds.join(', ')} ` +
-        `and embedding models: ${OLLAMA_EMBEDDING_MODELS.map((em) => em.id).join(', ')}`,
-    );
-  }
-
-  listModels(): ModelInfo[] {
-    return this.registeredModels;
-  }
-
-  async healthCheck(): Promise<ProviderHealth> {
-    const ollamaUrl = process.env['OLLAMA_BASE_URL'] ?? process.env['OLLAMA_HOST'];
-    if (!ollamaUrl) {
-      return {
-        status: 'down',
-        lastChecked: new Date().toISOString(),
-        error: 'OLLAMA_BASE_URL not configured',
-      };
-    }
-
-    const checkUrl = `${ollamaUrl}/v1/models`;
-    const start = Date.now();
-
-    try {
-      const res = await fetch(checkUrl, {
-        method: 'GET',
-        headers: { Accept: 'application/json' },
-        signal: AbortSignal.timeout(5000),
-      });
-      const latencyMs = Date.now() - start;
-
-      if (!res.ok) {
-        return {
-          status: 'degraded',
-          latencyMs,
-          lastChecked: new Date().toISOString(),
-          error: `HTTP ${res.status}`,
-        };
-      }
-
-      return { status: 'healthy', latencyMs, lastChecked: new Date().toISOString() };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const error = err instanceof Error ? err.message : String(err);
-      return { status: 'down', latencyMs, lastChecked: new Date().toISOString(), error };
-    }
-  }
-
-  /**
-   * Generate an embedding vector for the given text using Ollama's /api/embeddings endpoint.
-   *
-   * Defaults to 'nomic-embed-text' when no model is specified.
-   * Intended for use by EmbeddingService (M3-009).
-   *
-   * @param text - The input text to embed.
-   * @param model - Optional embedding model ID (default: 'nomic-embed-text').
-   * @returns A float array representing the embedding vector.
-   */
-  async embed(text: string, model = 'nomic-embed-text'): Promise<number[]> {
-    const ollamaUrl = process.env['OLLAMA_BASE_URL'] ?? process.env['OLLAMA_HOST'];
-    if (!ollamaUrl) {
-      throw new Error('OllamaAdapter: OLLAMA_BASE_URL not configured');
-    }
-
-    const embeddingUrl = `${ollamaUrl}/api/embeddings`;
-
-    const res = await fetch(embeddingUrl, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ model, prompt: text }),
-      signal: AbortSignal.timeout(30000),
-    });
-
-    if (!res.ok) {
-      throw new Error(`OllamaAdapter.embed: request failed with HTTP ${res.status}`);
-    }
-
-    const json = (await res.json()) as OllamaEmbeddingResponse;
-
-    if (!Array.isArray(json.embedding)) {
-      throw new Error('OllamaAdapter.embed: unexpected response — missing embedding array');
-    }
-
-    return json.embedding;
-  }
-
-  /**
-   * createCompletion is reserved for future direct-completion use.
-   * The current integration routes completions through Pi SDK's ModelRegistry/AgentSession.
-   */
-  async *createCompletion(_params: CompletionParams): AsyncIterable<CompletionEvent> {
-    throw new Error(
-      'OllamaAdapter.createCompletion is not yet implemented. ' +
-        'Use Pi SDK AgentSession for completions.',
-    );
-    // Satisfy the AsyncGenerator return type — unreachable but required for TypeScript.
-    yield undefined as never;
-  }
-}
@@ -1,201 +0,0 @@
-import { Logger } from '@nestjs/common';
-import OpenAI from 'openai';
-import type { ModelRegistry } from '@mariozechner/pi-coding-agent';
-import type {
-  CompletionEvent,
-  CompletionParams,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-} from '@mosaicstack/types';
-
-/**
- * OpenAI provider adapter.
- *
- * Registers OpenAI models (including Codex gpt-5.4) with the Pi ModelRegistry.
- * Configuration is driven by environment variables:
- *   OPENAI_API_KEY — OpenAI API key (required; adapter skips registration when absent)
- */
-export class OpenAIAdapter implements IProviderAdapter {
-  readonly name = 'openai';
-
-  private readonly logger = new Logger(OpenAIAdapter.name);
-  private registeredModels: ModelInfo[] = [];
-  private client: OpenAI | null = null;
-
-  /** Model ID used for Codex gpt-5.4 in the Pi registry. */
-  static readonly CODEX_MODEL_ID = 'codex-gpt-5-4';
-
-  constructor(private readonly registry: ModelRegistry) {}
-
-  async register(): Promise<void> {
-    const apiKey = process.env['OPENAI_API_KEY'];
-    if (!apiKey) {
-      this.logger.debug('Skipping OpenAI provider registration: OPENAI_API_KEY not set');
-      return;
-    }
-
-    this.client = new OpenAI({ apiKey });
-
-    const codexModel = {
-      id: OpenAIAdapter.CODEX_MODEL_ID,
-      name: 'Codex gpt-5.4',
-      /** OpenAI-compatible completions API */
-      api: 'openai-completions' as never,
-      reasoning: false,
-      input: ['text', 'image'] as ('text' | 'image')[],
-      cost: { input: 0.003, output: 0.012, cacheRead: 0.0015, cacheWrite: 0 },
-      contextWindow: 128_000,
-      maxTokens: 16_384,
-    };
-
-    this.registry.registerProvider('openai', {
-      apiKey,
-      baseUrl: 'https://api.openai.com/v1',
-      models: [codexModel],
-    });
-
-    this.registeredModels = [
-      {
-        id: OpenAIAdapter.CODEX_MODEL_ID,
-        provider: 'openai',
-        name: 'Codex gpt-5.4',
-        reasoning: false,
-        contextWindow: 128_000,
-        maxTokens: 16_384,
-        inputTypes: ['text', 'image'] as ('text' | 'image')[],
-        cost: { input: 0.003, output: 0.012, cacheRead: 0.0015, cacheWrite: 0 },
-      },
-    ];
-
-    this.logger.log(`OpenAI provider registered with model: ${OpenAIAdapter.CODEX_MODEL_ID}`);
-  }
-
-  listModels(): ModelInfo[] {
-    return this.registeredModels;
-  }
-
-  async healthCheck(): Promise<ProviderHealth> {
-    const apiKey = process.env['OPENAI_API_KEY'];
-    if (!apiKey) {
-      return {
-        status: 'down',
-        lastChecked: new Date().toISOString(),
-        error: 'OPENAI_API_KEY not configured',
-      };
-    }
-
-    const start = Date.now();
-    try {
-      // Lightweight call — list models to verify key validity
-      const res = await fetch('https://api.openai.com/v1/models', {
-        method: 'GET',
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          'Content-Type': 'application/json',
-        },
-        signal: AbortSignal.timeout(5000),
-      });
-      const latencyMs = Date.now() - start;
-
-      if (!res.ok) {
-        return {
-          status: 'degraded',
-          latencyMs,
-          lastChecked: new Date().toISOString(),
-          error: `HTTP ${res.status}`,
-        };
-      }
-
-      return { status: 'healthy', latencyMs, lastChecked: new Date().toISOString() };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const error = err instanceof Error ? err.message : String(err);
-      return { status: 'down', latencyMs, lastChecked: new Date().toISOString(), error };
-    }
-  }
-
-  /**
-   * Stream a completion from OpenAI using the chat completions API.
-   *
-   * Maps OpenAI streaming chunks to the Mosaic CompletionEvent format.
-   */
-  async *createCompletion(params: CompletionParams): AsyncIterable<CompletionEvent> {
-    if (!this.client) {
-      throw new Error(
-        'OpenAIAdapter: client not initialized. ' +
-          'Ensure OPENAI_API_KEY is set and register() was called.',
-      );
-    }
-
-    const stream = await this.client.chat.completions.create({
-      model: params.model,
-      messages: params.messages.map((m) => ({
-        role: m.role,
-        content: m.content,
-      })),
-      ...(params.temperature !== undefined && { temperature: params.temperature }),
-      ...(params.maxTokens !== undefined && { max_tokens: params.maxTokens }),
-      ...(params.tools &&
-        params.tools.length > 0 && {
-          tools: params.tools.map((t) => ({
-            type: 'function' as const,
-            function: {
-              name: t.name,
-              description: t.description,
-              parameters: t.parameters,
-            },
-          })),
-        }),
-      stream: true,
-      stream_options: { include_usage: true },
-    });
-
-    let inputTokens = 0;
-    let outputTokens = 0;
-
-    for await (const chunk of stream) {
-      const choice = chunk.choices[0];
-
-      // Accumulate usage when present (final chunk with stream_options.include_usage)
-      if (chunk.usage) {
-        inputTokens = chunk.usage.prompt_tokens;
-        outputTokens = chunk.usage.completion_tokens;
-      }
-
-      if (!choice) continue;
-
-      const delta = choice.delta;
-
-      // Text content delta
-      if (delta.content) {
-        yield { type: 'text_delta', content: delta.content };
-      }
-
-      // Tool call delta — emit when arguments are complete
-      if (delta.tool_calls) {
-        for (const toolCallDelta of delta.tool_calls) {
-          if (toolCallDelta.function?.name && toolCallDelta.function.arguments !== undefined) {
-            yield {
-              type: 'tool_call',
-              name: toolCallDelta.function.name,
-              arguments: toolCallDelta.function.arguments,
-            };
-          }
-        }
-      }
-
-      // Stream finished
-      if (choice.finish_reason === 'stop' || choice.finish_reason === 'tool_calls') {
-        yield {
-          type: 'done',
-          usage: { inputTokens, outputTokens },
-        };
-        return;
-      }
-    }
-
-    // Fallback done event when stream ends without explicit finish_reason
-    yield { type: 'done', usage: { inputTokens, outputTokens } };
-  }
-}
@@ -1,212 +0,0 @@
-import { Logger } from '@nestjs/common';
-import OpenAI from 'openai';
-import type {
-  CompletionEvent,
-  CompletionParams,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-} from '@mosaicstack/types';
-
-const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
-
-interface OpenRouterModel {
-  id: string;
-  name?: string;
-  context_length?: number;
-  top_provider?: {
-    max_completion_tokens?: number;
-  };
-  pricing?: {
-    prompt?: string | number;
-    completion?: string | number;
-  };
-  architecture?: {
-    input_modalities?: string[];
-  };
-}
-
-interface OpenRouterModelsResponse {
-  data?: OpenRouterModel[];
-}
-
-/**
- * OpenRouter provider adapter.
- *
- * Routes completions through OpenRouter's OpenAI-compatible API.
- * Configuration is driven by the OPENROUTER_API_KEY environment variable.
- */
-export class OpenRouterAdapter implements IProviderAdapter {
-  readonly name = 'openrouter';
-
-  private readonly logger = new Logger(OpenRouterAdapter.name);
-  private client: OpenAI | null = null;
-  private registeredModels: ModelInfo[] = [];
-
-  async register(): Promise<void> {
-    const apiKey = process.env['OPENROUTER_API_KEY'];
-    if (!apiKey) {
-      this.logger.debug('Skipping OpenRouter provider registration: OPENROUTER_API_KEY not set');
-      return;
-    }
-
-    this.client = new OpenAI({
-      apiKey,
-      baseURL: OPENROUTER_BASE_URL,
-      defaultHeaders: {
-        'HTTP-Referer': 'https://mosaic.ai',
-        'X-Title': 'Mosaic',
-      },
-    });
-
-    try {
-      this.registeredModels = await this.fetchModels(apiKey);
-      this.logger.log(`OpenRouter provider registered with ${this.registeredModels.length} models`);
-    } catch (err) {
-      this.logger.warn(
-        `OpenRouter model discovery failed: ${err instanceof Error ? err.message : String(err)}. Registering with empty model list.`,
-      );
-      this.registeredModels = [];
-    }
-  }
-
-  listModels(): ModelInfo[] {
-    return this.registeredModels;
-  }
-
-  async healthCheck(): Promise<ProviderHealth> {
-    const apiKey = process.env['OPENROUTER_API_KEY'];
-    if (!apiKey) {
-      return {
-        status: 'down',
-        lastChecked: new Date().toISOString(),
-        error: 'OPENROUTER_API_KEY not configured',
-      };
-    }
-
-    const start = Date.now();
-    try {
-      const res = await fetch(`${OPENROUTER_BASE_URL}/models`, {
-        method: 'GET',
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          Accept: 'application/json',
-        },
-        signal: AbortSignal.timeout(5000),
-      });
-      const latencyMs = Date.now() - start;
-
-      if (!res.ok) {
-        return {
-          status: 'degraded',
-          latencyMs,
-          lastChecked: new Date().toISOString(),
-          error: `HTTP ${res.status}`,
-        };
-      }
-
-      return { status: 'healthy', latencyMs, lastChecked: new Date().toISOString() };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const error = err instanceof Error ? err.message : String(err);
-      return { status: 'down', latencyMs, lastChecked: new Date().toISOString(), error };
-    }
-  }
-
-  /**
-   * Stream a completion through OpenRouter's OpenAI-compatible API.
-   */
-  async *createCompletion(params: CompletionParams): AsyncIterable<CompletionEvent> {
-    if (!this.client) {
-      throw new Error('OpenRouterAdapter is not initialized. Ensure OPENROUTER_API_KEY is set.');
-    }
-
-    const stream = await this.client.chat.completions.create({
-      model: params.model,
-      messages: params.messages.map((m) => ({ role: m.role, content: m.content })),
-      temperature: params.temperature,
-      max_tokens: params.maxTokens,
-      stream: true,
-    });
-
-    let inputTokens = 0;
-    let outputTokens = 0;
-
-    for await (const chunk of stream) {
-      const choice = chunk.choices[0];
-      if (!choice) continue;
-
-      const delta = choice.delta;
-
-      if (delta.content) {
-        yield { type: 'text_delta', content: delta.content };
-      }
-
-      if (choice.finish_reason === 'stop') {
-        const usage = (chunk as { usage?: { prompt_tokens?: number; completion_tokens?: number } })
-          .usage;
-        if (usage) {
-          inputTokens = usage.prompt_tokens ?? 0;
-          outputTokens = usage.completion_tokens ?? 0;
-        }
-      }
-    }
-
-    yield {
-      type: 'done',
-      usage: { inputTokens, outputTokens },
-    };
-  }
-
-  // ---------------------------------------------------------------------------
-  // Private helpers
-  // ---------------------------------------------------------------------------
-
-  private async fetchModels(apiKey: string): Promise<ModelInfo[]> {
-    const res = await fetch(`${OPENROUTER_BASE_URL}/models`, {
-      method: 'GET',
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        Accept: 'application/json',
-      },
-      signal: AbortSignal.timeout(10000),
-    });
-
-    if (!res.ok) {
-      throw new Error(`OpenRouter models endpoint returned HTTP ${res.status}`);
-    }
-
-    const json = (await res.json()) as OpenRouterModelsResponse;
-    const data = json.data ?? [];
-
-    return data.map((model): ModelInfo => {
-      const inputPrice = model.pricing?.prompt
-        ? parseFloat(String(model.pricing.prompt)) * 1000
-        : 0;
-      const outputPrice = model.pricing?.completion
-        ? parseFloat(String(model.pricing.completion)) * 1000
-        : 0;
-
-      const inputModalities = model.architecture?.input_modalities ?? ['text'];
-      const inputTypes = inputModalities.includes('image')
-        ? (['text', 'image'] as const)
-        : (['text'] as const);
-
-      return {
-        id: model.id,
-        provider: 'openrouter',
-        name: model.name ?? model.id,
-        reasoning: false,
-        contextWindow: model.context_length ?? 4096,
-        maxTokens: model.top_provider?.max_completion_tokens ?? 4096,
-        inputTypes: [...inputTypes],
-        cost: {
-          input: inputPrice,
-          output: outputPrice,
-          cacheRead: 0,
-          cacheWrite: 0,
-        },
-      };
-    });
-  }
-}
@@ -1,187 +0,0 @@
-import { Logger } from '@nestjs/common';
-import OpenAI from 'openai';
-import type {
-  CompletionEvent,
-  CompletionParams,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-} from '@mosaicstack/types';
-import { getModelCapability } from '../model-capabilities.js';
-
-/**
- * Default Z.ai API base URL.
- * Z.ai (BigModel / Zhipu AI) exposes an OpenAI-compatible API at this endpoint.
- * Can be overridden via the ZAI_BASE_URL environment variable.
- */
-const DEFAULT_ZAI_BASE_URL = 'https://open.bigmodel.cn/api/paas/v4';
-
-/**
- * GLM-5 model identifier on the Z.ai platform.
- */
-const GLM5_MODEL_ID = 'glm-5';
-
-/**
- * Z.ai (Zhipu AI / BigModel) provider adapter.
- *
- * Z.ai exposes an OpenAI-compatible REST API. This adapter uses the `openai`
- * SDK with a custom base URL and the ZAI_API_KEY environment variable.
- *
- * Configuration:
- *   ZAI_API_KEY   — required; Z.ai API key
- *   ZAI_BASE_URL  — optional; override the default API base URL
- */
-export class ZaiAdapter implements IProviderAdapter {
-  readonly name = 'zai';
-
-  private readonly logger = new Logger(ZaiAdapter.name);
-  private client: OpenAI | null = null;
-  private registeredModels: ModelInfo[] = [];
-
-  async register(): Promise<void> {
-    const apiKey = process.env['ZAI_API_KEY'];
-    if (!apiKey) {
-      this.logger.debug('Skipping Z.ai provider registration: ZAI_API_KEY not set');
-      return;
-    }
-
-    const baseURL = process.env['ZAI_BASE_URL'] ?? DEFAULT_ZAI_BASE_URL;
-
-    this.client = new OpenAI({ apiKey, baseURL });
-
-    this.registeredModels = this.buildModelList();
-    this.logger.log(`Z.ai provider registered with ${this.registeredModels.length} model(s)`);
-  }
-
-  listModels(): ModelInfo[] {
-    return this.registeredModels;
-  }
-
-  async healthCheck(): Promise<ProviderHealth> {
-    const apiKey = process.env['ZAI_API_KEY'];
-    if (!apiKey) {
-      return {
-        status: 'down',
-        lastChecked: new Date().toISOString(),
-        error: 'ZAI_API_KEY not configured',
-      };
-    }
-
-    const baseURL = process.env['ZAI_BASE_URL'] ?? DEFAULT_ZAI_BASE_URL;
-    const start = Date.now();
-
-    try {
-      const res = await fetch(`${baseURL}/models`, {
-        method: 'GET',
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          Accept: 'application/json',
-        },
-        signal: AbortSignal.timeout(5000),
-      });
-      const latencyMs = Date.now() - start;
-
-      if (!res.ok) {
-        return {
-          status: 'degraded',
-          latencyMs,
-          lastChecked: new Date().toISOString(),
-          error: `HTTP ${res.status}`,
-        };
-      }
-
-      return { status: 'healthy', latencyMs, lastChecked: new Date().toISOString() };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const error = err instanceof Error ? err.message : String(err);
-      return { status: 'down', latencyMs, lastChecked: new Date().toISOString(), error };
-    }
-  }
-
-  /**
-   * Stream a completion through Z.ai's OpenAI-compatible API.
-   */
-  async *createCompletion(params: CompletionParams): AsyncIterable<CompletionEvent> {
-    if (!this.client) {
-      throw new Error('ZaiAdapter is not initialized. Ensure ZAI_API_KEY is set.');
-    }
-
-    const stream = await this.client.chat.completions.create({
-      model: params.model,
-      messages: params.messages.map((m) => ({ role: m.role, content: m.content })),
-      temperature: params.temperature,
-      max_tokens: params.maxTokens,
-      stream: true,
-    });
-
-    let inputTokens = 0;
-    let outputTokens = 0;
-
-    for await (const chunk of stream) {
-      const choice = chunk.choices[0];
-      if (!choice) continue;
-
-      const delta = choice.delta;
-
-      if (delta.content) {
-        yield { type: 'text_delta', content: delta.content };
-      }
-
-      if (choice.finish_reason === 'stop') {
-        const usage = (chunk as { usage?: { prompt_tokens?: number; completion_tokens?: number } })
-          .usage;
-        if (usage) {
-          inputTokens = usage.prompt_tokens ?? 0;
-          outputTokens = usage.completion_tokens ?? 0;
-        }
-      }
-    }
-
-    yield {
-      type: 'done',
-      usage: { inputTokens, outputTokens },
-    };
-  }
-
-  // ---------------------------------------------------------------------------
-  // Private helpers
-  // ---------------------------------------------------------------------------
-
-  private buildModelList(): ModelInfo[] {
-    const capability = getModelCapability(GLM5_MODEL_ID);
-
-    if (!capability) {
-      this.logger.warn(`Model capability entry not found for '${GLM5_MODEL_ID}'; using defaults`);
-      return [
-        {
-          id: GLM5_MODEL_ID,
-          provider: 'zai',
-          name: 'GLM-5',
-          reasoning: false,
-          contextWindow: 128000,
-          maxTokens: 8192,
-          inputTypes: ['text'],
-          cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-        },
-      ];
-    }
-
-    return [
-      {
-        id: capability.id,
-        provider: 'zai',
-        name: capability.displayName,
-        reasoning: capability.capabilities.reasoning,
-        contextWindow: capability.contextWindow,
-        maxTokens: capability.maxOutputTokens,
-        inputTypes: capability.capabilities.vision ? ['text', 'image'] : ['text'],
-        cost: {
-          input: capability.costPer1kInput ?? 0,
-          output: capability.costPer1kOutput ?? 0,
-          cacheRead: 0,
-          cacheWrite: 0,
-        },
-      },
-    ];
-  }
-}
@@ -1,197 +0,0 @@
-import {
-  IsArray,
-  IsBoolean,
-  IsIn,
-  IsObject,
-  IsOptional,
-  IsString,
-  IsUUID,
-  MaxLength,
-} from 'class-validator';
-
-const agentStatuses = ['idle', 'active', 'error', 'offline'] as const;
-
-// ─── Agent Capability Declarations (M4-011) ───────────────────────────────────
-
-/**
- * Agent specialization capability fields.
- * Stored inside the agent's `config` JSON as `capabilities`.
- */
-export class AgentCapabilitiesDto {
-  /**
-   * Domains this agent specializes in, e.g. ['frontend', 'backend', 'devops'].
-   * Used by the routing engine to bias toward this agent for matching domains.
-   */
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  domains?: string[];
-
-  /**
-   * Default model identifier for this agent.
-   * Influences routing when no explicit rule overrides the choice.
-   */
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredModel?: string;
-
-  /**
-   * Default provider for this agent.
-   * Influences routing when no explicit rule overrides the choice.
-   */
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredProvider?: string;
-
-  /**
-   * Tool categories this agent has access to, e.g. ['web-search', 'code-exec'].
-   */
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  toolSets?: string[];
-}
-
-// ─── Create DTO ───────────────────────────────────────────────────────────────
-
-export class CreateAgentConfigDto {
-  @IsString()
-  @MaxLength(255)
-  name!: string;
-
-  @IsString()
-  @MaxLength(255)
-  provider!: string;
-
-  @IsString()
-  @MaxLength(255)
-  model!: string;
-
-  @IsOptional()
-  @IsIn(agentStatuses)
-  status?: 'idle' | 'active' | 'error' | 'offline';
-
-  @IsOptional()
-  @IsUUID()
-  projectId?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(50_000)
-  systemPrompt?: string;
-
-  @IsOptional()
-  @IsArray()
-  allowedTools?: string[];
-
-  @IsOptional()
-  @IsArray()
-  skills?: string[];
-
-  @IsOptional()
-  @IsBoolean()
-  isSystem?: boolean;
-
-  /**
-   * General config blob. May include `capabilities` (AgentCapabilitiesDto)
-   * for agent specialization declarations (M4-011).
-   */
-  @IsOptional()
-  @IsObject()
-  config?: Record<string, unknown>;
-
-  // ─── Capability shorthand fields (M4-011) ──────────────────────────────────
-  // These are convenience top-level fields that get merged into config.capabilities.
-
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  domains?: string[];
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredModel?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredProvider?: string;
-
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  toolSets?: string[];
-}
-
-// ─── Update DTO ───────────────────────────────────────────────────────────────
-
-export class UpdateAgentConfigDto {
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  name?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  provider?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  model?: string;
-
-  @IsOptional()
-  @IsIn(agentStatuses)
-  status?: 'idle' | 'active' | 'error' | 'offline';
-
-  @IsOptional()
-  @IsUUID()
-  projectId?: string | null;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(50_000)
-  systemPrompt?: string | null;
-
-  @IsOptional()
-  @IsArray()
-  allowedTools?: string[] | null;
-
-  @IsOptional()
-  @IsArray()
-  skills?: string[] | null;
-
-  /**
-   * General config blob. May include `capabilities` (AgentCapabilitiesDto)
-   * for agent specialization declarations (M4-011).
-   */
-  @IsOptional()
-  @IsObject()
-  config?: Record<string, unknown> | null;
-
-  // ─── Capability shorthand fields (M4-011) ──────────────────────────────────
-
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  domains?: string[] | null;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredModel?: string | null;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  preferredProvider?: string | null;
-
-  @IsOptional()
-  @IsArray()
-  @IsString({ each: true })
-  toolSets?: string[] | null;
-}
@@ -1,170 +0,0 @@
-import {
-  Body,
-  Controller,
-  Delete,
-  ForbiddenException,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  NotFoundException,
-  Param,
-  Patch,
-  Post,
-  UseGuards,
-} from '@nestjs/common';
-import type { Brain } from '@mosaicstack/brain';
-import { BRAIN } from '../brain/brain.tokens.js';
-import { AuthGuard } from '../auth/auth.guard.js';
-import { CurrentUser } from '../auth/current-user.decorator.js';
-import { CreateAgentConfigDto, UpdateAgentConfigDto } from './agent-config.dto.js';
-
-// ─── M4-011 helpers ──────────────────────────────────────────────────────────
-
-type CapabilityFields = {
-  domains?: string[] | null;
-  preferredModel?: string | null;
-  preferredProvider?: string | null;
-  toolSets?: string[] | null;
-};
-
-/** Extract capability shorthand fields from the DTO (undefined if none provided). */
-function buildCapabilities(dto: CapabilityFields): Record<string, unknown> | undefined {
-  const hasAny =
-    dto.domains !== undefined ||
-    dto.preferredModel !== undefined ||
-    dto.preferredProvider !== undefined ||
-    dto.toolSets !== undefined;
-
-  if (!hasAny) return undefined;
-
-  const cap: Record<string, unknown> = {};
-  if (dto.domains !== undefined) cap['domains'] = dto.domains;
-  if (dto.preferredModel !== undefined) cap['preferredModel'] = dto.preferredModel;
-  if (dto.preferredProvider !== undefined) cap['preferredProvider'] = dto.preferredProvider;
-  if (dto.toolSets !== undefined) cap['toolSets'] = dto.toolSets;
-  return cap;
-}
-
-/** Merge capabilities into the config object, preserving other config keys. */
-function mergeCapabilities(
-  existing: Record<string, unknown> | null | undefined,
-  capabilities: Record<string, unknown> | undefined,
-): Record<string, unknown> | undefined {
-  if (capabilities === undefined && existing === undefined) return undefined;
-  if (capabilities === undefined) return existing ?? undefined;
-
-  const base = existing ?? {};
-  const existingCap =
-    typeof base['capabilities'] === 'object' && base['capabilities'] !== null
-      ? (base['capabilities'] as Record<string, unknown>)
-      : {};
-
-  return {
-    ...base,
-    capabilities: { ...existingCap, ...capabilities },
-  };
-}
-
-@Controller('api/agents')
-@UseGuards(AuthGuard)
-export class AgentConfigsController {
-  constructor(@Inject(BRAIN) private readonly brain: Brain) {}
-
-  @Get()
-  async list(@CurrentUser() user: { id: string; role?: string }) {
-    return this.brain.agents.findAccessible(user.id);
-  }
-
-  @Get(':id')
-  async findOne(@Param('id') id: string, @CurrentUser() user: { id: string }) {
-    const agent = await this.brain.agents.findById(id);
-    if (!agent) throw new NotFoundException('Agent not found');
-    if (!agent.isSystem && agent.ownerId !== user.id) {
-      throw new ForbiddenException('Agent does not belong to the current user');
-    }
-    return agent;
-  }
-
-  @Post()
-  async create(@Body() dto: CreateAgentConfigDto, @CurrentUser() user: { id: string }) {
-    // Merge capability shorthand fields into config.capabilities (M4-011)
-    const capabilities = buildCapabilities(dto);
-    const config = mergeCapabilities(dto.config, capabilities);
-
-    return this.brain.agents.create({
-      name: dto.name,
-      provider: dto.provider,
-      model: dto.model,
-      status: dto.status,
-      projectId: dto.projectId,
-      systemPrompt: dto.systemPrompt,
-      allowedTools: dto.allowedTools,
-      skills: dto.skills,
-      isSystem: false,
-      config,
-      ownerId: user.id,
-    });
-  }
-
-  @Patch(':id')
-  async update(
-    @Param('id') id: string,
-    @Body() dto: UpdateAgentConfigDto,
-    @CurrentUser() user: { id: string; role?: string },
-  ) {
-    const agent = await this.brain.agents.findById(id);
-    if (!agent) throw new NotFoundException('Agent not found');
-    if (agent.isSystem && user.role !== 'admin') {
-      throw new ForbiddenException('Only admins can update system agents');
-    }
-    if (!agent.isSystem && agent.ownerId !== user.id) {
-      throw new ForbiddenException('Agent does not belong to the current user');
-    }
-
-    // Merge capability shorthand fields into config.capabilities (M4-011)
-    const capabilities = buildCapabilities(dto);
-    const baseConfig =
-      dto.config !== undefined
-        ? dto.config
-        : (agent.config as Record<string, unknown> | null | undefined);
-    const config = mergeCapabilities(baseConfig ?? undefined, capabilities);
-
-    // Pass ownerId for user agents so the repo WHERE clause enforces ownership.
-    // For system agents (admin path) pass undefined so the WHERE matches only on id.
-    const ownerId = agent.isSystem ? undefined : user.id;
-    const updated = await this.brain.agents.update(
-      id,
-      {
-        name: dto.name,
-        provider: dto.provider,
-        model: dto.model,
-        status: dto.status,
-        projectId: dto.projectId,
-        systemPrompt: dto.systemPrompt,
-        allowedTools: dto.allowedTools,
-        skills: dto.skills,
-        config: capabilities !== undefined || dto.config !== undefined ? config : undefined,
-      },
-      ownerId,
-    );
-    if (!updated) throw new NotFoundException('Agent not found');
-    return updated;
-  }
-
-  @Delete(':id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  async remove(@Param('id') id: string, @CurrentUser() user: { id: string; role?: string }) {
-    const agent = await this.brain.agents.findById(id);
-    if (!agent) throw new NotFoundException('Agent not found');
-    if (agent.isSystem) {
-      throw new ForbiddenException('Cannot delete system agents');
-    }
-    if (agent.ownerId !== user.id) {
-      throw new ForbiddenException('Agent does not belong to the current user');
-    }
-    // Pass ownerId so the repo WHERE clause enforces ownership at the DB level.
-    const deleted = await this.brain.agents.remove(id, user.id);
-    if (!deleted) throw new NotFoundException('Agent not found');
-  }
-}
@@ -1,38 +0,0 @@
-import { Global, Module } from '@nestjs/common';
-import { AgentService } from './agent.service.js';
-import { ProviderService } from './provider.service.js';
-import { ProviderCredentialsService } from './provider-credentials.service.js';
-import { RoutingService } from './routing.service.js';
-import { RoutingEngineService } from './routing/routing-engine.service.js';
-import { SkillLoaderService } from './skill-loader.service.js';
-import { ProvidersController } from './providers.controller.js';
-import { SessionsController } from './sessions.controller.js';
-import { AgentConfigsController } from './agent-configs.controller.js';
-import { RoutingController } from './routing/routing.controller.js';
-import { CoordModule } from '../coord/coord.module.js';
-import { McpClientModule } from '../mcp-client/mcp-client.module.js';
-import { SkillsModule } from '../skills/skills.module.js';
-import { GCModule } from '../gc/gc.module.js';
-
-@Global()
-@Module({
-  imports: [CoordModule, McpClientModule, SkillsModule, GCModule],
-  providers: [
-    ProviderService,
-    ProviderCredentialsService,
-    RoutingService,
-    RoutingEngineService,
-    SkillLoaderService,
-    AgentService,
-  ],
-  controllers: [ProvidersController, SessionsController, AgentConfigsController, RoutingController],
-  exports: [
-    AgentService,
-    ProviderService,
-    ProviderCredentialsService,
-    RoutingService,
-    RoutingEngineService,
-    SkillLoaderService,
-  ],
-})
-export class AgentModule {}
@@ -1,678 +0,0 @@
-import { Inject, Injectable, Logger, Optional, type OnModuleDestroy } from '@nestjs/common';
-import {
-  createAgentSession,
-  DefaultResourceLoader,
-  SessionManager,
-  type AgentSession as PiAgentSession,
-  type AgentSessionEvent,
-  type ToolDefinition,
-} from '@mariozechner/pi-coding-agent';
-import type { Brain } from '@mosaicstack/brain';
-import type { Memory } from '@mosaicstack/memory';
-import { BRAIN } from '../brain/brain.tokens.js';
-import { MEMORY } from '../memory/memory.tokens.js';
-import { EmbeddingService } from '../memory/embedding.service.js';
-import { CoordService } from '../coord/coord.service.js';
-import { ProviderService } from './provider.service.js';
-import { McpClientService } from '../mcp-client/mcp-client.service.js';
-import { SkillLoaderService } from './skill-loader.service.js';
-import { createBrainTools } from './tools/brain-tools.js';
-import { createCoordTools } from './tools/coord-tools.js';
-import { createMemoryTools } from './tools/memory-tools.js';
-import { createFileTools } from './tools/file-tools.js';
-import { createGitTools } from './tools/git-tools.js';
-import { createShellTools } from './tools/shell-tools.js';
-import { createWebTools } from './tools/web-tools.js';
-import { createSearchTools } from './tools/search-tools.js';
-import type { SessionInfoDto, SessionMetrics } from './session.dto.js';
-import { SystemOverrideService } from '../preferences/system-override.service.js';
-import { PreferencesService } from '../preferences/preferences.service.js';
-import { SessionGCService } from '../gc/session-gc.service.js';
-
-/** A single message from DB conversation history, used for context injection. */
-export interface ConversationHistoryMessage {
-  role: 'user' | 'assistant' | 'system';
-  content: string;
-  createdAt: Date;
-}
-
-export interface AgentSessionOptions {
-  provider?: string;
-  modelId?: string;
-  /**
-   * Sandbox working directory for the session.
-   * File, git, and shell tools will be restricted to this directory.
-   * Falls back to AGENT_FILE_SANDBOX_DIR env var or process.cwd().
-   */
-  sandboxDir?: string;
-  /**
-   * Platform-level system prompt for this session.
-   * Merged with skill prompt additions (platform prompt first, then skills).
-   * Falls back to AGENT_SYSTEM_PROMPT env var when omitted.
-   */
-  systemPrompt?: string;
-  /**
-   * Explicit allowlist of tool names available in this session.
-   * When set, only listed tools are registered with the agent.
-   * When omitted for non-admin users, falls back to AGENT_USER_TOOLS env var.
-   * Admins (isAdmin=true) always receive the full tool set unless explicitly restricted.
-   */
-  allowedTools?: string[];
-  /** Whether the requesting user has admin privileges. Controls default tool access. */
-  isAdmin?: boolean;
-  /**
-   * DB agent config ID. When provided, loads agent config from DB and merges
-   * provider, model, systemPrompt, and allowedTools. Explicit call-site options
-   * take precedence over config values.
-   */
-  agentConfigId?: string;
-  /** ID of the user who owns this session. Used for preferences and system override lookups. */
-  userId?: string;
-  /**
-   * Prior conversation messages to inject as context when resuming a session.
-   * These messages are formatted and prepended to the system prompt so the
-   * agent is aware of what was discussed in previous sessions.
-   */
-  conversationHistory?: ConversationHistoryMessage[];
-}
-
-export interface AgentSession {
-  id: string;
-  provider: string;
-  modelId: string;
-  piSession: PiAgentSession;
-  listeners: Set<(event: AgentSessionEvent) => void>;
-  unsubscribe: () => void;
-  createdAt: number;
-  promptCount: number;
-  channels: Set<string>;
-  /** System prompt additions injected from enabled prompt-type skills. */
-  skillPromptAdditions: string[];
-  /** Resolved sandbox directory for this session. */
-  sandboxDir: string;
-  /** Tool names available in this session, or null when all tools are available. */
-  allowedTools: string[] | null;
-  /** User ID that owns this session, used for preference lookups. */
-  userId?: string;
-  /** Agent config ID applied to this session, if any (M5-001). */
-  agentConfigId?: string;
-  /** Human-readable agent name applied to this session, if any (M5-001). */
-  agentName?: string;
-  /** M5-007: per-session metrics. */
-  metrics: SessionMetrics;
-}
-
-@Injectable()
-export class AgentService implements OnModuleDestroy {
-  private readonly logger = new Logger(AgentService.name);
-  private readonly sessions = new Map<string, AgentSession>();
-  private readonly creating = new Map<string, Promise<AgentSession>>();
-
-  constructor(
-    @Inject(ProviderService) private readonly providerService: ProviderService,
-    @Inject(BRAIN) private readonly brain: Brain,
-    @Inject(MEMORY) private readonly memory: Memory,
-    @Inject(EmbeddingService) private readonly embeddingService: EmbeddingService,
-    @Inject(CoordService) private readonly coordService: CoordService,
-    @Inject(McpClientService) private readonly mcpClientService: McpClientService,
-    @Inject(SkillLoaderService) private readonly skillLoaderService: SkillLoaderService,
-    @Optional()
-    @Inject(SystemOverrideService)
-    private readonly systemOverride: SystemOverrideService | null,
-    @Optional()
-    @Inject(PreferencesService)
-    private readonly preferencesService: PreferencesService | null,
-    @Inject(SessionGCService) private readonly gc: SessionGCService,
-  ) {}
-
-  /**
-   * Build the full set of custom tools scoped to the given sandbox directory and session user.
-   * Brain/coord/memory/web tools are stateless with respect to cwd; file/git/shell
-   * tools receive the resolved sandboxDir so they operate within the sandbox.
-   * Memory tools are bound to sessionUserId so the LLM cannot access another user's data.
-   */
-  private buildToolsForSandbox(
-    sandboxDir: string,
-    sessionUserId: string | undefined,
-  ): ToolDefinition[] {
-    return [
-      ...createBrainTools(this.brain),
-      ...createCoordTools(this.coordService),
-      ...createMemoryTools(
-        this.memory,
-        this.embeddingService.available ? this.embeddingService : null,
-        sessionUserId,
-      ),
-      ...createFileTools(sandboxDir),
-      ...createGitTools(sandboxDir),
-      ...createShellTools(sandboxDir),
-      ...createWebTools(),
-      ...createSearchTools(),
-    ];
-  }
-
-  /**
-   * Resolve the tool allowlist for a session.
-   * - Admin users: all tools unless an explicit allowedTools list is passed.
-   * - Regular users: use allowedTools if provided, otherwise parse AGENT_USER_TOOLS env var.
-   * Returns null when all tools should be available.
-   */
-  private resolveAllowedTools(isAdmin: boolean, allowedTools?: string[]): string[] | null {
-    if (allowedTools !== undefined) {
-      return allowedTools.length === 0 ? [] : allowedTools;
-    }
-    if (isAdmin) {
-      return null; // admins get everything
-    }
-    const envTools = process.env['AGENT_USER_TOOLS'];
-    if (!envTools) {
-      return null; // no restriction configured
-    }
-    return envTools
-      .split(',')
-      .map((t) => t.trim())
-      .filter((t) => t.length > 0);
-  }
-
-  async createSession(sessionId: string, options?: AgentSessionOptions): Promise<AgentSession> {
-    const existing = this.sessions.get(sessionId);
-    if (existing) return existing;
-
-    const inflight = this.creating.get(sessionId);
-    if (inflight) return inflight;
-
-    const promise = this.doCreateSession(sessionId, options).finally(() => {
-      this.creating.delete(sessionId);
-    });
-    this.creating.set(sessionId, promise);
-    return promise;
-  }
-
-  private async doCreateSession(
-    sessionId: string,
-    options?: AgentSessionOptions,
-  ): Promise<AgentSession> {
-    // Merge DB agent config when agentConfigId is provided (M5-001)
-    let mergedOptions = options;
-    let resolvedAgentName: string | undefined;
-    if (options?.agentConfigId) {
-      const agentConfig = await this.brain.agents.findById(options.agentConfigId);
-      if (agentConfig) {
-        resolvedAgentName = agentConfig.name;
-        mergedOptions = {
-          provider: options.provider ?? agentConfig.provider,
-          modelId: options.modelId ?? agentConfig.model,
-          systemPrompt: options.systemPrompt ?? agentConfig.systemPrompt ?? undefined,
-          allowedTools: options.allowedTools ?? agentConfig.allowedTools ?? undefined,
-          sandboxDir: options.sandboxDir,
-          isAdmin: options.isAdmin,
-          agentConfigId: options.agentConfigId,
-          userId: options.userId,
-          conversationHistory: options.conversationHistory,
-        };
-        this.logger.log(
-          `Merged agent config "${agentConfig.name}" (${agentConfig.id}) into session ${sessionId}`,
-        );
-      }
-    }
-
-    const model = this.resolveModel(mergedOptions);
-    const providerName = model?.provider ?? 'default';
-    const modelId = model?.id ?? 'default';
-
-    // Resolve sandbox directory: option > env var > process.cwd()
-    const sandboxDir =
-      mergedOptions?.sandboxDir ?? process.env['AGENT_FILE_SANDBOX_DIR'] ?? process.cwd();
-
-    // Resolve allowed tool set
-    const allowedTools = this.resolveAllowedTools(
-      mergedOptions?.isAdmin ?? false,
-      mergedOptions?.allowedTools,
-    );
-
-    this.logger.log(
-      `Creating agent session: ${sessionId} (provider=${providerName}, model=${modelId}, sandbox=${sandboxDir}, tools=${allowedTools === null ? 'all' : allowedTools.join(',') || 'none'})`,
-    );
-
-    // Load skill tools from the catalog
-    const { metaTools: skillMetaTools, promptAdditions } =
-      await this.skillLoaderService.loadForSession();
-    if (skillMetaTools.length > 0) {
-      this.logger.log(`Attaching ${skillMetaTools.length} skill tool(s) to session ${sessionId}`);
-    }
-    if (promptAdditions.length > 0) {
-      this.logger.log(
-        `Injecting ${promptAdditions.length} skill prompt addition(s) into session ${sessionId}`,
-      );
-    }
-
-    // Build per-session tools scoped to the sandbox directory and authenticated user
-    const sandboxTools = this.buildToolsForSandbox(sandboxDir, mergedOptions?.userId);
-
-    // Combine static tools with dynamically discovered MCP client tools and skill tools
-    const mcpTools = this.mcpClientService.getToolDefinitions();
-    let allCustomTools = [...sandboxTools, ...skillMetaTools, ...mcpTools];
-    if (mcpTools.length > 0) {
-      this.logger.log(`Attaching ${mcpTools.length} MCP client tool(s) to session ${sessionId}`);
-    }
-
-    // Filter tools by allowlist when a restriction is in effect
-    if (allowedTools !== null) {
-      const allowedSet = new Set(allowedTools);
-      const before = allCustomTools.length;
-      allCustomTools = allCustomTools.filter((t) => allowedSet.has(t.name));
-      this.logger.log(
-        `Tool restriction applied: ${allCustomTools.length}/${before} tools allowed for session ${sessionId}`,
-      );
-    }
-
-    // Build system prompt: platform prompt + skill additions appended
-    const platformPrompt =
-      mergedOptions?.systemPrompt ?? process.env['AGENT_SYSTEM_PROMPT'] ?? undefined;
-
-    // Format conversation history for context injection (M1-004 / M1-005)
-    const historyPromptSection = mergedOptions?.conversationHistory?.length
-      ? this.buildHistoryPromptSection(
-          mergedOptions.conversationHistory,
-          model?.contextWindow ?? 8192,
-          sessionId,
-        )
-      : undefined;
-
-    const appendParts: string[] = [];
-    if (promptAdditions.length > 0) appendParts.push(promptAdditions.join('\n\n'));
-    if (historyPromptSection) appendParts.push(historyPromptSection);
-    const appendSystemPrompt = appendParts.length > 0 ? appendParts.join('\n\n') : undefined;
-
-    // Construct a resource loader that injects the configured system prompt
-    const resourceLoader = new DefaultResourceLoader({
-      cwd: sandboxDir,
-      noExtensions: true,
-      noSkills: true,
-      noPromptTemplates: true,
-      noThemes: true,
-      systemPrompt: platformPrompt,
-      appendSystemPrompt: appendSystemPrompt,
-    });
-    await resourceLoader.reload();
-
-    let piSession: PiAgentSession;
-    try {
-      const result = await createAgentSession({
-        sessionManager: SessionManager.inMemory(),
-        modelRegistry: this.providerService.getRegistry(),
-        model: model ?? undefined,
-        cwd: sandboxDir,
-        tools: [],
-        customTools: allCustomTools,
-        resourceLoader,
-      });
-      piSession = result.session;
-    } catch (err) {
-      this.logger.error(
-        `Failed to create agent session for ${sessionId}`,
-        err instanceof Error ? err.stack : String(err),
-      );
-      throw new Error(`Agent session creation failed for ${sessionId}: ${String(err)}`);
-    }
-
-    const listeners = new Set<(event: AgentSessionEvent) => void>();
-
-    const unsubscribe = piSession.subscribe((event) => {
-      for (const listener of listeners) {
-        try {
-          listener(event);
-        } catch (err) {
-          this.logger.error(`Event listener error in session ${sessionId}`, err);
-        }
-      }
-    });
-
-    const session: AgentSession = {
-      id: sessionId,
-      provider: providerName,
-      modelId,
-      piSession,
-      listeners,
-      unsubscribe,
-      createdAt: Date.now(),
-      promptCount: 0,
-      channels: new Set(),
-      skillPromptAdditions: promptAdditions,
-      sandboxDir,
-      allowedTools,
-      userId: mergedOptions?.userId,
-      agentConfigId: mergedOptions?.agentConfigId,
-      agentName: resolvedAgentName,
-      metrics: {
-        tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-        modelSwitches: 0,
-        messageCount: 0,
-        lastActivityAt: new Date().toISOString(),
-      },
-    };
-
-    this.sessions.set(sessionId, session);
-    this.logger.log(`Agent session ${sessionId} ready (${providerName}/${modelId})`);
-    if (resolvedAgentName) {
-      this.logger.log(
-        `Agent session ${sessionId} using agent config "${resolvedAgentName}" (M5-001)`,
-      );
-    }
-
-    return session;
-  }
-
-  /**
-   * Estimate token count for a string using a rough 4-chars-per-token heuristic.
-   */
-  private estimateTokens(text: string): number {
-    return Math.ceil(text.length / 4);
-  }
-
-  /**
-   * Build a conversation history section for injection into the system prompt.
-   * Implements M1-004 (history loading) and M1-005 (context window management).
-   *
-   * - Formats messages as a readable conversation transcript.
-   * - If the full history exceeds 80% of the model's context window, older messages
-   *   are summarized and only the most recent messages are kept verbatim.
-   * - Summarization is a simple extractive approach (no LLM required).
-   */
-  private buildHistoryPromptSection(
-    history: ConversationHistoryMessage[],
-    contextWindow: number,
-    sessionId: string,
-  ): string {
-    const TOKEN_BUDGET = Math.floor(contextWindow * 0.8);
-    const HISTORY_HEADER = '## Conversation History (resumed session)\n\n';
-
-    const formatMessage = (msg: ConversationHistoryMessage): string => {
-      const roleLabel =
-        msg.role === 'user' ? 'User' : msg.role === 'assistant' ? 'Assistant' : 'System';
-      return `**${roleLabel}:** ${msg.content}`;
-    };
-
-    const formatted = history.map((msg) => formatMessage(msg));
-    const fullHistory = formatted.join('\n\n');
-    const fullTokens = this.estimateTokens(HISTORY_HEADER + fullHistory);
-
-    if (fullTokens <= TOKEN_BUDGET) {
-      this.logger.debug(
-        `Session ${sessionId}: injecting full history (${history.length} msgs, ~${fullTokens} tokens)`,
-      );
-      return HISTORY_HEADER + fullHistory;
-    }
-
-    // History exceeds budget — summarize oldest messages, keep recent verbatim
-    this.logger.log(
-      `Session ${sessionId}: history (~${fullTokens} tokens) exceeds ${TOKEN_BUDGET} token budget; summarizing oldest messages`,
-    );
-
-    // Reserve 20% of the budget for the summary prefix, rest for verbatim messages
-    const SUMMARY_RESERVE = Math.floor(TOKEN_BUDGET * 0.2);
-    const verbatimBudget = TOKEN_BUDGET - SUMMARY_RESERVE;
-
-    let verbatimTokens = 0;
-    let verbatimCutIndex = history.length;
-    for (let i = history.length - 1; i >= 0; i--) {
-      const t = this.estimateTokens(formatted[i]!);
-      if (verbatimTokens + t > verbatimBudget) break;
-      verbatimTokens += t;
-      verbatimCutIndex = i;
-    }
-
-    const summarizedMessages = history.slice(0, verbatimCutIndex);
-    const verbatimMessages = history.slice(verbatimCutIndex);
-
-    let summaryText = '';
-    if (summarizedMessages.length > 0) {
-      const topics = summarizedMessages
-        .filter((m) => m.role === 'user')
-        .map((m) => m.content.slice(0, 120).replace(/\n/g, ' '))
-        .join('; ');
-      summaryText =
-        `**Previous conversation summary** (${summarizedMessages.length} messages omitted for brevity):\n` +
-        `Topics discussed: ${topics || '(no user messages in summarized portion)'}`;
-    }
-
-    const verbatimSection = verbatimMessages.map((m) => formatMessage(m)).join('\n\n');
-
-    const parts: string[] = [HISTORY_HEADER];
-    if (summaryText) parts.push(summaryText);
-    if (verbatimSection) parts.push(verbatimSection);
-
-    const result = parts.join('\n\n');
-    this.logger.log(
-      `Session ${sessionId}: summarized ${summarizedMessages.length} messages, kept ${verbatimMessages.length} verbatim (~${this.estimateTokens(result)} tokens)`,
-    );
-    return result;
-  }
-
-  private resolveModel(options?: AgentSessionOptions) {
-    if (!options?.provider && !options?.modelId) {
-      return this.providerService.getDefaultModel() ?? null;
-    }
-
-    if (options.provider && options.modelId) {
-      const model = this.providerService.findModel(options.provider, options.modelId);
-      if (!model) {
-        throw new Error(`Model not found: ${options.provider}/${options.modelId}`);
-      }
-      return model;
-    }
-
-    if (options.modelId) {
-      const available = this.providerService.listAvailableModels();
-      const match = available.find((m) => m.id === options.modelId);
-      if (match) {
-        return this.providerService.findModel(match.provider, match.id) ?? null;
-      }
-    }
-
-    return this.providerService.getDefaultModel() ?? null;
-  }
-
-  getSession(sessionId: string): AgentSession | undefined {
-    return this.sessions.get(sessionId);
-  }
-
-  listSessions(): SessionInfoDto[] {
-    const now = Date.now();
-    return Array.from(this.sessions.values()).map((s) => ({
-      id: s.id,
-      provider: s.provider,
-      modelId: s.modelId,
-      ...(s.agentName ? { agentName: s.agentName } : {}),
-      createdAt: new Date(s.createdAt).toISOString(),
-      promptCount: s.promptCount,
-      channels: Array.from(s.channels),
-      durationMs: now - s.createdAt,
-      metrics: { ...s.metrics },
-    }));
-  }
-
-  getSessionInfo(sessionId: string): SessionInfoDto | undefined {
-    const s = this.sessions.get(sessionId);
-    if (!s) return undefined;
-    return {
-      id: s.id,
-      provider: s.provider,
-      modelId: s.modelId,
-      ...(s.agentName ? { agentName: s.agentName } : {}),
-      createdAt: new Date(s.createdAt).toISOString(),
-      promptCount: s.promptCount,
-      channels: Array.from(s.channels),
-      durationMs: Date.now() - s.createdAt,
-      metrics: { ...s.metrics },
-    };
-  }
-
-  /**
-   * Record token usage for a session turn (M5-007).
-   * Accumulates tokens across the session lifetime.
-   */
-  recordTokenUsage(
-    sessionId: string,
-    tokens: { input: number; output: number; cacheRead: number; cacheWrite: number; total: number },
-  ): void {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    session.metrics.tokens.input += tokens.input;
-    session.metrics.tokens.output += tokens.output;
-    session.metrics.tokens.cacheRead += tokens.cacheRead;
-    session.metrics.tokens.cacheWrite += tokens.cacheWrite;
-    session.metrics.tokens.total += tokens.total;
-    session.metrics.lastActivityAt = new Date().toISOString();
-  }
-
-  /**
-   * Record a model switch event for a session (M5-007).
-   */
-  recordModelSwitch(sessionId: string): void {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    session.metrics.modelSwitches += 1;
-    session.metrics.lastActivityAt = new Date().toISOString();
-  }
-
-  /**
-   * Increment message count for a session (M5-007).
-   */
-  recordMessage(sessionId: string): void {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    session.metrics.messageCount += 1;
-    session.metrics.lastActivityAt = new Date().toISOString();
-  }
-
-  /**
-   * Update the model tracked on a live session (M5-002).
-   * This records the model change in the session metadata so subsequent
-   * session:info emissions reflect the new model.  The Pi session itself is
-   * not reconstructed — the model is used on the next createSession call for
-   * the same conversationId when the session is torn down or a new one is created.
-   */
-  updateSessionModel(sessionId: string, modelId: string): void {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    const prev = session.modelId;
-    session.modelId = modelId;
-    this.recordModelSwitch(sessionId);
-    this.logger.log(`Session ${sessionId}: model updated ${prev} → ${modelId} (M5-002)`);
-  }
-
-  /**
-   * Apply a new agent config to a live session mid-conversation (M5-003).
-   * Updates agentName, agentConfigId, and modelId on the session object.
-   * System prompt and tools take effect when the next session is created for
-   * this conversationId (they are baked in at session creation time).
-   */
-  applyAgentConfig(
-    sessionId: string,
-    agentConfigId: string,
-    agentName: string,
-    modelId?: string,
-  ): void {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    session.agentConfigId = agentConfigId;
-    session.agentName = agentName;
-    if (modelId) {
-      this.updateSessionModel(sessionId, modelId);
-    }
-    this.logger.log(
-      `Session ${sessionId}: agent switched to "${agentName}" (${agentConfigId}) (M5-003)`,
-    );
-  }
-
-  addChannel(sessionId: string, channel: string): void {
-    const session = this.sessions.get(sessionId);
-    if (session) {
-      session.channels.add(channel);
-    }
-  }
-
-  removeChannel(sessionId: string, channel: string): void {
-    const session = this.sessions.get(sessionId);
-    if (session) {
-      session.channels.delete(channel);
-    }
-  }
-
-  async prompt(sessionId: string, message: string): Promise<void> {
-    const session = this.sessions.get(sessionId);
-    if (!session) {
-      throw new Error(`No agent session found: ${sessionId}`);
-    }
-    session.promptCount += 1;
-
-    // Prepend session-scoped system override if present (renew TTL on each turn)
-    let effectiveMessage = message;
-    if (this.systemOverride) {
-      const override = await this.systemOverride.get(sessionId);
-      if (override) {
-        effectiveMessage = `[System Override]\n${override}\n\n${message}`;
-        await this.systemOverride.renew(sessionId);
-        this.logger.debug(`Applied system override for session ${sessionId}`);
-      }
-    }
-
-    try {
-      await session.piSession.prompt(effectiveMessage);
-    } catch (err) {
-      this.logger.error(
-        `Prompt failed for session=${sessionId}, messageLength=${message.length}`,
-        err instanceof Error ? err.stack : String(err),
-      );
-      throw err;
-    }
-  }
-
-  onEvent(sessionId: string, listener: (event: AgentSessionEvent) => void): () => void {
-    const session = this.sessions.get(sessionId);
-    if (!session) {
-      throw new Error(`No agent session found: ${sessionId}`);
-    }
-    session.listeners.add(listener);
-    return () => session.listeners.delete(listener);
-  }
-
-  async destroySession(sessionId: string): Promise<void> {
-    const session = this.sessions.get(sessionId);
-    if (!session) return;
-    this.logger.log(`Destroying agent session ${sessionId}`);
-    try {
-      session.unsubscribe();
-    } catch (err) {
-      this.logger.error(`Failed to unsubscribe session ${sessionId}`, String(err));
-    }
-    try {
-      session.piSession.dispose();
-    } catch (err) {
-      this.logger.error(`Failed to dispose piSession for ${sessionId}`, String(err));
-    }
-    session.listeners.clear();
-    session.channels.clear();
-    this.sessions.delete(sessionId);
-
-    // Run GC cleanup for this session (fire and forget, errors are logged)
-    this.gc.collect(sessionId).catch((err: unknown) => {
-      this.logger.error(
-        `GC collect failed for session ${sessionId}`,
-        err instanceof Error ? err.stack : String(err),
-      );
-    });
-  }
-
-  async onModuleDestroy(): Promise<void> {
-    this.logger.log('Shutting down all agent sessions');
-    const stops = Array.from(this.sessions.keys()).map((id) => this.destroySession(id));
-    const results = await Promise.allSettled(stops);
-    for (const result of results) {
-      if (result.status === 'rejected') {
-        this.logger.error('Session shutdown failure', String(result.reason));
-      }
-    }
-  }
-}
@@ -1,204 +0,0 @@
-import type { ModelCapability } from '@mosaicstack/types';
-
-/**
- * Comprehensive capability matrix for all target models.
- * Cost fields are optional and will be filled in when real pricing data is available.
- */
-export const MODEL_CAPABILITIES: ModelCapability[] = [
-  {
-    id: 'claude-opus-4-6',
-    provider: 'anthropic',
-    displayName: 'Claude Opus 4.6',
-    tier: 'premium',
-    contextWindow: 200000,
-    maxOutputTokens: 32000,
-    capabilities: {
-      tools: true,
-      vision: true,
-      streaming: true,
-      reasoning: true,
-      embedding: false,
-    },
-  },
-  {
-    id: 'claude-sonnet-4-6',
-    provider: 'anthropic',
-    displayName: 'Claude Sonnet 4.6',
-    tier: 'standard',
-    contextWindow: 200000,
-    maxOutputTokens: 16000,
-    capabilities: {
-      tools: true,
-      vision: true,
-      streaming: true,
-      reasoning: true,
-      embedding: false,
-    },
-  },
-  {
-    id: 'claude-haiku-4-5',
-    provider: 'anthropic',
-    displayName: 'Claude Haiku 4.5',
-    tier: 'cheap',
-    contextWindow: 200000,
-    maxOutputTokens: 8192,
-    capabilities: {
-      tools: true,
-      vision: true,
-      streaming: true,
-      reasoning: false,
-      embedding: false,
-    },
-  },
-  {
-    id: 'codex-gpt-5.4',
-    provider: 'openai',
-    displayName: 'Codex gpt-5.4',
-    tier: 'premium',
-    contextWindow: 128000,
-    maxOutputTokens: 16384,
-    capabilities: {
-      tools: true,
-      vision: true,
-      streaming: true,
-      reasoning: true,
-      embedding: false,
-    },
-  },
-  {
-    id: 'glm-5',
-    provider: 'zai',
-    displayName: 'GLM-5',
-    tier: 'standard',
-    contextWindow: 128000,
-    maxOutputTokens: 8192,
-    capabilities: {
-      tools: true,
-      vision: false,
-      streaming: true,
-      reasoning: false,
-      embedding: false,
-    },
-  },
-  {
-    id: 'llama3.2',
-    provider: 'ollama',
-    displayName: 'llama3.2',
-    tier: 'local',
-    contextWindow: 128000,
-    maxOutputTokens: 8192,
-    capabilities: {
-      tools: true,
-      vision: false,
-      streaming: true,
-      reasoning: false,
-      embedding: false,
-    },
-  },
-  {
-    id: 'codellama',
-    provider: 'ollama',
-    displayName: 'codellama',
-    tier: 'local',
-    contextWindow: 16000,
-    maxOutputTokens: 4096,
-    capabilities: {
-      tools: true,
-      vision: false,
-      streaming: true,
-      reasoning: false,
-      embedding: false,
-    },
-  },
-  {
-    id: 'mistral',
-    provider: 'ollama',
-    displayName: 'mistral',
-    tier: 'local',
-    contextWindow: 32000,
-    maxOutputTokens: 8192,
-    capabilities: {
-      tools: true,
-      vision: false,
-      streaming: true,
-      reasoning: false,
-      embedding: false,
-    },
-  },
-  {
-    id: 'nomic-embed-text',
-    provider: 'ollama',
-    displayName: 'nomic-embed-text',
-    tier: 'local',
-    contextWindow: 8192,
-    maxOutputTokens: 0,
-    capabilities: {
-      tools: false,
-      vision: false,
-      streaming: false,
-      reasoning: false,
-      embedding: true,
-    },
-  },
-  {
-    id: 'mxbai-embed-large',
-    provider: 'ollama',
-    displayName: 'mxbai-embed-large',
-    tier: 'local',
-    contextWindow: 8192,
-    maxOutputTokens: 0,
-    capabilities: {
-      tools: false,
-      vision: false,
-      streaming: false,
-      reasoning: false,
-      embedding: true,
-    },
-  },
-];
-
-/**
- * Look up a model by its ID.
- * Returns undefined if the model is not found.
- */
-export function getModelCapability(modelId: string): ModelCapability | undefined {
-  return MODEL_CAPABILITIES.find((m) => m.id === modelId);
-}
-
-/**
- * Find models matching a partial capability filter.
- * All provided filter keys must match for a model to be included.
- */
-export function findModelsByCapability(
-  filter: Partial<Pick<ModelCapability, 'tier' | 'provider'>> & {
-    capabilities?: Partial<ModelCapability['capabilities']>;
-  },
-): ModelCapability[] {
-  return MODEL_CAPABILITIES.filter((model) => {
-    if (filter.tier !== undefined && model.tier !== filter.tier) return false;
-    if (filter.provider !== undefined && model.provider !== filter.provider) return false;
-    if (filter.capabilities) {
-      for (const [key, value] of Object.entries(filter.capabilities) as [
-        keyof ModelCapability['capabilities'],
-        boolean,
-      ][]) {
-        if (model.capabilities[key] !== value) return false;
-      }
-    }
-    return true;
-  });
-}
-
-/**
- * Get all models for a specific provider.
- */
-export function getModelsByProvider(provider: string): ModelCapability[] {
-  return MODEL_CAPABILITIES.filter((m) => m.provider === provider);
-}
-
-/**
- * Get the full list of all known models.
- */
-export function getAllModels(): ModelCapability[] {
-  return MODEL_CAPABILITIES;
-}
@@ -1,23 +0,0 @@
-/** DTO for storing a provider credential. */
-export interface StoreCredentialDto {
-  /** Provider identifier (e.g., 'anthropic', 'openai', 'openrouter', 'zai') */
-  provider: string;
-  /** Credential type */
-  type: 'api_key' | 'oauth_token';
-  /** Plain-text credential value — will be encrypted before storage */
-  value: string;
-  /** Optional extra config (e.g., base URL overrides) */
-  metadata?: Record<string, unknown>;
-}
-
-/** DTO returned in list/existence responses — never contains decrypted values. */
-export interface ProviderCredentialSummaryDto {
-  provider: string;
-  credentialType: 'api_key' | 'oauth_token';
-  /** Whether a credential is stored for this provider */
-  exists: boolean;
-  expiresAt?: string | null;
-  metadata?: Record<string, unknown> | null;
-  createdAt: string;
-  updatedAt: string;
-}
@@ -1,123 +0,0 @@
-import { Inject, Injectable, Logger } from '@nestjs/common';
-import { seal, unseal } from '@mosaicstack/auth';
-import type { Db } from '@mosaicstack/db';
-import { providerCredentials, eq, and } from '@mosaicstack/db';
-import { DB } from '../database/database.module.js';
-import type { ProviderCredentialSummaryDto } from './provider-credentials.dto.js';
-
-@Injectable()
-export class ProviderCredentialsService {
-  private readonly logger = new Logger(ProviderCredentialsService.name);
-
-  constructor(@Inject(DB) private readonly db: Db) {}
-
-  /**
-   * Encrypt and store (or update) a credential for the given user + provider.
-   * Uses an upsert pattern: one row per (userId, provider).
-   */
-  async store(
-    userId: string,
-    provider: string,
-    type: 'api_key' | 'oauth_token',
-    value: string,
-    metadata?: Record<string, unknown>,
-  ): Promise<void> {
-    const encryptedValue = seal(value);
-
-    await this.db
-      .insert(providerCredentials)
-      .values({
-        userId,
-        provider,
-        credentialType: type,
-        encryptedValue,
-        metadata: metadata ?? null,
-      })
-      .onConflictDoUpdate({
-        target: [providerCredentials.userId, providerCredentials.provider],
-        set: {
-          credentialType: type,
-          encryptedValue,
-          metadata: metadata ?? null,
-          updatedAt: new Date(),
-        },
-      });
-
-    this.logger.log(`Credential stored for user=${userId} provider=${provider}`);
-  }
-
-  /**
-   * Decrypt and return the plain-text credential value for the given user + provider.
-   * Returns null if no credential is stored.
-   */
-  async retrieve(userId: string, provider: string): Promise<string | null> {
-    const rows = await this.db
-      .select()
-      .from(providerCredentials)
-      .where(
-        and(eq(providerCredentials.userId, userId), eq(providerCredentials.provider, provider)),
-      )
-      .limit(1);
-
-    if (rows.length === 0) return null;
-
-    const row = rows[0]!;
-
-    // Skip expired OAuth tokens
-    if (row.expiresAt && row.expiresAt < new Date()) {
-      this.logger.warn(`Credential for user=${userId} provider=${provider} has expired`);
-      return null;
-    }
-
-    try {
-      return unseal(row.encryptedValue);
-    } catch (err) {
-      this.logger.error(
-        `Failed to decrypt credential for user=${userId} provider=${provider}`,
-        err instanceof Error ? err.message : String(err),
-      );
-      return null;
-    }
-  }
-
-  /**
-   * Delete the stored credential for the given user + provider.
-   */
-  async remove(userId: string, provider: string): Promise<void> {
-    await this.db
-      .delete(providerCredentials)
-      .where(
-        and(eq(providerCredentials.userId, userId), eq(providerCredentials.provider, provider)),
-      );
-
-    this.logger.log(`Credential removed for user=${userId} provider=${provider}`);
-  }
-
-  /**
-   * List all providers for which the user has stored credentials.
-   * Never returns decrypted values.
-   */
-  async listProviders(userId: string): Promise<ProviderCredentialSummaryDto[]> {
-    const rows = await this.db
-      .select({
-        provider: providerCredentials.provider,
-        credentialType: providerCredentials.credentialType,
-        expiresAt: providerCredentials.expiresAt,
-        metadata: providerCredentials.metadata,
-        createdAt: providerCredentials.createdAt,
-        updatedAt: providerCredentials.updatedAt,
-      })
-      .from(providerCredentials)
-      .where(eq(providerCredentials.userId, userId));
-
-    return rows.map((row) => ({
-      provider: row.provider,
-      credentialType: row.credentialType,
-      exists: true,
-      expiresAt: row.expiresAt?.toISOString() ?? null,
-      metadata: row.metadata as Record<string, unknown> | null,
-      createdAt: row.createdAt.toISOString(),
-      updatedAt: row.updatedAt.toISOString(),
-    }));
-  }
-}
@@ -1,17 +0,0 @@
-export interface TestConnectionDto {
-  /** Provider identifier to test (e.g. 'ollama', custom provider id) */
-  providerId: string;
-  /** Optional base URL override for ad-hoc testing */
-  baseUrl?: string;
-}
-
-export interface TestConnectionResultDto {
-  providerId: string;
-  reachable: boolean;
-  /** Round-trip latency in milliseconds (present when reachable) */
-  latencyMs?: number;
-  /** Human-readable error when unreachable */
-  error?: string;
-  /** Model ids discovered at the remote endpoint (present when reachable) */
-  discoveredModels?: string[];
-}
@@ -1,430 +0,0 @@
-import {
-  Inject,
-  Injectable,
-  Logger,
-  Optional,
-  type OnModuleDestroy,
-  type OnModuleInit,
-} from '@nestjs/common';
-import { ModelRegistry, AuthStorage } from '@mariozechner/pi-coding-agent';
-import { getModel, type Model, type Api } from '@mariozechner/pi-ai';
-import type {
-  CustomProviderConfig,
-  IProviderAdapter,
-  ModelInfo,
-  ProviderHealth,
-  ProviderInfo,
-} from '@mosaicstack/types';
-import {
-  AnthropicAdapter,
-  OllamaAdapter,
-  OpenAIAdapter,
-  OpenRouterAdapter,
-  ZaiAdapter,
-} from './adapters/index.js';
-import type { TestConnectionResultDto } from './provider.dto.js';
-import { ProviderCredentialsService } from './provider-credentials.service.js';
-
-/** Default health check interval in seconds */
-const DEFAULT_HEALTH_INTERVAL_SECS = 60;
-
-/** DI injection token for the provider adapter array. */
-export const PROVIDER_ADAPTERS = Symbol('PROVIDER_ADAPTERS');
-
-/** Environment variable names for well-known providers */
-const PROVIDER_ENV_KEYS: Record<string, string> = {
-  anthropic: 'ANTHROPIC_API_KEY',
-  openai: 'OPENAI_API_KEY',
-  openrouter: 'OPENROUTER_API_KEY',
-  zai: 'ZAI_API_KEY',
-};
-
-@Injectable()
-export class ProviderService implements OnModuleInit, OnModuleDestroy {
-  private readonly logger = new Logger(ProviderService.name);
-  private registry!: ModelRegistry;
-
-  constructor(
-    @Optional()
-    @Inject(ProviderCredentialsService)
-    private readonly credentialsService: ProviderCredentialsService | null,
-  ) {}
-
-  /**
-   * Adapters registered with this service.
-   * Built-in adapters (Ollama) are always present; additional adapters can be
-   * supplied via the PROVIDER_ADAPTERS injection token in the future.
-   */
-  private adapters: IProviderAdapter[] = [];
-
-  /**
-   * Cached health status per provider, updated by the health check scheduler.
-   */
-  private healthCache: Map<string, ProviderHealth & { modelCount: number }> = new Map();
-
-  /** Timer handle for the periodic health check scheduler */
-  private healthCheckTimer: ReturnType<typeof setInterval> | null = null;
-
-  async onModuleInit(): Promise<void> {
-    const authStorage = AuthStorage.inMemory();
-    this.registry = ModelRegistry.inMemory(authStorage);
-
-    // Build the default set of adapters that rely on the registry
-    this.adapters = [
-      new OllamaAdapter(this.registry),
-      new AnthropicAdapter(this.registry),
-      new OpenAIAdapter(this.registry),
-      new OpenRouterAdapter(),
-      new ZaiAdapter(),
-    ];
-
-    // Run all adapter registrations first (Ollama, Anthropic, OpenAI, OpenRouter, Z.ai)
-    await this.registerAll();
-
-    // Register API-key providers directly (custom)
-    this.registerCustomProviders();
-
-    const available = this.registry.getAvailable();
-    this.logger.log(`Providers initialized: ${available.length} models available`);
-
-    // Kick off the health check scheduler
-    this.startHealthCheckScheduler();
-  }
-
-  onModuleDestroy(): void {
-    if (this.healthCheckTimer !== null) {
-      clearInterval(this.healthCheckTimer);
-      this.healthCheckTimer = null;
-    }
-  }
-
-  // ---------------------------------------------------------------------------
-  // Health check scheduler
-  // ---------------------------------------------------------------------------
-
-  /**
-   * Start periodic health checks on all adapters.
-   * Interval is configurable via PROVIDER_HEALTH_INTERVAL env (seconds, default 60).
-   */
-  private startHealthCheckScheduler(): void {
-    const intervalSecs =
-      parseInt(process.env['PROVIDER_HEALTH_INTERVAL'] ?? '', 10) || DEFAULT_HEALTH_INTERVAL_SECS;
-    const intervalMs = intervalSecs * 1000;
-
-    // Run an initial check immediately (non-blocking)
-    void this.runScheduledHealthChecks();
-
-    this.healthCheckTimer = setInterval(() => {
-      void this.runScheduledHealthChecks();
-    }, intervalMs);
-
-    this.logger.log(`Provider health check scheduler started (interval: ${intervalSecs}s)`);
-  }
-
-  private async runScheduledHealthChecks(): Promise<void> {
-    for (const adapter of this.adapters) {
-      try {
-        const health = await adapter.healthCheck();
-        const modelCount = adapter.listModels().length;
-        this.healthCache.set(adapter.name, { ...health, modelCount });
-        this.logger.debug(
-          `Health check [${adapter.name}]: ${health.status} (${health.latencyMs ?? 'n/a'}ms)`,
-        );
-      } catch (err) {
-        const modelCount = adapter.listModels().length;
-        this.healthCache.set(adapter.name, {
-          status: 'down',
-          lastChecked: new Date().toISOString(),
-          error: err instanceof Error ? err.message : String(err),
-          modelCount,
-        });
-      }
-    }
-  }
-
-  /**
-   * Return the cached health status for all adapters.
-   * Format: array of { name, status, latencyMs, lastChecked, modelCount }
-   */
-  getProvidersHealth(): Array<{
-    name: string;
-    status: string;
-    latencyMs?: number;
-    lastChecked: string;
-    modelCount: number;
-    error?: string;
-  }> {
-    return this.adapters.map((adapter) => {
-      const cached = this.healthCache.get(adapter.name);
-      if (cached) {
-        return {
-          name: adapter.name,
-          status: cached.status,
-          latencyMs: cached.latencyMs,
-          lastChecked: cached.lastChecked,
-          modelCount: cached.modelCount,
-          error: cached.error,
-        };
-      }
-      // Not yet checked — return a pending placeholder
-      return {
-        name: adapter.name,
-        status: 'unknown',
-        lastChecked: new Date().toISOString(),
-        modelCount: adapter.listModels().length,
-      };
-    });
-  }
-
-  // ---------------------------------------------------------------------------
-  // Adapter-pattern API
-  // ---------------------------------------------------------------------------
-
-  /**
-   * Call register() on each adapter in order.
-   * Errors from individual adapters are logged and do not abort the others.
-   */
-  async registerAll(): Promise<void> {
-    for (const adapter of this.adapters) {
-      try {
-        await adapter.register();
-      } catch (err) {
-        this.logger.error(
-          `Adapter "${adapter.name}" registration failed`,
-          err instanceof Error ? err.stack : String(err),
-        );
-      }
-    }
-  }
-
-  /**
-   * Return the adapter registered under the given provider name, or undefined.
-   */
-  getAdapter(providerName: string): IProviderAdapter | undefined {
-    return this.adapters.find((a) => a.name === providerName);
-  }
-
-  /**
-   * Run healthCheck() on all adapters and return results keyed by provider name.
-   */
-  async healthCheckAll(): Promise<Record<string, ProviderHealth>> {
-    const results: Record<string, ProviderHealth> = {};
-    await Promise.all(
-      this.adapters.map(async (adapter) => {
-        try {
-          results[adapter.name] = await adapter.healthCheck();
-        } catch (err) {
-          results[adapter.name] = {
-            status: 'down',
-            lastChecked: new Date().toISOString(),
-            error: err instanceof Error ? err.message : String(err),
-          };
-        }
-      }),
-    );
-    return results;
-  }
-
-  // ---------------------------------------------------------------------------
-  // Legacy / Pi-SDK-facing API (preserved for AgentService and RoutingService)
-  // ---------------------------------------------------------------------------
-
-  getRegistry(): ModelRegistry {
-    return this.registry;
-  }
-
-  findModel(provider: string, modelId: string): Model<Api> | undefined {
-    return this.registry.find(provider, modelId);
-  }
-
-  getDefaultModel(): Model<Api> | undefined {
-    const available = this.registry.getAvailable();
-    return available[0];
-  }
-
-  listProviders(): ProviderInfo[] {
-    const allModels = this.registry.getAll();
-    const availableModels = this.registry.getAvailable();
-    const availableIds = new Set(availableModels.map((m) => `${m.provider}:${m.id}`));
-
-    const providerMap = new Map<string, ProviderInfo>();
-
-    for (const model of allModels) {
-      let info = providerMap.get(model.provider);
-      if (!info) {
-        info = {
-          id: model.provider,
-          name: model.provider,
-          available: false,
-          models: [],
-        };
-        providerMap.set(model.provider, info);
-      }
-
-      const isAvailable = availableIds.has(`${model.provider}:${model.id}`);
-      if (isAvailable) info.available = true;
-
-      info.models.push(this.toModelInfo(model));
-    }
-
-    return Array.from(providerMap.values());
-  }
-
-  listAvailableModels(): ModelInfo[] {
-    return this.registry.getAvailable().map((m) => this.toModelInfo(m));
-  }
-
-  async testConnection(providerId: string, baseUrl?: string): Promise<TestConnectionResultDto> {
-    // Delegate to the adapter when one exists and no URL override is given
-    const adapter = this.getAdapter(providerId);
-    if (adapter && !baseUrl) {
-      const health = await adapter.healthCheck();
-      return {
-        providerId,
-        reachable: health.status !== 'down',
-        latencyMs: health.latencyMs,
-        error: health.error,
-      };
-    }
-
-    // Resolve baseUrl: explicit override > registered provider > ollama env
-    let resolvedUrl = baseUrl;
-
-    if (!resolvedUrl) {
-      const allModels = this.registry.getAll();
-      const providerModels = allModels.filter((m) => m.provider === providerId);
-      if (providerModels.length === 0) {
-        return { providerId, reachable: false, error: `Provider '${providerId}' not found` };
-      }
-      // For Ollama, derive the base URL from environment
-      if (providerId === 'ollama') {
-        const ollamaUrl = process.env['OLLAMA_BASE_URL'] ?? process.env['OLLAMA_HOST'];
-        if (!ollamaUrl) {
-          return { providerId, reachable: false, error: 'OLLAMA_BASE_URL not configured' };
-        }
-        resolvedUrl = `${ollamaUrl}/v1/models`;
-      } else {
-        // For other providers, we can only do a basic check
-        return { providerId, reachable: true, discoveredModels: providerModels.map((m) => m.id) };
-      }
-    } else {
-      resolvedUrl = resolvedUrl.replace(/\/?$/, '') + '/models';
-    }
-
-    const start = Date.now();
-    try {
-      const res = await fetch(resolvedUrl, {
-        method: 'GET',
-        headers: { Accept: 'application/json' },
-        signal: AbortSignal.timeout(5000),
-      });
-
-      const latencyMs = Date.now() - start;
-
-      if (!res.ok) {
-        return { providerId, reachable: false, latencyMs, error: `HTTP ${res.status}` };
-      }
-
-      let discoveredModels: string[] | undefined;
-      try {
-        const json = (await res.json()) as { models?: Array<{ id?: string; name?: string }> };
-        if (Array.isArray(json.models)) {
-          discoveredModels = json.models.map((m) => m.id ?? m.name ?? '').filter(Boolean);
-        }
-      } catch {
-        // ignore parse errors — endpoint was reachable
-      }
-
-      return { providerId, reachable: true, latencyMs, discoveredModels };
-    } catch (err) {
-      const latencyMs = Date.now() - start;
-      const message = err instanceof Error ? err.message : String(err);
-      return { providerId, reachable: false, latencyMs, error: message };
-    }
-  }
-
-  registerCustomProvider(config: CustomProviderConfig): void {
-    this.registry.registerProvider(config.id, {
-      baseUrl: config.baseUrl,
-      apiKey: config.apiKey,
-      models: config.models.map((m) => ({
-        id: m.id,
-        name: m.name,
-        reasoning: m.reasoning ?? false,
-        input: ['text'] as ('text' | 'image')[],
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-        contextWindow: m.contextWindow ?? 4096,
-        maxTokens: m.maxTokens ?? 4096,
-      })),
-    });
-
-    this.logger.log(`Registered custom provider: ${config.id} (${config.models.length} models)`);
-  }
-
-  // ---------------------------------------------------------------------------
-  // Private helpers
-  // ---------------------------------------------------------------------------
-
-  private registerCustomProviders(): void {
-    const customJson = process.env['MOSAIC_CUSTOM_PROVIDERS'];
-    if (!customJson) return;
-
-    try {
-      const configs = JSON.parse(customJson) as CustomProviderConfig[];
-      for (const config of configs) {
-        this.registerCustomProvider(config);
-      }
-    } catch (err) {
-      this.logger.error('Failed to parse MOSAIC_CUSTOM_PROVIDERS', String(err));
-    }
-  }
-
-  /**
-   * Resolve an API key for a provider, scoped to a specific user.
-   * User-stored credentials take precedence over environment variables.
-   * Returns null if no key is available from either source.
-   */
-  async resolveApiKey(userId: string, provider: string): Promise<string | null> {
-    if (this.credentialsService) {
-      const userKey = await this.credentialsService.retrieve(userId, provider);
-      if (userKey) {
-        this.logger.debug(`Using user-scoped credential for user=${userId} provider=${provider}`);
-        return userKey;
-      }
-    }
-
-    // Fall back to environment variable
-    const envVar = PROVIDER_ENV_KEYS[provider];
-    const envKey = envVar ? (process.env[envVar] ?? null) : null;
-    if (envKey) {
-      this.logger.debug(`Using env-var credential for provider=${provider}`);
-    }
-    return envKey;
-  }
-
-  private cloneBuiltInModel(
-    provider: string,
-    modelId: string,
-    overrides: Partial<Model<Api>> = {},
-  ): Model<Api> {
-    const model = getModel(provider as never, modelId as never) as Model<Api> | undefined;
-    if (!model) {
-      throw new Error(`Built-in model not found: ${provider}:${modelId}`);
-    }
-
-    return { ...model, ...overrides };
-  }
-
-  private toModelInfo(model: Model<Api>): ModelInfo {
-    return {
-      id: model.id,
-      provider: model.provider,
-      name: model.name,
-      reasoning: model.reasoning,
-      contextWindow: model.contextWindow,
-      maxTokens: model.maxTokens,
-      inputTypes: model.input,
-      cost: model.cost,
-    };
-  }
-}
@@ -1,98 +0,0 @@
-import { Body, Controller, Delete, Get, Inject, Param, Post, UseGuards } from '@nestjs/common';
-import type { RoutingCriteria } from '@mosaicstack/types';
-import { AuthGuard } from '../auth/auth.guard.js';
-import { CurrentUser } from '../auth/current-user.decorator.js';
-import { ProviderService } from './provider.service.js';
-import { ProviderCredentialsService } from './provider-credentials.service.js';
-import { RoutingService } from './routing.service.js';
-import type { TestConnectionDto, TestConnectionResultDto } from './provider.dto.js';
-import type {
-  StoreCredentialDto,
-  ProviderCredentialSummaryDto,
-} from './provider-credentials.dto.js';
-
-@Controller('api/providers')
-@UseGuards(AuthGuard)
-export class ProvidersController {
-  constructor(
-    @Inject(ProviderService) private readonly providerService: ProviderService,
-    @Inject(ProviderCredentialsService)
-    private readonly credentialsService: ProviderCredentialsService,
-    @Inject(RoutingService) private readonly routingService: RoutingService,
-  ) {}
-
-  @Get()
-  list() {
-    return this.providerService.listProviders();
-  }
-
-  @Get('models')
-  listModels() {
-    return this.providerService.listAvailableModels();
-  }
-
-  @Get('health')
-  health() {
-    return { providers: this.providerService.getProvidersHealth() };
-  }
-
-  @Post('test')
-  testConnection(@Body() body: TestConnectionDto): Promise<TestConnectionResultDto> {
-    return this.providerService.testConnection(body.providerId, body.baseUrl);
-  }
-
-  @Post('route')
-  route(@Body() criteria: RoutingCriteria) {
-    return this.routingService.route(criteria);
-  }
-
-  @Post('rank')
-  rank(@Body() criteria: RoutingCriteria) {
-    return this.routingService.rank(criteria);
-  }
-
-  // ── Credential CRUD ──────────────────────────────────────────────────────
-
-  /**
-   * GET /api/providers/credentials
-   * List all provider credentials for the authenticated user.
-   * Returns provider names, types, and metadata — never decrypted values.
-   */
-  @Get('credentials')
-  listCredentials(@CurrentUser() user: { id: string }): Promise<ProviderCredentialSummaryDto[]> {
-    return this.credentialsService.listProviders(user.id);
-  }
-
-  /**
-   * POST /api/providers/credentials
-   * Store or update a provider credential for the authenticated user.
-   * The value is encrypted before storage and never returned.
-   */
-  @Post('credentials')
-  async storeCredential(
-    @CurrentUser() user: { id: string },
-    @Body() body: StoreCredentialDto,
-  ): Promise<{ success: boolean; provider: string }> {
-    await this.credentialsService.store(
-      user.id,
-      body.provider,
-      body.type,
-      body.value,
-      body.metadata,
-    );
-    return { success: true, provider: body.provider };
-  }
-
-  /**
-   * DELETE /api/providers/credentials/:provider
-   * Remove a stored credential for the authenticated user.
-   */
-  @Delete('credentials/:provider')
-  async removeCredential(
-    @CurrentUser() user: { id: string },
-    @Param('provider') provider: string,
-  ): Promise<{ success: boolean; provider: string }> {
-    await this.credentialsService.remove(user.id, provider);
-    return { success: true, provider };
-  }
-}
@@ -1,167 +0,0 @@
-import { Inject, Injectable, Logger } from '@nestjs/common';
-import type { ModelInfo } from '@mosaicstack/types';
-import type { RoutingCriteria, RoutingResult, CostTier } from '@mosaicstack/types';
-import { ProviderService } from './provider.service.js';
-
-/** Per-million-token cost thresholds for tier classification */
-const COST_TIER_THRESHOLDS: Record<CostTier, { maxInput: number }> = {
-  cheap: { maxInput: 1 },
-  standard: { maxInput: 10 },
-  premium: { maxInput: Infinity },
-  // local = self-hosted; treat as cheapest tier for cost scoring purposes
-  local: { maxInput: 0 },
-};
-
-@Injectable()
-export class RoutingService {
-  private readonly logger = new Logger(RoutingService.name);
-
-  constructor(@Inject(ProviderService) private readonly providerService: ProviderService) {}
-
-  /**
-   * Select the best available model for the given criteria.
-   * Returns null if no model matches the requirements.
-   */
-  route(criteria: RoutingCriteria = {}): RoutingResult | null {
-    const available = this.providerService.listAvailableModels();
-    if (available.length === 0) {
-      this.logger.warn('No available models for routing');
-      return null;
-    }
-
-    // If a specific model is preferred, try it first
-    if (criteria.preferredProvider && criteria.preferredModel) {
-      const match = available.find(
-        (m) => m.provider === criteria.preferredProvider && m.id === criteria.preferredModel,
-      );
-      if (match) {
-        return {
-          provider: match.provider,
-          modelId: match.id,
-          modelName: match.name,
-          score: 100,
-          reasoning: 'Preferred model selected',
-        };
-      }
-    }
-
-    // Score and rank candidates
-    const scored = available
-      .map((model) => this.scoreModel(model, criteria))
-      .filter((s) => s.score > 0)
-      .sort((a, b) => b.score - a.score);
-
-    if (scored.length === 0) {
-      this.logger.warn('No models matched routing criteria', criteria);
-      return null;
-    }
-
-    const best = scored[0] as RoutingResult;
-    this.logger.debug(
-      `Routed to ${best.provider}/${best.modelId} (score=${best.score}): ${best.reasoning}`,
-    );
-    return best;
-  }
-
-  /**
-   * List all available models ranked by suitability for the given criteria.
-   */
-  rank(criteria: RoutingCriteria = {}): RoutingResult[] {
-    const available = this.providerService.listAvailableModels();
-    return available
-      .map((model) => this.scoreModel(model, criteria))
-      .filter((s) => s.score > 0)
-      .sort((a, b) => b.score - a.score);
-  }
-
-  private scoreModel(model: ModelInfo, criteria: RoutingCriteria): RoutingResult {
-    let score = 50; // Base score
-    const reasons: string[] = [];
-
-    // Hard requirements — disqualify if not met
-    if (criteria.requireReasoning && !model.reasoning) {
-      return this.disqualified(model, 'reasoning required but not supported');
-    }
-
-    if (criteria.requireImageInput && !model.inputTypes.includes('image')) {
-      return this.disqualified(model, 'image input required but not supported');
-    }
-
-    if (criteria.minContextWindow && model.contextWindow < criteria.minContextWindow) {
-      return this.disqualified(
-        model,
-        `context window ${model.contextWindow} < required ${criteria.minContextWindow}`,
-      );
-    }
-
-    // Cost tier matching
-    if (criteria.costTier) {
-      const tier = this.classifyTier(model);
-      if (tier === criteria.costTier) {
-        score += 20;
-        reasons.push(`cost tier match (${tier})`);
-      } else if (
-        (criteria.costTier === 'cheap' && tier === 'standard') ||
-        (criteria.costTier === 'standard' && tier === 'premium')
-      ) {
-        score += 5;
-        reasons.push(`adjacent cost tier (wanted ${criteria.costTier}, got ${tier})`);
-      }
-    }
-
-    // Prefer cheaper models when no cost tier specified
-    if (!criteria.costTier) {
-      const costPerMillion = model.cost.input;
-      if (costPerMillion <= 1) score += 10;
-      else if (costPerMillion <= 5) score += 5;
-    }
-
-    // Provider preference
-    if (criteria.preferredProvider && model.provider === criteria.preferredProvider) {
-      score += 15;
-      reasons.push('preferred provider');
-    }
-
-    // Reasoning bonus for complex tasks
-    if (model.reasoning) {
-      if (criteria.taskType === 'coding' || criteria.taskType === 'analysis') {
-        score += 10;
-        reasons.push('reasoning model for complex task');
-      }
-    }
-
-    // Large context bonus for analysis tasks
-    if (criteria.taskType === 'analysis' && model.contextWindow >= 128_000) {
-      score += 5;
-      reasons.push('large context window');
-    }
-
-    return {
-      provider: model.provider,
-      modelId: model.id,
-      modelName: model.name,
-      score,
-      reasoning: reasons.length > 0 ? reasons.join('; ') : 'base score',
-    };
-  }
-
-  private classifyTier(model: ModelInfo): CostTier {
-    const cost = model.cost.input;
-    const cheapThreshold = COST_TIER_THRESHOLDS['cheap'];
-    const standardThreshold = COST_TIER_THRESHOLDS['standard'];
-
-    if (cost <= cheapThreshold.maxInput) return 'cheap';
-    if (cost <= standardThreshold.maxInput) return 'standard';
-    return 'premium';
-  }
-
-  private disqualified(model: ModelInfo, reason: string): RoutingResult {
-    return {
-      provider: model.provider,
-      modelId: model.id,
-      modelName: model.name,
-      score: 0,
-      reasoning: `disqualified: ${reason}`,
-    };
-  }
-}
@@ -1,138 +0,0 @@
-import { Inject, Injectable, Logger, type OnModuleInit } from '@nestjs/common';
-import { routingRules, type Db, sql } from '@mosaicstack/db';
-import { DB } from '../../database/database.module.js';
-import type { RoutingCondition, RoutingAction } from './routing.types.js';
-
-/** Seed-time routing rule descriptor */
-interface RoutingRuleSeed {
-  name: string;
-  priority: number;
-  conditions: RoutingCondition[];
-  action: RoutingAction;
-}
-
-export const DEFAULT_ROUTING_RULES: RoutingRuleSeed[] = [
-  {
-    name: 'Complex coding → Opus',
-    priority: 1,
-    conditions: [
-      { field: 'taskType', operator: 'eq', value: 'coding' },
-      { field: 'complexity', operator: 'eq', value: 'complex' },
-    ],
-    action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-  },
-  {
-    name: 'Moderate coding → Sonnet',
-    priority: 2,
-    conditions: [
-      { field: 'taskType', operator: 'eq', value: 'coding' },
-      { field: 'complexity', operator: 'eq', value: 'moderate' },
-    ],
-    action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-  },
-  {
-    name: 'Simple coding → Codex',
-    priority: 3,
-    conditions: [
-      { field: 'taskType', operator: 'eq', value: 'coding' },
-      { field: 'complexity', operator: 'eq', value: 'simple' },
-    ],
-    action: { provider: 'openai', model: 'codex-gpt-5-4' },
-  },
-  {
-    name: 'Research → Codex',
-    priority: 4,
-    conditions: [{ field: 'taskType', operator: 'eq', value: 'research' }],
-    action: { provider: 'openai', model: 'codex-gpt-5-4' },
-  },
-  {
-    name: 'Summarization → GLM-5',
-    priority: 5,
-    conditions: [{ field: 'taskType', operator: 'eq', value: 'summarization' }],
-    action: { provider: 'zai', model: 'glm-5' },
-  },
-  {
-    name: 'Analysis with reasoning → Opus',
-    priority: 6,
-    conditions: [
-      { field: 'taskType', operator: 'eq', value: 'analysis' },
-      { field: 'requiredCapabilities', operator: 'includes', value: 'reasoning' },
-    ],
-    action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-  },
-  {
-    name: 'Conversation → Sonnet',
-    priority: 7,
-    conditions: [{ field: 'taskType', operator: 'eq', value: 'conversation' }],
-    action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-  },
-  {
-    name: 'Creative → Sonnet',
-    priority: 8,
-    conditions: [{ field: 'taskType', operator: 'eq', value: 'creative' }],
-    action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-  },
-  {
-    name: 'Cheap/general → Haiku',
-    priority: 9,
-    conditions: [{ field: 'costTier', operator: 'eq', value: 'cheap' }],
-    action: { provider: 'anthropic', model: 'claude-haiku-4-5' },
-  },
-  {
-    name: 'Fallback → Sonnet',
-    priority: 10,
-    conditions: [],
-    action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-  },
-  {
-    name: 'Offline → Ollama',
-    priority: 99,
-    conditions: [{ field: 'costTier', operator: 'eq', value: 'local' }],
-    action: { provider: 'ollama', model: 'llama3.2' },
-  },
-];
-
-@Injectable()
-export class DefaultRoutingRulesSeed implements OnModuleInit {
-  private readonly logger = new Logger(DefaultRoutingRulesSeed.name);
-
-  constructor(@Inject(DB) private readonly db: Db) {}
-
-  async onModuleInit(): Promise<void> {
-    await this.seedDefaultRules();
-  }
-
-  /**
-   * Insert default routing rules into the database if the table is empty.
-   * Skips seeding if any system-scoped rules already exist.
-   */
-  async seedDefaultRules(): Promise<void> {
-    const rows = await this.db
-      .select({ count: sql<number>`count(*)::int` })
-      .from(routingRules)
-      .where(sql`scope = 'system'`);
-
-    const count = rows[0]?.count ?? 0;
-    if (count > 0) {
-      this.logger.debug(
-        `Skipping default routing rules seed — ${count} system rule(s) already exist`,
-      );
-      return;
-    }
-
-    this.logger.log(`Seeding ${DEFAULT_ROUTING_RULES.length} default routing rules`);
-
-    await this.db.insert(routingRules).values(
-      DEFAULT_ROUTING_RULES.map((rule) => ({
-        name: rule.name,
-        priority: rule.priority,
-        scope: 'system' as const,
-        conditions: rule.conditions as unknown as Record<string, unknown>[],
-        action: rule.action as unknown as Record<string, unknown>,
-        enabled: true,
-      })),
-    );
-
-    this.logger.log('Default routing rules seeded successfully');
-  }
-}
@@ -1,260 +0,0 @@
-/**
- * M4-013: Routing end-to-end integration tests.
- *
- * These tests exercise the full pipeline:
- *   classifyTask (task-classifier) → matchConditions (routing-engine) → RoutingDecision
- *
- * All tests use a mocked DB (rule store) and mocked ProviderService (health map)
- * to avoid real I/O — they verify the complete classify → match → decide path.
- */
-import { describe, it, expect, vi } from 'vitest';
-import { RoutingEngineService } from './routing-engine.service.js';
-import { DEFAULT_ROUTING_RULES } from '../routing/default-rules.js';
-import type { RoutingRule } from './routing.types.js';
-
-// ─── Test helpers ─────────────────────────────────────────────────────────────
-
-/** Build a RoutingEngineService backed by the given rule set and health map. */
-function makeService(
-  rules: RoutingRule[],
-  healthMap: Record<string, { status: string }>,
-): RoutingEngineService {
-  const mockDb = {
-    select: vi.fn().mockReturnValue({
-      from: vi.fn().mockReturnValue({
-        where: vi.fn().mockReturnValue({
-          orderBy: vi.fn().mockResolvedValue(
-            rules.map((r) => ({
-              id: r.id,
-              name: r.name,
-              priority: r.priority,
-              scope: r.scope,
-              userId: r.userId ?? null,
-              conditions: r.conditions,
-              action: r.action,
-              enabled: r.enabled,
-              createdAt: new Date(),
-              updatedAt: new Date(),
-            })),
-          ),
-        }),
-      }),
-    }),
-  };
-
-  const mockProviderService = {
-    healthCheckAll: vi.fn().mockResolvedValue(healthMap),
-  };
-
-  return new (RoutingEngineService as unknown as new (
-    db: unknown,
-    ps: unknown,
-  ) => RoutingEngineService)(mockDb, mockProviderService);
-}
-
-/**
- * Convert DEFAULT_ROUTING_RULES (seed format, no id) to RoutingRule objects
- * so we can use them in tests.
- */
-function defaultRules(): RoutingRule[] {
-  return DEFAULT_ROUTING_RULES.map((r, i) => ({
-    id: `rule-${i + 1}`,
-    scope: 'system' as const,
-    userId: undefined,
-    enabled: true,
-    ...r,
-  }));
-}
-
-/** A health map where anthropic, openai, and zai are all healthy. */
-const allHealthy: Record<string, { status: string }> = {
-  anthropic: { status: 'up' },
-  openai: { status: 'up' },
-  zai: { status: 'up' },
-  ollama: { status: 'up' },
-};
-
-// ─── M4-013 E2E tests ─────────────────────────────────────────────────────────
-
-describe('M4-013: routing end-to-end pipeline', () => {
-  // Test 1: coding message → should route to Opus (complex coding rule)
-  it('coding message routes to Opus via task classifier + routing rules', async () => {
-    // Use a message that classifies as coding + complex
-    // "architecture" triggers complex; "implement" triggers coding
-    const message =
-      'Implement an architecture for a multi-tenant system with database isolation and role-based access control. The system needs to support multiple organizations.';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    // Classifier should detect: taskType=coding, complexity=complex
-    // That matches "Complex coding → Opus" rule at priority 1
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-opus-4-6');
-    expect(decision.ruleName).toBe('Complex coding → Opus');
-  });
-
-  // Test 2: "Summarize this" → routes to GLM-5
-  it('"Summarize this" routes to GLM-5 via summarization rule', async () => {
-    const message = 'Summarize this document for me please';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    // Classifier should detect: taskType=summarization
-    // Matches "Summarization → GLM-5" rule (priority 5)
-    expect(decision.provider).toBe('zai');
-    expect(decision.model).toBe('glm-5');
-    expect(decision.ruleName).toBe('Summarization → GLM-5');
-  });
-
-  // Test 3: simple question → routes to cheap tier (Haiku)
-  // Note: the "Cheap/general → Haiku" rule uses costTier=cheap condition.
-  // Since costTier is not part of TaskClassification (it's a request-level field),
-  // it won't auto-match. Instead we test that a simple conversation falls through
-  // to the "Conversation → Sonnet" rule — which IS the cheap-tier routing path
-  // for simple conversational questions.
-  // We also verify that routing using a user-scoped cheap-tier rule overrides correctly.
-  it('simple conversational question routes to Sonnet (conversation rule)', async () => {
-    const message = 'What time is it?';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    // Classifier: taskType=conversation (no strong signals), complexity=simple
-    // Matches "Conversation → Sonnet" rule (priority 7)
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-sonnet-4-6');
-    expect(decision.ruleName).toBe('Conversation → Sonnet');
-  });
-
-  // Test 3b: explicit cheap-tier rule via user-scoped override
-  it('cheap-tier rule routes to Haiku when costTier=cheap condition matches', async () => {
-    // Build a cheap-tier user rule that has a conversation condition overlapping
-    // with what we send, but give it lower priority so we can test explicitly
-    const cheapRule: RoutingRule = {
-      id: 'cheap-rule-1',
-      name: 'Cheap/general → Haiku',
-      priority: 1,
-      scope: 'system',
-      enabled: true,
-      // This rule matches any simple conversation when costTier is set by the resolver.
-      // We test the rule condition matching directly here:
-      conditions: [{ field: 'taskType', operator: 'eq', value: 'conversation' }],
-      action: { provider: 'anthropic', model: 'claude-haiku-4-5' },
-    };
-
-    const service = makeService([cheapRule], allHealthy);
-    const decision = await service.resolve('Hello, how are you doing today?');
-
-    // Simple greeting → conversation → matches cheapRule → Haiku
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-haiku-4-5');
-    expect(decision.ruleName).toBe('Cheap/general → Haiku');
-  });
-
-  // Test 4: /model override bypasses routing
-  // This test verifies that when a model override is set (stored in chatGateway.modelOverrides),
-  // the routing engine is NOT called. We simulate this by verifying that the routing engine
-  // service is not consulted when the override path is taken.
-  it('/model override bypasses routing engine (no classify → route call)', async () => {
-    // Build a service that would route to Opus for a coding message
-    const mockHealthCheckAll = vi.fn().mockResolvedValue(allHealthy);
-    const mockSelect = vi.fn();
-    const mockDb = {
-      select: mockSelect.mockReturnValue({
-        from: vi.fn().mockReturnValue({
-          where: vi.fn().mockReturnValue({
-            orderBy: vi.fn().mockResolvedValue(defaultRules()),
-          }),
-        }),
-      }),
-    };
-    const mockProviderService = { healthCheckAll: mockHealthCheckAll };
-
-    const service = new (RoutingEngineService as unknown as new (
-      db: unknown,
-      ps: unknown,
-    ) => RoutingEngineService)(mockDb, mockProviderService);
-
-    // Simulate the ChatGateway model-override logic:
-    // When a /model override exists, the gateway skips calling routingEngine.resolve().
-    // We verify this by checking that if we do NOT call resolve(), the DB is never queried.
-    // (This is the same guarantee the ChatGateway code provides.)
-    expect(mockSelect).not.toHaveBeenCalled();
-    expect(mockHealthCheckAll).not.toHaveBeenCalled();
-
-    // Now if we DO call resolve (no override), it hits the DB and health check
-    await service.resolve('implement a function');
-    expect(mockSelect).toHaveBeenCalled();
-    expect(mockHealthCheckAll).toHaveBeenCalled();
-  });
-
-  // Test 5: full pipeline classification accuracy — "Summarize this" message
-  it('full pipeline: classify → match rules → summarization decision', async () => {
-    const message = 'Can you give me a brief summary of the last meeting notes?';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    // "brief" keyword → summarization; "brief" is < 100 chars... check length
-    // message length is ~68 chars → simple complexity but summarization type wins
-    expect(decision.ruleName).toBe('Summarization → GLM-5');
-    expect(decision.provider).toBe('zai');
-    expect(decision.model).toBe('glm-5');
-    expect(decision.reason).toContain('Summarization → GLM-5');
-  });
-
-  // Test 6: pipeline with unhealthy provider — falls through to fallback
-  it('when all matched rule providers are unhealthy, falls through to openai fallback', async () => {
-    // The message classifies as: taskType=coding, complexity=moderate (implement + no architecture keyword,
-    // moderate length ~60 chars → simple threshold is < 100 → actually simple since it is < 100 chars)
-    // Let's use a simple coding message to target Simple coding → Codex (openai)
-    const message = 'implement a sort function';
-
-    const unhealthyHealth = {
-      anthropic: { status: 'down' },
-      openai: { status: 'up' },
-      zai: { status: 'up' },
-      ollama: { status: 'down' },
-    };
-
-    const service = makeService(defaultRules(), unhealthyHealth);
-    const decision = await service.resolve(message);
-
-    // "implement" → coding; 26 chars → simple; so: coding+simple → "Simple coding → Codex" (openai)
-    // openai is up → should match
-    expect(decision.provider).toBe('openai');
-    expect(decision.model).toBe('codex-gpt-5-4');
-  });
-
-  // Test 7: research message routing
-  it('research message routes to Codex via research rule', async () => {
-    const message = 'Research the best approaches for distributed caching systems';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    // "research" keyword → taskType=research → "Research → Codex" rule (priority 4)
-    expect(decision.ruleName).toBe('Research → Codex');
-    expect(decision.provider).toBe('openai');
-    expect(decision.model).toBe('codex-gpt-5-4');
-  });
-
-  // Test 8: full pipeline integrity — decision includes all required fields
-  it('routing decision includes provider, model, ruleName, and reason', async () => {
-    const message = 'implement a new feature';
-
-    const service = makeService(defaultRules(), allHealthy);
-    const decision = await service.resolve(message);
-
-    expect(decision).toHaveProperty('provider');
-    expect(decision).toHaveProperty('model');
-    expect(decision).toHaveProperty('ruleName');
-    expect(decision).toHaveProperty('reason');
-    expect(typeof decision.provider).toBe('string');
-    expect(typeof decision.model).toBe('string');
-    expect(typeof decision.ruleName).toBe('string');
-    expect(typeof decision.reason).toBe('string');
-  });
-});
@@ -1,216 +0,0 @@
-import { Inject, Injectable, Logger } from '@nestjs/common';
-import { routingRules, type Db, and, asc, eq, or } from '@mosaicstack/db';
-import { DB } from '../../database/database.module.js';
-import { ProviderService } from '../provider.service.js';
-import { classifyTask } from './task-classifier.js';
-import type {
-  RoutingCondition,
-  RoutingRule,
-  RoutingDecision,
-  TaskClassification,
-} from './routing.types.js';
-
-// ─── Injection tokens ────────────────────────────────────────────────────────
-
-export const PROVIDER_SERVICE = Symbol('ProviderService');
-
-// ─── Fallback chain ──────────────────────────────────────────────────────────
-
-/**
- * Ordered fallback providers tried when no rule matches or all matched
- * providers are unhealthy.
- */
-const FALLBACK_CHAIN: Array<{ provider: string; model: string }> = [
-  { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-  { provider: 'anthropic', model: 'claude-haiku-4-5' },
-  { provider: 'ollama', model: 'llama3.2' },
-];
-
-// ─── Service ─────────────────────────────────────────────────────────────────
-
-@Injectable()
-export class RoutingEngineService {
-  private readonly logger = new Logger(RoutingEngineService.name);
-
-  constructor(
-    @Inject(DB) private readonly db: Db,
-    @Inject(ProviderService) private readonly providerService: ProviderService,
-  ) {}
-
-  /**
-   * Classify the message, evaluate routing rules in priority order, and return
-   * the best routing decision.
-   *
-   * @param message       - Raw user message text used for classification.
-   * @param userId        - Optional user ID for loading user-scoped rules.
-   * @param availableProviders - Optional pre-fetched provider health map to
-   *                       avoid redundant health checks inside tight loops.
-   */
-  async resolve(
-    message: string,
-    userId?: string,
-    availableProviders?: Record<string, { status: string }>,
-  ): Promise<RoutingDecision> {
-    const classification = classifyTask(message);
-    this.logger.debug(
-      `Classification: taskType=${classification.taskType} complexity=${classification.complexity} domain=${classification.domain}`,
-    );
-
-    // Load health data once (re-use caller-supplied map if provided)
-    const health = availableProviders ?? (await this.providerService.healthCheckAll());
-
-    // Load all applicable rules ordered by priority
-    const rules = await this.loadRules(userId);
-
-    // Evaluate rules in priority order
-    for (const rule of rules) {
-      if (!rule.enabled) continue;
-
-      if (!this.matchConditions(rule, classification)) continue;
-
-      const providerStatus = health[rule.action.provider]?.status;
-      const isHealthy = providerStatus === 'up' || providerStatus === 'ok';
-
-      if (!isHealthy) {
-        this.logger.debug(
-          `Rule "${rule.name}" matched but provider "${rule.action.provider}" is unhealthy (status: ${providerStatus ?? 'unknown'})`,
-        );
-        continue;
-      }
-
-      this.logger.debug(
-        `Rule matched: "${rule.name}" → ${rule.action.provider}/${rule.action.model}`,
-      );
-
-      return {
-        provider: rule.action.provider,
-        model: rule.action.model,
-        agentConfigId: rule.action.agentConfigId,
-        ruleName: rule.name,
-        reason: `Matched routing rule "${rule.name}"`,
-      };
-    }
-
-    // No rule matched (or all matched providers were unhealthy) — apply fallback chain
-    this.logger.debug('No rule matched; applying fallback chain');
-    return this.applyFallbackChain(health);
-  }
-
-  /**
-   * Check whether all conditions of a rule match the given task classification.
-   * An empty conditions array always matches (catch-all / fallback rule).
-   */
-  matchConditions(
-    rule: Pick<RoutingRule, 'conditions'>,
-    classification: TaskClassification,
-  ): boolean {
-    if (rule.conditions.length === 0) return true;
-
-    return rule.conditions.every((condition) => this.evaluateCondition(condition, classification));
-  }
-
-  // ─── Private helpers ───────────────────────────────────────────────────────
-
-  private evaluateCondition(
-    condition: RoutingCondition,
-    classification: TaskClassification,
-  ): boolean {
-    // `costTier` is a valid condition field but is not part of TaskClassification
-    // (it is supplied via userOverrides / request context). Treat unknown fields as
-    // undefined so conditions referencing them simply do not match.
-    const fieldValue = (classification as unknown as Record<string, unknown>)[condition.field];
-
-    switch (condition.operator) {
-      case 'eq': {
-        // Scalar equality: field value must equal condition value (string)
-        if (typeof condition.value !== 'string') return false;
-        return fieldValue === condition.value;
-      }
-
-      case 'in': {
-        // Set membership: condition value (array) contains field value
-        if (!Array.isArray(condition.value)) return false;
-        return condition.value.includes(fieldValue as string);
-      }
-
-      case 'includes': {
-        // Array containment: field value (array) includes condition value (string)
-        if (!Array.isArray(fieldValue)) return false;
-        if (typeof condition.value !== 'string') return false;
-        return (fieldValue as string[]).includes(condition.value);
-      }
-
-      default:
-        return false;
-    }
-  }
-
-  /**
-   * Load routing rules from the database.
-   * System rules + user-scoped rules (when userId is provided) are returned,
-   * ordered by priority ascending.
-   */
-  private async loadRules(userId?: string): Promise<RoutingRule[]> {
-    const whereClause = userId
-      ? or(
-          eq(routingRules.scope, 'system'),
-          and(eq(routingRules.scope, 'user'), eq(routingRules.userId, userId)),
-        )
-      : eq(routingRules.scope, 'system');
-
-    const rows = await this.db
-      .select()
-      .from(routingRules)
-      .where(whereClause)
-      .orderBy(asc(routingRules.priority));
-
-    return rows.map((row) => ({
-      id: row.id,
-      name: row.name,
-      priority: row.priority,
-      scope: row.scope as 'system' | 'user',
-      userId: row.userId ?? undefined,
-      conditions: (row.conditions as unknown as RoutingCondition[]) ?? [],
-      action: row.action as unknown as {
-        provider: string;
-        model: string;
-        agentConfigId?: string;
-        systemPromptOverride?: string;
-        toolAllowlist?: string[];
-      },
-      enabled: row.enabled,
-    }));
-  }
-
-  /**
-   * Walk the fallback chain and return the first healthy provider/model pair.
-   * If none are healthy, return the first entry unconditionally (last resort).
-   */
-  private applyFallbackChain(health: Record<string, { status: string }>): RoutingDecision {
-    for (const candidate of FALLBACK_CHAIN) {
-      const providerStatus = health[candidate.provider]?.status;
-      const isHealthy = providerStatus === 'up' || providerStatus === 'ok';
-      if (isHealthy) {
-        this.logger.debug(`Fallback resolved: ${candidate.provider}/${candidate.model}`);
-        return {
-          provider: candidate.provider,
-          model: candidate.model,
-          ruleName: 'fallback',
-          reason: `Fallback chain — no matching rule; selected ${candidate.provider}/${candidate.model}`,
-        };
-      }
-    }
-
-    // All providers in the fallback chain are unhealthy — use the first entry
-    const lastResort = FALLBACK_CHAIN[0]!;
-    this.logger.warn(
-      `All fallback providers unhealthy; using last resort: ${lastResort.provider}/${lastResort.model}`,
-    );
-    return {
-      provider: lastResort.provider,
-      model: lastResort.model,
-      ruleName: 'fallback',
-      reason: `Fallback chain exhausted (all providers unhealthy); using ${lastResort.provider}/${lastResort.model}`,
-    };
-  }
-}
@@ -1,460 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { RoutingEngineService } from './routing-engine.service.js';
-import type { RoutingRule, TaskClassification } from './routing.types.js';
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-function makeRule(
-  overrides: Partial<RoutingRule> &
-    Pick<RoutingRule, 'name' | 'priority' | 'conditions' | 'action'>,
-): RoutingRule {
-  return {
-    id: overrides.id ?? crypto.randomUUID(),
-    scope: 'system',
-    enabled: true,
-    ...overrides,
-  };
-}
-
-function makeClassification(overrides: Partial<TaskClassification> = {}): TaskClassification {
-  return {
-    taskType: 'conversation',
-    complexity: 'simple',
-    domain: 'general',
-    requiredCapabilities: [],
-    ...overrides,
-  };
-}
-
-/** Build a minimal RoutingEngineService with mocked DB and ProviderService. */
-function makeService(
-  rules: RoutingRule[] = [],
-  healthMap: Record<string, { status: string }> = {},
-): RoutingEngineService {
-  const mockDb = {
-    select: vi.fn().mockReturnValue({
-      from: vi.fn().mockReturnValue({
-        where: vi.fn().mockReturnValue({
-          orderBy: vi.fn().mockResolvedValue(
-            rules.map((r) => ({
-              id: r.id,
-              name: r.name,
-              priority: r.priority,
-              scope: r.scope,
-              userId: r.userId ?? null,
-              conditions: r.conditions,
-              action: r.action,
-              enabled: r.enabled,
-              createdAt: new Date(),
-              updatedAt: new Date(),
-            })),
-          ),
-        }),
-      }),
-    }),
-  };
-
-  const mockProviderService = {
-    healthCheckAll: vi.fn().mockResolvedValue(healthMap),
-  };
-
-  // Inject mocked dependencies directly (bypass NestJS DI for unit tests)
-  const service = new (RoutingEngineService as unknown as new (
-    db: unknown,
-    ps: unknown,
-  ) => RoutingEngineService)(mockDb, mockProviderService);
-
-  return service;
-}
-
-// ─── matchConditions ──────────────────────────────────────────────────────────
-
-describe('RoutingEngineService.matchConditions', () => {
-  let service: RoutingEngineService;
-
-  beforeEach(() => {
-    service = makeService();
-  });
-
-  it('returns true for empty conditions array (catch-all rule)', () => {
-    const rule = makeRule({
-      name: 'fallback',
-      priority: 99,
-      conditions: [],
-      action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-    });
-    expect(service.matchConditions(rule, makeClassification())).toBe(true);
-  });
-
-  it('matches eq operator on scalar field', () => {
-    const rule = makeRule({
-      name: 'coding',
-      priority: 1,
-      conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-      action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-    });
-    expect(service.matchConditions(rule, makeClassification({ taskType: 'coding' }))).toBe(true);
-    expect(service.matchConditions(rule, makeClassification({ taskType: 'conversation' }))).toBe(
-      false,
-    );
-  });
-
-  it('matches in operator: field value is in the condition array', () => {
-    const rule = makeRule({
-      name: 'simple or moderate',
-      priority: 2,
-      conditions: [{ field: 'complexity', operator: 'in', value: ['simple', 'moderate'] }],
-      action: { provider: 'anthropic', model: 'claude-haiku-4-5' },
-    });
-    expect(service.matchConditions(rule, makeClassification({ complexity: 'simple' }))).toBe(true);
-    expect(service.matchConditions(rule, makeClassification({ complexity: 'moderate' }))).toBe(
-      true,
-    );
-    expect(service.matchConditions(rule, makeClassification({ complexity: 'complex' }))).toBe(
-      false,
-    );
-  });
-
-  it('matches includes operator: field array includes the condition value', () => {
-    const rule = makeRule({
-      name: 'reasoning required',
-      priority: 3,
-      conditions: [{ field: 'requiredCapabilities', operator: 'includes', value: 'reasoning' }],
-      action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-    });
-    expect(
-      service.matchConditions(rule, makeClassification({ requiredCapabilities: ['reasoning'] })),
-    ).toBe(true);
-    expect(
-      service.matchConditions(
-        rule,
-        makeClassification({ requiredCapabilities: ['tools', 'reasoning'] }),
-      ),
-    ).toBe(true);
-    expect(
-      service.matchConditions(rule, makeClassification({ requiredCapabilities: ['tools'] })),
-    ).toBe(false);
-    expect(service.matchConditions(rule, makeClassification({ requiredCapabilities: [] }))).toBe(
-      false,
-    );
-  });
-
-  it('requires ALL conditions to match (AND logic)', () => {
-    const rule = makeRule({
-      name: 'complex coding',
-      priority: 1,
-      conditions: [
-        { field: 'taskType', operator: 'eq', value: 'coding' },
-        { field: 'complexity', operator: 'eq', value: 'complex' },
-      ],
-      action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-    });
-
-    // Both match
-    expect(
-      service.matchConditions(
-        rule,
-        makeClassification({ taskType: 'coding', complexity: 'complex' }),
-      ),
-    ).toBe(true);
-
-    // Only one matches
-    expect(
-      service.matchConditions(
-        rule,
-        makeClassification({ taskType: 'coding', complexity: 'simple' }),
-      ),
-    ).toBe(false);
-
-    // Neither matches
-    expect(
-      service.matchConditions(
-        rule,
-        makeClassification({ taskType: 'conversation', complexity: 'simple' }),
-      ),
-    ).toBe(false);
-  });
-
-  it('returns false for eq when condition value is an array (type mismatch)', () => {
-    const rule = makeRule({
-      name: 'bad eq',
-      priority: 1,
-      conditions: [{ field: 'taskType', operator: 'eq', value: ['coding', 'research'] }],
-      action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-    });
-    expect(service.matchConditions(rule, makeClassification({ taskType: 'coding' }))).toBe(false);
-  });
-
-  it('returns false for includes when field is not an array', () => {
-    const rule = makeRule({
-      name: 'bad includes',
-      priority: 1,
-      conditions: [{ field: 'taskType', operator: 'includes', value: 'coding' }],
-      action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-    });
-    // taskType is a string, not an array — should be false
-    expect(service.matchConditions(rule, makeClassification({ taskType: 'coding' }))).toBe(false);
-  });
-});
-
-// ─── resolve — priority ordering ─────────────────────────────────────────────
-
-describe('RoutingEngineService.resolve — priority ordering', () => {
-  it('selects the highest-priority matching rule', async () => {
-    // Rules are supplied in priority-ascending order, as the DB would return them.
-    const rules = [
-      makeRule({
-        name: 'high priority',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-      }),
-      makeRule({
-        name: 'low priority',
-        priority: 10,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'openai', model: 'gpt-4o' },
-      }),
-    ];
-
-    const service = makeService(rules, { anthropic: { status: 'up' }, openai: { status: 'up' } });
-
-    const decision = await service.resolve('implement a function');
-    expect(decision.ruleName).toBe('high priority');
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-opus-4-6');
-  });
-
-  it('skips non-matching rules and picks first match', async () => {
-    const rules = [
-      makeRule({
-        name: 'research rule',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'research' }],
-        action: { provider: 'openai', model: 'gpt-4o' },
-      }),
-      makeRule({
-        name: 'coding rule',
-        priority: 2,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-      }),
-    ];
-
-    const service = makeService(rules, { anthropic: { status: 'up' }, openai: { status: 'up' } });
-
-    const decision = await service.resolve('implement a function');
-    expect(decision.ruleName).toBe('coding rule');
-    expect(decision.provider).toBe('anthropic');
-  });
-});
-
-// ─── resolve — unhealthy provider fallback ────────────────────────────────────
-
-describe('RoutingEngineService.resolve — unhealthy provider handling', () => {
-  it('skips matched rule when provider is unhealthy, tries next rule', async () => {
-    const rules = [
-      makeRule({
-        name: 'primary rule',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-      }),
-      makeRule({
-        name: 'secondary rule',
-        priority: 2,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'openai', model: 'gpt-4o' },
-      }),
-    ];
-
-    const service = makeService(rules, {
-      anthropic: { status: 'down' }, // primary is unhealthy
-      openai: { status: 'up' },
-    });
-
-    const decision = await service.resolve('implement a function');
-    expect(decision.ruleName).toBe('secondary rule');
-    expect(decision.provider).toBe('openai');
-  });
-
-  it('falls back to Sonnet when all rules have unhealthy providers', async () => {
-    // Override the rule's provider to something unhealthy but keep anthropic up for fallback
-    const unhealthyRules = [
-      makeRule({
-        name: 'only rule',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'openai', model: 'gpt-4o' }, // openai is unhealthy
-      }),
-    ];
-
-    const service2 = makeService(unhealthyRules, {
-      anthropic: { status: 'up' },
-      openai: { status: 'down' },
-    });
-
-    const decision = await service2.resolve('implement a function');
-    // Should fall through to Sonnet fallback on anthropic
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-sonnet-4-6');
-    expect(decision.ruleName).toBe('fallback');
-  });
-
-  it('falls back to Haiku when Sonnet provider is also down', async () => {
-    const rules: RoutingRule[] = []; // no rules
-
-    const service = makeService(rules, {
-      anthropic: { status: 'down' }, // Sonnet is on anthropic — down
-      ollama: { status: 'up' }, // Haiku is also on anthropic — use Ollama as next
-    });
-
-    const decision = await service.resolve('hello there');
-    // Sonnet (anthropic) is down, Haiku (anthropic) is down, Ollama is up
-    expect(decision.provider).toBe('ollama');
-    expect(decision.model).toBe('llama3.2');
-    expect(decision.ruleName).toBe('fallback');
-  });
-
-  it('uses last resort (Sonnet) when all fallback providers are unhealthy', async () => {
-    const rules: RoutingRule[] = [];
-
-    const service = makeService(rules, {
-      anthropic: { status: 'down' },
-      ollama: { status: 'down' },
-    });
-
-    const decision = await service.resolve('hello');
-    // All unhealthy — still returns first fallback entry as last resort
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-sonnet-4-6');
-    expect(decision.ruleName).toBe('fallback');
-  });
-});
-
-// ─── resolve — empty conditions (catch-all rule) ──────────────────────────────
-
-describe('RoutingEngineService.resolve — empty conditions (fallback rule)', () => {
-  it('matches catch-all rule for any message', async () => {
-    const rules = [
-      makeRule({
-        name: 'catch-all',
-        priority: 99,
-        conditions: [],
-        action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-      }),
-    ];
-
-    const service = makeService(rules, { anthropic: { status: 'up' } });
-
-    const decision = await service.resolve('completely unrelated message xyz');
-    expect(decision.ruleName).toBe('catch-all');
-    expect(decision.provider).toBe('anthropic');
-    expect(decision.model).toBe('claude-sonnet-4-6');
-  });
-
-  it('catch-all is overridden by a higher-priority specific rule', async () => {
-    const rules = [
-      makeRule({
-        name: 'specific coding rule',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-      }),
-      makeRule({
-        name: 'catch-all',
-        priority: 99,
-        conditions: [],
-        action: { provider: 'anthropic', model: 'claude-haiku-4-5' },
-      }),
-    ];
-
-    const service = makeService(rules, { anthropic: { status: 'up' } });
-
-    const codingDecision = await service.resolve('implement a function');
-    expect(codingDecision.ruleName).toBe('specific coding rule');
-    expect(codingDecision.model).toBe('claude-opus-4-6');
-
-    const conversationDecision = await service.resolve('hello how are you');
-    expect(conversationDecision.ruleName).toBe('catch-all');
-    expect(conversationDecision.model).toBe('claude-haiku-4-5');
-  });
-});
-
-// ─── resolve — disabled rules ─────────────────────────────────────────────────
-
-describe('RoutingEngineService.resolve — disabled rules', () => {
-  it('skips disabled rules', async () => {
-    const rules = [
-      makeRule({
-        name: 'disabled rule',
-        priority: 1,
-        enabled: false,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-      }),
-      makeRule({
-        name: 'enabled fallback',
-        priority: 99,
-        conditions: [],
-        action: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-      }),
-    ];
-
-    const service = makeService(rules, { anthropic: { status: 'up' } });
-
-    const decision = await service.resolve('implement a function');
-    expect(decision.ruleName).toBe('enabled fallback');
-    expect(decision.model).toBe('claude-sonnet-4-6');
-  });
-});
-
-// ─── resolve — pre-fetched health map ────────────────────────────────────────
-
-describe('RoutingEngineService.resolve — availableProviders override', () => {
-  it('uses the provided health map instead of calling healthCheckAll', async () => {
-    const rules = [
-      makeRule({
-        name: 'coding rule',
-        priority: 1,
-        conditions: [{ field: 'taskType', operator: 'eq', value: 'coding' }],
-        action: { provider: 'anthropic', model: 'claude-opus-4-6' },
-      }),
-    ];
-
-    const mockHealthCheckAll = vi.fn().mockResolvedValue({});
-    const mockDb = {
-      select: vi.fn().mockReturnValue({
-        from: vi.fn().mockReturnValue({
-          where: vi.fn().mockReturnValue({
-            orderBy: vi.fn().mockResolvedValue(
-              rules.map((r) => ({
-                id: r.id,
-                name: r.name,
-                priority: r.priority,
-                scope: r.scope,
-                userId: r.userId ?? null,
-                conditions: r.conditions,
-                action: r.action,
-                enabled: r.enabled,
-                createdAt: new Date(),
-                updatedAt: new Date(),
-              })),
-            ),
-          }),
-        }),
-      }),
-    };
-    const mockProviderService = { healthCheckAll: mockHealthCheckAll };
-
-    const service = new (RoutingEngineService as unknown as new (
-      db: unknown,
-      ps: unknown,
-    ) => RoutingEngineService)(mockDb, mockProviderService);
-
-    const preSupplied = { anthropic: { status: 'up' } };
-    await service.resolve('implement a function', undefined, preSupplied);
-
-    expect(mockHealthCheckAll).not.toHaveBeenCalled();
-  });
-});
@@ -1,234 +0,0 @@
-import {
-  Body,
-  Controller,
-  Delete,
-  ForbiddenException,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  NotFoundException,
-  Param,
-  Patch,
-  Post,
-  UseGuards,
-} from '@nestjs/common';
-import { routingRules, type Db, and, asc, eq, or, inArray } from '@mosaicstack/db';
-import { DB } from '../../database/database.module.js';
-import { AuthGuard } from '../../auth/auth.guard.js';
-import { CurrentUser } from '../../auth/current-user.decorator.js';
-import {
-  CreateRoutingRuleDto,
-  UpdateRoutingRuleDto,
-  ReorderRoutingRulesDto,
-} from './routing.dto.js';
-
-@Controller('api/routing/rules')
-@UseGuards(AuthGuard)
-export class RoutingController {
-  constructor(@Inject(DB) private readonly db: Db) {}
-
-  /**
-   * GET /api/routing/rules
-   * List all rules visible to the authenticated user:
-   * - All system rules
-   * - User's own rules
-   * Ordered by priority ascending (lower number = higher priority).
-   */
-  @Get()
-  async list(@CurrentUser() user: { id: string }) {
-    const rows = await this.db
-      .select()
-      .from(routingRules)
-      .where(
-        or(
-          eq(routingRules.scope, 'system'),
-          and(eq(routingRules.scope, 'user'), eq(routingRules.userId, user.id)),
-        ),
-      )
-      .orderBy(asc(routingRules.priority));
-
-    return rows;
-  }
-
-  /**
-   * GET /api/routing/rules/effective
-   * Return the merged rule set in priority order.
-   * User-scoped rules are checked before system rules at the same priority
-   * (achieved by ordering: priority ASC, then scope='user' first).
-   */
-  @Get('effective')
-  async effective(@CurrentUser() user: { id: string }) {
-    const rows = await this.db
-      .select()
-      .from(routingRules)
-      .where(
-        and(
-          eq(routingRules.enabled, true),
-          or(
-            eq(routingRules.scope, 'system'),
-            and(eq(routingRules.scope, 'user'), eq(routingRules.userId, user.id)),
-          ),
-        ),
-      )
-      .orderBy(asc(routingRules.priority));
-
-    // For rules with the same priority: user rules beat system rules.
-    // Group by priority then stable-sort each group: user before system.
-    const grouped = new Map<number, typeof rows>();
-    for (const row of rows) {
-      const bucket = grouped.get(row.priority) ?? [];
-      bucket.push(row);
-      grouped.set(row.priority, bucket);
-    }
-
-    const effective: typeof rows = [];
-    for (const [, bucket] of [...grouped.entries()].sort(([a], [b]) => a - b)) {
-      // user-scoped rules first within the same priority bucket
-      const userRules = bucket.filter((r) => r.scope === 'user');
-      const systemRules = bucket.filter((r) => r.scope === 'system');
-      effective.push(...userRules, ...systemRules);
-    }
-
-    return effective;
-  }
-
-  /**
-   * POST /api/routing/rules
-   * Create a new routing rule. Scope is forced to 'user' (users cannot create
-   * system rules). The authenticated user's ID is attached automatically.
-   */
-  @Post()
-  async create(@Body() dto: CreateRoutingRuleDto, @CurrentUser() user: { id: string }) {
-    const [created] = await this.db
-      .insert(routingRules)
-      .values({
-        name: dto.name,
-        priority: dto.priority,
-        scope: 'user',
-        userId: user.id,
-        conditions: dto.conditions as unknown as Record<string, unknown>[],
-        action: dto.action as unknown as Record<string, unknown>,
-        enabled: dto.enabled ?? true,
-      })
-      .returning();
-
-    return created;
-  }
-
-  /**
-   * PATCH /api/routing/rules/reorder
-   * Reassign priorities so that the order of `ruleIds` reflects ascending
-   * priority (index 0 = priority 0, index 1 = priority 1, …).
-   * Only the authenticated user's own rules can be reordered.
-   */
-  @Patch('reorder')
-  async reorder(@Body() dto: ReorderRoutingRulesDto, @CurrentUser() user: { id: string }) {
-    // Verify all supplied IDs belong to this user
-    const owned = await this.db
-      .select({ id: routingRules.id })
-      .from(routingRules)
-      .where(
-        and(
-          inArray(routingRules.id, dto.ruleIds),
-          eq(routingRules.scope, 'user'),
-          eq(routingRules.userId, user.id),
-        ),
-      );
-
-    const ownedIds = new Set(owned.map((r) => r.id));
-    const unowned = dto.ruleIds.filter((id) => !ownedIds.has(id));
-    if (unowned.length > 0) {
-      throw new ForbiddenException(
-        `Cannot reorder rules that do not belong to you: ${unowned.join(', ')}`,
-      );
-    }
-
-    // Apply new priorities in transaction
-    const updates = await this.db.transaction(async (tx) => {
-      const results = [];
-      for (let i = 0; i < dto.ruleIds.length; i++) {
-        const [updated] = await tx
-          .update(routingRules)
-          .set({ priority: i, updatedAt: new Date() })
-          .where(and(eq(routingRules.id, dto.ruleIds[i]!), eq(routingRules.userId, user.id)))
-          .returning();
-        if (updated) results.push(updated);
-      }
-      return results;
-    });
-
-    return updates;
-  }
-
-  /**
-   * PATCH /api/routing/rules/:id
-   * Update a user-owned rule. System rules cannot be modified by regular users.
-   */
-  @Patch(':id')
-  async update(
-    @Param('id') id: string,
-    @Body() dto: UpdateRoutingRuleDto,
-    @CurrentUser() user: { id: string },
-  ) {
-    const [existing] = await this.db.select().from(routingRules).where(eq(routingRules.id, id));
-
-    if (!existing) throw new NotFoundException('Routing rule not found');
-
-    if (existing.scope === 'system') {
-      throw new ForbiddenException('System routing rules cannot be modified');
-    }
-
-    if (existing.userId !== user.id) {
-      throw new ForbiddenException('Routing rule does not belong to the current user');
-    }
-
-    const updatePayload: Partial<typeof routingRules.$inferInsert> = {
-      updatedAt: new Date(),
-    };
-
-    if (dto.name !== undefined) updatePayload.name = dto.name;
-    if (dto.priority !== undefined) updatePayload.priority = dto.priority;
-    if (dto.conditions !== undefined)
-      updatePayload.conditions = dto.conditions as unknown as Record<string, unknown>[];
-    if (dto.action !== undefined)
-      updatePayload.action = dto.action as unknown as Record<string, unknown>;
-    if (dto.enabled !== undefined) updatePayload.enabled = dto.enabled;
-
-    const [updated] = await this.db
-      .update(routingRules)
-      .set(updatePayload)
-      .where(and(eq(routingRules.id, id), eq(routingRules.userId, user.id)))
-      .returning();
-
-    if (!updated) throw new NotFoundException('Routing rule not found');
-    return updated;
-  }
-
-  /**
-   * DELETE /api/routing/rules/:id
-   * Delete a user-owned routing rule. System rules cannot be deleted.
-   */
-  @Delete(':id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  async remove(@Param('id') id: string, @CurrentUser() user: { id: string }) {
-    const [existing] = await this.db.select().from(routingRules).where(eq(routingRules.id, id));
-
-    if (!existing) throw new NotFoundException('Routing rule not found');
-
-    if (existing.scope === 'system') {
-      throw new ForbiddenException('System routing rules cannot be deleted');
-    }
-
-    if (existing.userId !== user.id) {
-      throw new ForbiddenException('Routing rule does not belong to the current user');
-    }
-
-    const [deleted] = await this.db
-      .delete(routingRules)
-      .where(and(eq(routingRules.id, id), eq(routingRules.userId, user.id)))
-      .returning();
-
-    if (!deleted) throw new NotFoundException('Routing rule not found');
-  }
-}
@@ -1,135 +0,0 @@
-import {
-  IsArray,
-  IsBoolean,
-  IsInt,
-  IsIn,
-  IsObject,
-  IsOptional,
-  IsString,
-  IsUUID,
-  MaxLength,
-  Min,
-  ValidateNested,
-  ArrayNotEmpty,
-} from 'class-validator';
-import { Type } from 'class-transformer';
-
-// ─── Condition DTO ────────────────────────────────────────────────────────────
-
-const conditionFields = [
-  'taskType',
-  'complexity',
-  'domain',
-  'costTier',
-  'requiredCapabilities',
-] as const;
-const conditionOperators = ['eq', 'in', 'includes'] as const;
-
-export class RoutingConditionDto {
-  @IsString()
-  @IsIn(conditionFields)
-  field!: (typeof conditionFields)[number];
-
-  @IsString()
-  @IsIn(conditionOperators)
-  operator!: (typeof conditionOperators)[number];
-
-  // value can be string or string[] — keep as unknown and validate at runtime
-  value!: string | string[];
-}
-
-// ─── Action DTO ───────────────────────────────────────────────────────────────
-
-export class RoutingActionDto {
-  @IsString()
-  @MaxLength(255)
-  provider!: string;
-
-  @IsString()
-  @MaxLength(255)
-  model!: string;
-
-  @IsOptional()
-  @IsUUID()
-  agentConfigId?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(50_000)
-  systemPromptOverride?: string;
-
-  @IsOptional()
-  @IsArray()
-  toolAllowlist?: string[];
-}
-
-// ─── Create DTO ───────────────────────────────────────────────────────────────
-
-const scopeValues = ['system', 'user'] as const;
-
-export class CreateRoutingRuleDto {
-  @IsString()
-  @MaxLength(255)
-  name!: string;
-
-  @IsInt()
-  @Min(0)
-  priority!: number;
-
-  @IsOptional()
-  @IsIn(scopeValues)
-  scope?: 'system' | 'user';
-
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => RoutingConditionDto)
-  conditions!: RoutingConditionDto[];
-
-  @IsObject()
-  @ValidateNested()
-  @Type(() => RoutingActionDto)
-  action!: RoutingActionDto;
-
-  @IsOptional()
-  @IsBoolean()
-  enabled?: boolean;
-}
-
-// ─── Update DTO ───────────────────────────────────────────────────────────────
-
-export class UpdateRoutingRuleDto {
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  name?: string;
-
-  @IsOptional()
-  @IsInt()
-  @Min(0)
-  priority?: number;
-
-  @IsOptional()
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => RoutingConditionDto)
-  conditions?: RoutingConditionDto[];
-
-  @IsOptional()
-  @IsObject()
-  @ValidateNested()
-  @Type(() => RoutingActionDto)
-  action?: RoutingActionDto;
-
-  @IsOptional()
-  @IsBoolean()
-  enabled?: boolean;
-}
-
-// ─── Reorder DTO ──────────────────────────────────────────────────────────────
-
-export class ReorderRoutingRulesDto {
-  @IsArray()
-  @ArrayNotEmpty()
-  @IsUUID(undefined, { each: true })
-  ruleIds!: string[];
-}
@@ -1,118 +0,0 @@
-/**
- * Routing engine types — M4-002 (condition types) and M4-003 (action types).
- *
- * These types are re-exported from `@mosaicstack/types` for shared use across packages.
- */
-
-// ─── Classification primitives ───────────────────────────────────────────────
-
-/** Category of work the agent is being asked to perform */
-export type TaskType =
-  | 'coding'
-  | 'research'
-  | 'summarization'
-  | 'conversation'
-  | 'analysis'
-  | 'creative';
-
-/** Estimated complexity of the task, used to bias toward cheaper or more capable models */
-export type Complexity = 'simple' | 'moderate' | 'complex';
-
-/** Primary knowledge domain of the task */
-export type Domain = 'frontend' | 'backend' | 'devops' | 'docs' | 'general';
-
-/**
- * Cost tier for model selection.
- * Extends the existing `CostTier` in `@mosaicstack/types` with `local` for self-hosted models.
- */
-export type CostTier = 'cheap' | 'standard' | 'premium' | 'local';
-
-/** Special model capability required by the task */
-export type Capability = 'tools' | 'vision' | 'long-context' | 'reasoning' | 'embedding';
-
-// ─── Condition types ─────────────────────────────────────────────────────────
-
-/**
- * A single predicate that must be satisfied for a routing rule to match.
- *
- * - `eq`       — scalar equality: `field === value`
- * - `in`       — set membership: `value` contains `field`
- * - `includes` — array containment: `field` (array) includes `value`
- */
-export interface RoutingCondition {
-  /** The task-classification field to test */
-  field: 'taskType' | 'complexity' | 'domain' | 'costTier' | 'requiredCapabilities';
-  /** Comparison operator */
-  operator: 'eq' | 'in' | 'includes';
-  /** Expected value or set of values */
-  value: string | string[];
-}
-
-// ─── Action types ────────────────────────────────────────────────────────────
-
-/**
- * The routing action to execute when all conditions in a rule are satisfied.
- */
-export interface RoutingAction {
-  /** LLM provider identifier, e.g. `'anthropic'`, `'openai'`, `'ollama'` */
-  provider: string;
-  /** Model identifier, e.g. `'claude-opus-4-6'`, `'gpt-4o'` */
-  model: string;
-  /** Optional: use a specific pre-configured agent config from the agent registry */
-  agentConfigId?: string;
-  /** Optional: override the agent's default system prompt for this route */
-  systemPromptOverride?: string;
-  /** Optional: restrict the tool set available to the agent for this route */
-  toolAllowlist?: string[];
-}
-
-// ─── Rule and decision types ─────────────────────────────────────────────────
-
-/**
- * Full routing rule as stored in the database and used at runtime.
- */
-export interface RoutingRule {
-  /** UUID primary key */
-  id: string;
-  /** Human-readable rule name */
-  name: string;
-  /** Lower number = evaluated first; unique per scope */
-  priority: number;
-  /** `'system'` rules apply globally; `'user'` rules override for a specific user */
-  scope: 'system' | 'user';
-  /** Present only for `'user'`-scoped rules */
-  userId?: string;
-  /** All conditions must match for the rule to fire */
-  conditions: RoutingCondition[];
-  /** Action to take when all conditions are met */
-  action: RoutingAction;
-  /** Whether this rule is active */
-  enabled: boolean;
-}
-
-/**
- * Structured representation of what an agent has been asked to do,
- * produced by the task classifier and consumed by the routing engine.
- */
-export interface TaskClassification {
-  taskType: TaskType;
-  complexity: Complexity;
-  domain: Domain;
-  requiredCapabilities: Capability[];
-}
-
-/**
- * Output of the routing engine — which model to use and why.
- */
-export interface RoutingDecision {
-  /** LLM provider identifier */
-  provider: string;
-  /** Model identifier */
-  model: string;
-  /** Optional agent config to apply */
-  agentConfigId?: string;
-  /** Name of the rule that matched, for observability */
-  ruleName: string;
-  /** Human-readable explanation of why this rule was selected */
-  reason: string;
-}
@@ -1,366 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { classifyTask } from './task-classifier.js';
-
-// ─── Task Type Detection ──────────────────────────────────────────────────────
-
-describe('classifyTask — taskType', () => {
-  it('detects coding from "code" keyword', () => {
-    expect(classifyTask('Can you write some code for me?').taskType).toBe('coding');
-  });
-
-  it('detects coding from "implement" keyword', () => {
-    expect(classifyTask('Implement a binary search algorithm').taskType).toBe('coding');
-  });
-
-  it('detects coding from "function" keyword', () => {
-    expect(classifyTask('Write a function that reverses a string').taskType).toBe('coding');
-  });
-
-  it('detects coding from "debug" keyword', () => {
-    expect(classifyTask('Help me debug this error').taskType).toBe('coding');
-  });
-
-  it('detects coding from "fix" keyword', () => {
-    expect(classifyTask('fix the broken test').taskType).toBe('coding');
-  });
-
-  it('detects coding from "refactor" keyword', () => {
-    expect(classifyTask('Please refactor this module').taskType).toBe('coding');
-  });
-
-  it('detects coding from "typescript" keyword', () => {
-    expect(classifyTask('How do I use generics in TypeScript?').taskType).toBe('coding');
-  });
-
-  it('detects coding from "javascript" keyword', () => {
-    expect(classifyTask('JavaScript promises explained').taskType).toBe('coding');
-  });
-
-  it('detects coding from "python" keyword', () => {
-    expect(classifyTask('Write a Python script to parse CSV').taskType).toBe('coding');
-  });
-
-  it('detects coding from "SQL" keyword', () => {
-    expect(classifyTask('Write a SQL query to join these tables').taskType).toBe('coding');
-  });
-
-  it('detects coding from "API" keyword', () => {
-    expect(classifyTask('Design an API for user management').taskType).toBe('coding');
-  });
-
-  it('detects coding from "endpoint" keyword', () => {
-    expect(classifyTask('Add a new endpoint for user profiles').taskType).toBe('coding');
-  });
-
-  it('detects coding from "class" keyword', () => {
-    expect(classifyTask('Create a class for handling payments').taskType).toBe('coding');
-  });
-
-  it('detects coding from "method" keyword', () => {
-    expect(classifyTask('Add a method to validate emails').taskType).toBe('coding');
-  });
-
-  it('detects coding from inline backtick code', () => {
-    expect(classifyTask('What does `Array.prototype.reduce` do?').taskType).toBe('coding');
-  });
-
-  it('detects summarization from "summarize"', () => {
-    expect(classifyTask('Please summarize this document').taskType).toBe('summarization');
-  });
-
-  it('detects summarization from "summary"', () => {
-    expect(classifyTask('Give me a summary of the meeting').taskType).toBe('summarization');
-  });
-
-  it('detects summarization from "tldr"', () => {
-    expect(classifyTask('TLDR this article for me').taskType).toBe('summarization');
-  });
-
-  it('detects summarization from "condense"', () => {
-    expect(classifyTask('Condense this into 3 bullet points').taskType).toBe('summarization');
-  });
-
-  it('detects summarization from "brief"', () => {
-    expect(classifyTask('Give me a brief overview of this topic').taskType).toBe('summarization');
-  });
-
-  it('detects creative from "write"', () => {
-    expect(classifyTask('Write a short story about a dragon').taskType).toBe('creative');
-  });
-
-  it('detects creative from "story"', () => {
-    expect(classifyTask('Tell me a story about space exploration').taskType).toBe('creative');
-  });
-
-  it('detects creative from "poem"', () => {
-    expect(classifyTask('Write a poem about autumn').taskType).toBe('creative');
-  });
-
-  it('detects creative from "generate"', () => {
-    expect(classifyTask('Generate some creative marketing copy').taskType).toBe('creative');
-  });
-
-  it('detects creative from "create content"', () => {
-    expect(classifyTask('Help me create content for my website').taskType).toBe('creative');
-  });
-
-  it('detects creative from "blog post"', () => {
-    expect(classifyTask('Write a blog post about productivity habits').taskType).toBe('creative');
-  });
-
-  it('detects analysis from "analyze"', () => {
-    expect(classifyTask('Analyze the performance of this system').taskType).toBe('analysis');
-  });
-
-  it('detects analysis from "review"', () => {
-    expect(classifyTask('Please review my pull request changes').taskType).toBe('analysis');
-  });
-
-  it('detects analysis from "evaluate"', () => {
-    expect(classifyTask('Evaluate the pros and cons of this approach').taskType).toBe('analysis');
-  });
-
-  it('detects analysis from "assess"', () => {
-    expect(classifyTask('Assess the security risks here').taskType).toBe('analysis');
-  });
-
-  it('detects analysis from "audit"', () => {
-    expect(classifyTask('Audit this codebase for vulnerabilities').taskType).toBe('analysis');
-  });
-
-  it('detects research from "research"', () => {
-    expect(classifyTask('Research the best state management libraries').taskType).toBe('research');
-  });
-
-  it('detects research from "find"', () => {
-    expect(classifyTask('Find all open issues in our backlog').taskType).toBe('research');
-  });
-
-  it('detects research from "search"', () => {
-    expect(classifyTask('Search for papers on transformer architectures').taskType).toBe(
-      'research',
-    );
-  });
-
-  it('detects research from "what is"', () => {
-    expect(classifyTask('What is the difference between REST and GraphQL?').taskType).toBe(
-      'research',
-    );
-  });
-
-  it('detects research from "explain"', () => {
-    expect(classifyTask('Explain how OAuth2 works').taskType).toBe('research');
-  });
-
-  it('detects research from "how does"', () => {
-    expect(classifyTask('How does garbage collection work in V8?').taskType).toBe('research');
-  });
-
-  it('detects research from "compare"', () => {
-    expect(classifyTask('Compare Postgres and MySQL for this use case').taskType).toBe('research');
-  });
-
-  it('falls back to conversation with no strong signal', () => {
-    expect(classifyTask('Hello, how are you?').taskType).toBe('conversation');
-  });
-
-  it('falls back to conversation for generic greetings', () => {
-    expect(classifyTask('Good morning!').taskType).toBe('conversation');
-  });
-
-  // Priority: coding wins over research when both keywords present
-  it('coding takes priority over research', () => {
-    expect(classifyTask('find a code example for sorting').taskType).toBe('coding');
-  });
-
-  // Priority: summarization wins over creative
-  it('summarization takes priority over creative', () => {
-    expect(classifyTask('write a summary of this article').taskType).toBe('summarization');
-  });
-});
-
-// ─── Complexity Estimation ────────────────────────────────────────────────────
-
-describe('classifyTask — complexity', () => {
-  it('classifies short message as simple', () => {
-    expect(classifyTask('Fix typo').complexity).toBe('simple');
-  });
-
-  it('classifies single question as simple', () => {
-    expect(classifyTask('What is a closure?').complexity).toBe('simple');
-  });
-
-  it('classifies message > 500 chars as complex', () => {
-    const long = 'a'.repeat(501);
-    expect(classifyTask(long).complexity).toBe('complex');
-  });
-
-  it('classifies message with "architecture" keyword as complex', () => {
-    expect(
-      classifyTask('Can you help me think through the architecture of this system?').complexity,
-    ).toBe('complex');
-  });
-
-  it('classifies message with "design" keyword as complex', () => {
-    expect(classifyTask('Design a data model for this feature').complexity).toBe('complex');
-  });
-
-  it('classifies message with "complex" keyword as complex', () => {
-    expect(classifyTask('This is a complex problem involving multiple services').complexity).toBe(
-      'complex',
-    );
-  });
-
-  it('classifies message with "system" keyword as complex', () => {
-    expect(classifyTask('Explain the whole system behavior').complexity).toBe('complex');
-  });
-
-  it('classifies message with multiple code blocks as complex', () => {
-    const msg = '```\nconst a = 1;\n```\n\nAlso look at\n\n```\nconst b = 2;\n```';
-    expect(classifyTask(msg).complexity).toBe('complex');
-  });
-
-  it('classifies moderate-length message as moderate', () => {
-    const msg =
-      'Please help me implement a small utility function that parses query strings. It should handle arrays and nested objects properly.';
-    expect(classifyTask(msg).complexity).toBe('moderate');
-  });
-});
-
-// ─── Domain Detection ─────────────────────────────────────────────────────────
-
-describe('classifyTask — domain', () => {
-  it('detects frontend from "react"', () => {
-    expect(classifyTask('How do I use React hooks?').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "css"', () => {
-    expect(classifyTask('Fix the CSS layout issue').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "html"', () => {
-    expect(classifyTask('Add an HTML form element').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "component"', () => {
-    expect(classifyTask('Create a reusable component').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "UI"', () => {
-    expect(classifyTask('Update the UI spacing').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "tailwind"', () => {
-    expect(classifyTask('Style this button with Tailwind').domain).toBe('frontend');
-  });
-
-  it('detects frontend from "next.js"', () => {
-    expect(classifyTask('Configure Next.js routing').domain).toBe('frontend');
-  });
-
-  it('detects backend from "server"', () => {
-    expect(classifyTask('Set up the server to handle requests').domain).toBe('backend');
-  });
-
-  it('detects backend from "database"', () => {
-    expect(classifyTask('Optimize this database query').domain).toBe('backend');
-  });
-
-  it('detects backend from "endpoint"', () => {
-    expect(classifyTask('Add an endpoint for authentication').domain).toBe('backend');
-  });
-
-  it('detects backend from "nest"', () => {
-    expect(classifyTask('Add a NestJS guard for this route').domain).toBe('backend');
-  });
-
-  it('detects backend from "express"', () => {
-    expect(classifyTask('Middleware in Express explained').domain).toBe('backend');
-  });
-
-  it('detects devops from "docker"', () => {
-    expect(classifyTask('Write a Dockerfile for this app').domain).toBe('devops');
-  });
-
-  it('detects devops from "deploy"', () => {
-    expect(classifyTask('Deploy this service to production').domain).toBe('devops');
-  });
-
-  it('detects devops from "pipeline"', () => {
-    expect(classifyTask('Set up a CI pipeline').domain).toBe('devops');
-  });
-
-  it('detects devops from "kubernetes"', () => {
-    expect(classifyTask('Configure a Kubernetes deployment').domain).toBe('devops');
-  });
-
-  it('detects docs from "documentation"', () => {
-    expect(classifyTask('Write documentation for this module').domain).toBe('docs');
-  });
-
-  it('detects docs from "readme"', () => {
-    expect(classifyTask('Update the README').domain).toBe('docs');
-  });
-
-  it('detects docs from "guide"', () => {
-    expect(classifyTask('Create a user guide for this feature').domain).toBe('docs');
-  });
-
-  it('falls back to general domain', () => {
-    expect(classifyTask('What time is it?').domain).toBe('general');
-  });
-
-  // devops takes priority over backend when both match
-  it('devops takes priority over backend (both keywords)', () => {
-    expect(classifyTask('Deploy the API server using Docker').domain).toBe('devops');
-  });
-
-  // docs takes priority over frontend when both match
-  it('docs takes priority over frontend (both keywords)', () => {
-    expect(classifyTask('Write documentation for React components').domain).toBe('docs');
-  });
-});
-
-// ─── Combined Classification ──────────────────────────────────────────────────
-
-describe('classifyTask — combined', () => {
-  it('returns full classification object', () => {
-    const result = classifyTask('Fix the bug?');
-    expect(result).toHaveProperty('taskType');
-    expect(result).toHaveProperty('complexity');
-    expect(result).toHaveProperty('domain');
-  });
-
-  it('classifies complex TypeScript architecture request', () => {
-    const msg =
-      'Design the architecture for a multi-tenant TypeScript system using NestJS with proper database isolation and role-based access control. The system needs to support multiple organizations each with their own data namespace.';
-    const result = classifyTask(msg);
-    expect(result.taskType).toBe('coding');
-    expect(result.complexity).toBe('complex');
-    expect(result.domain).toBe('backend');
-  });
-
-  it('classifies simple frontend question', () => {
-    const result = classifyTask('How do I center a div in CSS?');
-    expect(result.taskType).toBe('research');
-    expect(result.domain).toBe('frontend');
-  });
-
-  it('classifies a DevOps pipeline task as complex', () => {
-    const msg =
-      'Design a complete CI/CD pipeline architecture using Docker and Kubernetes with blue-green deployments and automatic rollback capabilities for a complex microservices system.';
-    const result = classifyTask(msg);
-    expect(result.domain).toBe('devops');
-    expect(result.complexity).toBe('complex');
-  });
-
-  it('classifies summarization task correctly', () => {
-    const result = classifyTask('Summarize the key points from this document');
-    expect(result.taskType).toBe('summarization');
-  });
-
-  it('classifies creative writing task correctly', () => {
-    const result = classifyTask('Write a poem about the ocean');
-    expect(result.taskType).toBe('creative');
-  });
-});
@@ -1,159 +0,0 @@
-import type { TaskType, Complexity, Domain, TaskClassification } from './routing.types.js';
-
-// ─── Pattern Banks ──────────────────────────────────────────────────────────
-
-const CODING_PATTERNS: RegExp[] = [
-  /\bcode\b/i,
-  /\bfunction\b/i,
-  /\bimplement\b/i,
-  /\bdebug\b/i,
-  /\bfix\b/i,
-  /\brefactor\b/i,
-  /\btypescript\b/i,
-  /\bjavascript\b/i,
-  /\bpython\b/i,
-  /\bSQL\b/i,
-  /\bAPI\b/i,
-  /\bendpoint\b/i,
-  /\bclass\b/i,
-  /\bmethod\b/i,
-  /`[^`]*`/,
-];
-
-const RESEARCH_PATTERNS: RegExp[] = [
-  /\bresearch\b/i,
-  /\bfind\b/i,
-  /\bsearch\b/i,
-  /\bwhat is\b/i,
-  /\bexplain\b/i,
-  /\bhow do(es)?\b/i,
-  /\bcompare\b/i,
-  /\banalyze\b/i,
-];
-
-const SUMMARIZATION_PATTERNS: RegExp[] = [
-  /\bsummariz(e|ation)\b/i,
-  /\bsummary\b/i,
-  /\btldr\b/i,
-  /\bcondense\b/i,
-  /\bbrief\b/i,
-];
-
-const CREATIVE_PATTERNS: RegExp[] = [
-  /\bwrite\b/i,
-  /\bstory\b/i,
-  /\bpoem\b/i,
-  /\bgenerate\b/i,
-  /\bcreate content\b/i,
-  /\bblog post\b/i,
-];
-
-const ANALYSIS_PATTERNS: RegExp[] = [
-  /\banalyze\b/i,
-  /\breview\b/i,
-  /\bevaluate\b/i,
-  /\bassess\b/i,
-  /\baudit\b/i,
-];
-
-// ─── Complexity Indicators ───────────────────────────────────────────────────
-
-const COMPLEX_KEYWORDS: RegExp[] = [
-  /\barchitecture\b/i,
-  /\bdesign\b/i,
-  /\bcomplex\b/i,
-  /\bsystem\b/i,
-];
-
-const SIMPLE_QUESTION_PATTERN = /^[^.!?]+[?]$/;
-
-/** Counts occurrences of triple-backtick code fences in the message */
-function countCodeBlocks(message: string): number {
-  return (message.match(/```/g) ?? []).length / 2;
-}
-
-// ─── Domain Indicators ───────────────────────────────────────────────────────
-
-const FRONTEND_PATTERNS: RegExp[] = [
-  /\breact\b/i,
-  /\bcss\b/i,
-  /\bhtml\b/i,
-  /\bcomponent\b/i,
-  /\bUI\b/,
-  /\btailwind\b/i,
-  /\bnext\.js\b/i,
-];
-
-const BACKEND_PATTERNS: RegExp[] = [
-  /\bAPI\b/i,
-  /\bserver\b/i,
-  /\bdatabase\b/i,
-  /\bendpoint\b/i,
-  /\bnest(js)?\b/i,
-  /\bexpress\b/i,
-];
-
-const DEVOPS_PATTERNS: RegExp[] = [
-  /\bdocker(file|compose|hub)?\b/i,
-  /\bCI\b/,
-  /\bdeploy\b/i,
-  /\bpipeline\b/i,
-  /\bkubernetes\b/i,
-];
-
-const DOCS_PATTERNS: RegExp[] = [/\bdocumentation\b/i, /\breadme\b/i, /\bguide\b/i];
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-function matchesAny(message: string, patterns: RegExp[]): boolean {
-  return patterns.some((p) => p.test(message));
-}
-
-// ─── Classifier ──────────────────────────────────────────────────────────────
-
-/**
- * Classify a task based on the user's message using deterministic regex/keyword matching.
- * No LLM calls are made — this is a pure, fast, synchronous classification.
- */
-export function classifyTask(message: string): TaskClassification {
-  return {
-    taskType: detectTaskType(message),
-    complexity: estimateComplexity(message),
-    domain: detectDomain(message),
-    requiredCapabilities: [],
-  };
-}
-
-function detectTaskType(message: string): TaskType {
-  if (matchesAny(message, CODING_PATTERNS)) return 'coding';
-  if (matchesAny(message, SUMMARIZATION_PATTERNS)) return 'summarization';
-  if (matchesAny(message, CREATIVE_PATTERNS)) return 'creative';
-  if (matchesAny(message, ANALYSIS_PATTERNS)) return 'analysis';
-  if (matchesAny(message, RESEARCH_PATTERNS)) return 'research';
-  return 'conversation';
-}
-
-function estimateComplexity(message: string): Complexity {
-  const trimmed = message.trim();
-  const codeBlocks = countCodeBlocks(trimmed);
-
-  // Complex: long messages, multiple code blocks, or complexity keywords
-  if (trimmed.length > 500 || codeBlocks > 1 || matchesAny(trimmed, COMPLEX_KEYWORDS)) {
-    return 'complex';
-  }
-
-  // Simple: short messages or a single direct question
-  if (trimmed.length < 100 || SIMPLE_QUESTION_PATTERN.test(trimmed)) {
-    return 'simple';
-  }
-
-  return 'moderate';
-}
-
-function detectDomain(message: string): Domain {
-  if (matchesAny(message, DEVOPS_PATTERNS)) return 'devops';
-  if (matchesAny(message, DOCS_PATTERNS)) return 'docs';
-  if (matchesAny(message, FRONTEND_PATTERNS)) return 'frontend';
-  if (matchesAny(message, BACKEND_PATTERNS)) return 'backend';
-  return 'general';
-}
@@ -1,65 +0,0 @@
-/** Token usage metrics for a session (M5-007). */
-export interface SessionTokenMetrics {
-  input: number;
-  output: number;
-  cacheRead: number;
-  cacheWrite: number;
-  total: number;
-}
-
-/** Per-session metrics tracked throughout the session lifetime (M5-007). */
-export interface SessionMetrics {
-  tokens: SessionTokenMetrics;
-  modelSwitches: number;
-  messageCount: number;
-  lastActivityAt: string;
-}
-
-export interface SessionInfoDto {
-  id: string;
-  provider: string;
-  modelId: string;
-  /** M5-005: human-readable agent name when an agent config is applied. */
-  agentName?: string;
-  createdAt: string;
-  promptCount: number;
-  channels: string[];
-  durationMs: number;
-  /** M5-007: per-session metrics (token usage, model switches, etc.) */
-  metrics: SessionMetrics;
-}
-
-export interface SessionListDto {
-  sessions: SessionInfoDto[];
-  total: number;
-}
-
-/**
- * Options accepted when creating an agent session.
- * All fields are optional; omitting them falls back to env-var or process defaults.
- */
-export interface CreateSessionOptionsDto {
-  /** Provider name (e.g. "anthropic", "openai"). */
-  provider?: string;
-  /** Model ID to use for this session. */
-  modelId?: string;
-  /**
-   * Sandbox working directory for the session.
-   * File, git, and shell tools will be restricted to this directory.
-   * Defaults to AGENT_FILE_SANDBOX_DIR env var or process.cwd().
-   */
-  sandboxDir?: string;
-  /**
-   * Platform-level system prompt for this session.
-   * Merged with skill prompt additions (platform prompt first, then skills).
-   * Falls back to AGENT_SYSTEM_PROMPT env var when omitted.
-   */
-  systemPrompt?: string;
-  /**
-   * Explicit allowlist of tool names available in this session.
-   * When provided, only listed tools are registered with the agent.
-   * Admins receive all tools; regular users fall back to AGENT_USER_TOOLS
-   * env var (comma-separated) when this field is not supplied.
-   */
-  allowedTools?: string[];
-}
@@ -1,40 +0,0 @@
-import {
-  Controller,
-  Delete,
-  Get,
-  HttpCode,
-  HttpStatus,
-  Inject,
-  NotFoundException,
-  Param,
-  UseGuards,
-} from '@nestjs/common';
-import { AuthGuard } from '../auth/auth.guard.js';
-import { AgentService } from './agent.service.js';
-
-@Controller('api/sessions')
-@UseGuards(AuthGuard)
-export class SessionsController {
-  constructor(@Inject(AgentService) private readonly agentService: AgentService) {}
-
-  @Get()
-  list() {
-    const sessions = this.agentService.listSessions();
-    return { sessions, total: sessions.length };
-  }
-
-  @Get(':id')
-  findOne(@Param('id') id: string) {
-    const info = this.agentService.getSessionInfo(id);
-    if (!info) throw new NotFoundException('Session not found');
-    return info;
-  }
-
-  @Delete(':id')
-  @HttpCode(HttpStatus.NO_CONTENT)
-  async destroy(@Param('id') id: string) {
-    const info = this.agentService.getSessionInfo(id);
-    if (!info) throw new NotFoundException('Session not found');
-    await this.agentService.destroySession(id);
-  }
-}
@@ -1,59 +0,0 @@
-import { Inject, Injectable, Logger } from '@nestjs/common';
-import type { ToolDefinition } from '@mariozechner/pi-coding-agent';
-import { SkillsService } from '../skills/skills.service.js';
-import { createSkillTools } from './tools/skill-tools.js';
-
-export interface LoadedSkills {
-  /** Meta-tools: skill_list + skill_invoke */
-  metaTools: ToolDefinition[];
-  /**
-   * System prompt additions from enabled prompt-type skills.
-   * Callers may prepend these to the session system prompt.
-   */
-  promptAdditions: string[];
-}
-
-/**
- * SkillLoaderService is responsible for:
- * 1. Providing the skill meta-tools (skill_list, skill_invoke) to agent sessions.
- * 2. Collecting system-prompt additions from enabled prompt-type skills.
- */
-@Injectable()
-export class SkillLoaderService {
-  private readonly logger = new Logger(SkillLoaderService.name);
-
-  constructor(@Inject(SkillsService) private readonly skillsService: SkillsService) {}
-
-  /**
-   * Load enabled skills and return tools + prompt additions for a new session.
-   */
-  async loadForSession(): Promise<LoadedSkills> {
-    const metaTools = createSkillTools(this.skillsService);
-
-    let promptAdditions: string[] = [];
-    try {
-      const enabledSkills = await this.skillsService.findEnabled();
-      promptAdditions = enabledSkills.flatMap((skill) => {
-        const config = (skill.config ?? {}) as Record<string, unknown>;
-        const skillType = (config['type'] as string | undefined) ?? 'prompt';
-        if (skillType === 'prompt') {
-          const addition = (config['prompt'] as string | undefined) ?? skill.description;
-          return addition ? [addition] : [];
-        }
-        return [];
-      });
-
-      this.logger.log(
-        `Loaded ${enabledSkills.length} enabled skill(s), ` +
-          `${promptAdditions.length} prompt addition(s)`,
-      );
-    } catch (err) {
-      // Non-fatal: log and continue without prompt additions
-      this.logger.warn(
-        `Failed to load skill prompt additions: ${err instanceof Error ? err.message : String(err)}`,
-      );
-    }
-
-    return { metaTools, promptAdditions };
-  }
-}
@@ -1,184 +0,0 @@
-import { Type } from '@sinclair/typebox';
-import type { ToolDefinition } from '@mariozechner/pi-coding-agent';
-import type { Brain } from '@mosaicstack/brain';
-
-export function createBrainTools(brain: Brain): ToolDefinition[] {
-  const listProjects: ToolDefinition = {
-    name: 'brain_list_projects',
-    label: 'List Projects',
-    description: 'List all projects in the brain.',
-    parameters: Type.Object({}),
-    async execute() {
-      const projects = await brain.projects.findAll();
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(projects, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  const getProject: ToolDefinition = {
-    name: 'brain_get_project',
-    label: 'Get Project',
-    description: 'Get a project by ID.',
-    parameters: Type.Object({
-      id: Type.String({ description: 'Project ID (UUID)' }),
-    }),
-    async execute(_toolCallId, params) {
-      const { id } = params as { id: string };
-      const project = await brain.projects.findById(id);
-      return {
-        content: [
-          {
-            type: 'text' as const,
-            text: project ? JSON.stringify(project, null, 2) : `Project not found: ${id}`,
-          },
-        ],
-        details: undefined,
-      };
-    },
-  };
-
-  const listTasks: ToolDefinition = {
-    name: 'brain_list_tasks',
-    label: 'List Tasks',
-    description: 'List tasks, optionally filtered by project, mission, or status.',
-    parameters: Type.Object({
-      projectId: Type.Optional(Type.String({ description: 'Filter by project ID' })),
-      missionId: Type.Optional(Type.String({ description: 'Filter by mission ID' })),
-      status: Type.Optional(Type.String({ description: 'Filter by status' })),
-    }),
-    async execute(_toolCallId, params) {
-      const p = params as { projectId?: string; missionId?: string; status?: string };
-      type TaskStatus = 'not-started' | 'in-progress' | 'blocked' | 'done' | 'cancelled';
-      let tasks;
-      if (p.projectId) tasks = await brain.tasks.findByProject(p.projectId);
-      else if (p.missionId) tasks = await brain.tasks.findByMission(p.missionId);
-      else if (p.status) tasks = await brain.tasks.findByStatus(p.status as TaskStatus);
-      else tasks = await brain.tasks.findAll();
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(tasks, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  const createTask: ToolDefinition = {
-    name: 'brain_create_task',
-    label: 'Create Task',
-    description: 'Create a new task in the brain.',
-    parameters: Type.Object({
-      title: Type.String({ description: 'Task title' }),
-      description: Type.Optional(Type.String({ description: 'Task description' })),
-      projectId: Type.Optional(Type.String({ description: 'Project ID' })),
-      missionId: Type.Optional(Type.String({ description: 'Mission ID' })),
-      priority: Type.Optional(
-        Type.String({ description: 'Priority: low, medium, high, critical' }),
-      ),
-    }),
-    async execute(_toolCallId, params) {
-      const p = params as {
-        title: string;
-        description?: string;
-        projectId?: string;
-        missionId?: string;
-        priority?: string;
-      };
-      type Priority = 'low' | 'medium' | 'high' | 'critical';
-      const task = await brain.tasks.create({
-        ...p,
-        priority: p.priority as Priority | undefined,
-      });
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(task, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  const updateTask: ToolDefinition = {
-    name: 'brain_update_task',
-    label: 'Update Task',
-    description: 'Update an existing task.',
-    parameters: Type.Object({
-      id: Type.String({ description: 'Task ID' }),
-      title: Type.Optional(Type.String()),
-      description: Type.Optional(Type.String()),
-      status: Type.Optional(
-        Type.String({ description: 'not-started, in-progress, blocked, done, cancelled' }),
-      ),
-      priority: Type.Optional(Type.String()),
-    }),
-    async execute(_toolCallId, params) {
-      const { id, ...updates } = params as {
-        id: string;
-        title?: string;
-        description?: string;
-        status?: string;
-        priority?: string;
-      };
-      type TaskStatus = 'not-started' | 'in-progress' | 'blocked' | 'done' | 'cancelled';
-      type Priority = 'low' | 'medium' | 'high' | 'critical';
-      const task = await brain.tasks.update(id, {
-        ...updates,
-        status: updates.status as TaskStatus | undefined,
-        priority: updates.priority as Priority | undefined,
-      });
-      return {
-        content: [
-          {
-            type: 'text' as const,
-            text: task ? JSON.stringify(task, null, 2) : `Task not found: ${id}`,
-          },
-        ],
-        details: undefined,
-      };
-    },
-  };
-
-  const listMissions: ToolDefinition = {
-    name: 'brain_list_missions',
-    label: 'List Missions',
-    description: 'List all missions, optionally filtered by project.',
-    parameters: Type.Object({
-      projectId: Type.Optional(Type.String({ description: 'Filter by project ID' })),
-    }),
-    async execute(_toolCallId, params) {
-      const p = params as { projectId?: string };
-      const missions = p.projectId
-        ? await brain.missions.findByProject(p.projectId)
-        : await brain.missions.findAll();
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(missions, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  const listConversations: ToolDefinition = {
-    name: 'brain_list_conversations',
-    label: 'List Conversations',
-    description: 'List conversations for a user.',
-    parameters: Type.Object({
-      userId: Type.String({ description: 'User ID' }),
-    }),
-    async execute(_toolCallId, params) {
-      const { userId } = params as { userId: string };
-      const conversations = await brain.conversations.findAll(userId);
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(conversations, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  return [
-    listProjects,
-    getProject,
-    listTasks,
-    createTask,
-    updateTask,
-    listMissions,
-    listConversations,
-  ];
-}
@@ -1,81 +0,0 @@
-import { Type } from '@sinclair/typebox';
-import type { ToolDefinition } from '@mariozechner/pi-coding-agent';
-import type { CoordService } from '../../coord/coord.service.js';
-
-export function createCoordTools(coordService: CoordService): ToolDefinition[] {
-  const getMissionStatus: ToolDefinition = {
-    name: 'coord_mission_status',
-    label: 'Mission Status',
-    description:
-      'Get the current orchestration mission status including milestones, tasks, and active session.',
-    parameters: Type.Object({
-      projectPath: Type.Optional(
-        Type.String({ description: 'Project path. Defaults to gateway working directory.' }),
-      ),
-    }),
-    async execute(_toolCallId, params) {
-      const { projectPath } = params as { projectPath?: string };
-      const resolvedPath = projectPath ?? process.cwd();
-      const status = await coordService.getMissionStatus(resolvedPath);
-      return {
-        content: [
-          {
-            type: 'text' as const,
-            text: status ? JSON.stringify(status, null, 2) : 'No active coord mission found.',
-          },
-        ],
-        details: undefined,
-      };
-    },
-  };
-
-  const listCoordTasks: ToolDefinition = {
-    name: 'coord_list_tasks',
-    label: 'List Coord Tasks',
-    description: 'List all tasks from the orchestration TASKS.md file.',
-    parameters: Type.Object({
-      projectPath: Type.Optional(
-        Type.String({ description: 'Project path. Defaults to gateway working directory.' }),
-      ),
-    }),
-    async execute(_toolCallId, params) {
-      const { projectPath } = params as { projectPath?: string };
-      const resolvedPath = projectPath ?? process.cwd();
-      const tasks = await coordService.listTasks(resolvedPath);
-      return {
-        content: [{ type: 'text' as const, text: JSON.stringify(tasks, null, 2) }],
-        details: undefined,
-      };
-    },
-  };
-
-  const getCoordTaskDetail: ToolDefinition = {
-    name: 'coord_task_detail',
-    label: 'Coord Task Detail',
-    description: 'Get detailed status for a specific orchestration task.',
-    parameters: Type.Object({
-      taskId: Type.String({ description: 'Task ID (e.g. P2-005)' }),
-      projectPath: Type.Optional(
-        Type.String({ description: 'Project path. Defaults to gateway working directory.' }),
-      ),
-    }),
-    async execute(_toolCallId, params) {
-      const { taskId, projectPath } = params as { taskId: string; projectPath?: string };
-      const resolvedPath = projectPath ?? process.cwd();
-      const detail = await coordService.getTaskStatus(resolvedPath, taskId);
-      return {
-        content: [
-          {
-            type: 'text' as const,
-            text: detail
-              ? JSON.stringify(detail, null, 2)
-              : `Task ${taskId} not found in coord mission.`,
-          },
-        ],
-        details: undefined,
-      };
-    },
-  };
-
-  return [getMissionStatus, listCoordTasks, getCoordTaskDetail];
-}
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				`pnpm typecheck && pnpm lint && pnpm format:check`