ADR-008 — Framework TUI air-tui avec trois backends de transport

Statut : Accepté — document fondateur. Édition directe autorisée en phase de design pré-ouverture publique ; immuable après ouverture publique (toute évolution via RFC, ADR-015). Catégorie : Architecture (couche 4 — framework TUI).

Contexte

Une application TUI peut s’exécuter sur un TTY réel, dans un terminal Air, ou dans un terminal tiers atteint par SSH. Les capacités de ces trois contextes sont très inégales.

Sans abstraction, l’auteur d’application écrit trois fois son code, ou vise le plus petit dénominateur commun et perd ce que les contextes riches permettent.

Décision

Le framework TUI d’Air abstrait trois modes d’exécution : (1) TTY réel avec air-console (mode plein bypass) ; (2) terminal Air avec protocole privé AirCom (équivalent plein bypass) ; (3) terminal tiers ou SSH avec fallback Kitty keyboard protocol ou ANSI standard (mode dégradé).

Conséquences

API Capabilities pour que l’app interroge ce qui est disponible et dégrade ses fonctionnalités sans crash. Le développeur d’app écrit son code une fois ; les capacités dégradent silencieusement selon le contexte.

Alternatives rejetées

Aucune alternative n’a été consignée lors de l’instruction.

Licence du document : MPL 2.0