viandante/docs/README.md

docs/ — indice della documentazione di viandante

Documentazione completa del client MUD CLI. La lingua è l'italiano per coerenza con il README.md principale. I blocchi di codice e i nomi di simboli rimangono in inglese.

Sezione	Cosa trovi
architecture.md	Analisi architetturale: dipendenze tra moduli, data flow, boundary, accoppiamenti noti. Leggi prima questo.
modules.md	Descrizione modulo‑per‑modulo: scopo, API pubblica, dipendenze interne, slot/responsabilità.
protocol.md	Telnet (IAC state machine), GMCP wire format, euristiche Dead Souls, ANSI handling.
usage.md	Tutti i flag della CLI + esempi + flusso di auto‑login + comandi locali /....
events.md	Schema completo degli eventi emessi dal EventLogger (JSONL + Markdown).
development.md	Setup dev, pytest, ruff, come aggiungere un modulo, debugging.
gitea.md	Flusso di pubblicazione sul server Gitea 192.168.0.183:8085 (utente truetype) + regole di sicurezza del token.

Biglietto da visita

        ┌──────────────┐
        │   cli.py     │   ← orchestratore async (prompt / dispatcher)
        └──────┬───────┘
               │
   ┌───────────┼─────────────┐
   │           │             │
┌─▼────┐  ┌────▼─────┐  ┌─────▼──────┐
│logger│  │  telnet  │  │   mapper   │
└──────┘  └─────┬────┘  └─────┬──────┘
                 │             │
                 │ GMCP        ▲ via deadsouls (testo)
        ┌────────▼────────┐    │
        │     gmcp        │    │
        └─────────────────┘    │
                               │
                       ┌───────▼────────┐
                       │   deadsouls    │
                       └────────────────┘
                       + ansi (foglia pura)

Per la versione completa e discorsa vedi architecture.md.