# Upgrade Report v21 — Standalone Swarm Chat Merge

## Summary

v21 merges the uploaded `quantum-field-swarm-chat` package into the v20 ultimate treasury/voting/rooms/agent suite as a first-class surface.

## Why this matters

v20 added a strong structured Agent Rooms module. The newly merged Swarm Chat surface adds a faster chat-native interface for:

- human peer-to-peer rooms,
- human group rooms,
- human ↔ single-agent sessions,
- human + multi-agent swarms,
- runtime BYOK provider keys,
- explicit turn policy, and
- budget-guarded orchestration.

## New paths

```txt
swarm-chat/index.html
swarm-chat/js/chat-core.js
swarm-chat/js/transport-local.js
swarm-chat/js/providers.js
swarm-chat/js/orchestrator.js
swarm-chat/js/chat-app.js
swarm-chat/js/bootstrap.js
swarm-chat/test/orchestrator.test.mjs
integrations/quantum-field-swarm-chat/
tests/swarm-chat-orchestrator.test.mjs
docs/SWARM_CHAT_V21.md
docs/UPGRADE_REPORT_V21.md
docs/V21_RELEASE_NOTES.md
RELEASE_MANIFEST_V21.md
```

## Integration choices

- v20 `/agent-rooms/` remains the canonical structured agent-room module.
- v21 `/swarm-chat/` is added as a live chat surface, not a replacement.
- The source upload is preserved under `integrations/` for provenance and reuse.
- Service-worker precache, surface registry, root landing page, and ultimate shell now include `/swarm-chat/`.
- Release validation now checks the v21 surface and version gates.

## Validation

Run:

```bash
npm run check
npm run check:ultimate
npm run test:offline
npm run test:wiring
npm run check:release
```