Comprehensive README: full protocol spec, API reference, architecture, security model

Expanded from ~700 lines to ~2200 lines covering:
- Complete protocol specification (every command, field, behavior)
- Full API reference with request/response examples for all endpoints
- Architecture deep-dive (session model, queue system, broker, message flow)
- Sequence diagrams for channel messages, DMs, and JOIN flows
- All design decisions with rationale (no accounts, JSON, opaque tokens, etc.)
- Canonicalization and signing spec (JCS, Ed25519, TOFU)
- Security model (threat model, authentication, key management)
- Federation design (link establishment, relay, state sync, S2S commands)
- Storage schema with all tables and columns documented
- Configuration reference with all environment variables
- Deployment guide (Docker, binary, reverse proxy, SQLite considerations)
- Client development guide with curl examples and Python/JS code
- Hashcash proof-of-work spec (challenge/response flow, adaptive difficulty)
- Detailed roadmap (MVP, post-MVP, future)
- Project structure with every directory explained

Цей коміт міститься в:

clawbot

2026-02-26 20:16:43 -08:00

зафіксовано

user

джерело 6c1d652308

коміт 84162e82f1

1 змінених файлів з 1916 додано та 416 видалено

README.md

+1916 -416

Переглянути файл

Різницю між файлами не показано, бо вона завелика Завантажити різницю