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.