Files
viandante/docs
truetype 388b0a87c3
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
ci / pytest (py3.13) (push) Has been cancelled
fix(ci): switch runner label to self-hosted, extend matrix to 3.13
The build steps now declare 'runs-on: self-hosted' (default label
advertised by an act_runner registered with Docker mode). Previously
they used 'ubuntu-22.04' which would not match any default runner and
would leave every job in 'no runner available'.

ci.yml matrix extended to ['3.10','3.11','3.12','3.13'] for forward
coverage on Python 3.13 (current stable as of 2026).

docs/development.md 'CI/CD - Gitea Actions' section also corrected:
- the egress workaround now uses the actual Gitea 1.26 key
  [actions].DEFAULT_ACTIONS_URL (not ENABLE_GITHUB_ACTIONS_MIRROR)
- the act_runner docker command uses --rm -it for the first run to
  surface registration errors in the terminal before daemonization
- runner-scoping note clarifies global vs repo-scoped token URLs

Verified by ruff_exit=0 and pytest 66/66 still green locally.
2026-07-07 17:19:32 +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.