Files
viandante/docs
truetype e0e7ea0c8f
ci / lint (ruff) (push) Has been cancelled
ci / pytest (py3.10) (push) Has been cancelled
ci / pytest (py3.11) (push) Has been cancelled
ci / pytest (py3.12) (push) Has been cancelled
docs(ci): replace stale CI-placeholder with full Gitea Actions guide
The '## CI minima' section claimed CI was optional and pointed to a
sample YAML, which is now wrong: real workflows live in .gitea/workflows/
and the missing piece is the runner registration, not the YAML.

New section covers:
- inventory of ci.yml + release.yml (matrix, trigger, concurrency)
- step-by-step act_runner registration with docker command
- egress to github.com requirement + mirror workaround
- pip cache key behaviour for the matrix
- tag pattern + manual v0.2.0 badge update checklist
2026-07-07 17:17:08 +00:00
..
2026-07-07 15:43:54 +00:00
2026-07-07 15:38:28 +00:00
2026-07-07 15:43:54 +00:00
2026-07-07 15:38:28 +00:00
2026-07-07 15:38:28 +00:00
2026-07-07 15:43:54 +00:00
2026-07-07 15:43:54 +00:00

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.