Fichiers
lmwork/doc/adr/0003-systematic-pty-portable-pty.md
2026-10-11 01:56:28 +02:00

ADR 0003 : Utilisation systématique d'un vrai PTY (portable-pty)

Statut

Accepté

Contexte

L'exécution de commandes dans les environnements de développement ou assistants IA souffre historiquement d'une faiblesse majeure : l'utilisation de tubes standards (pipes stdin/stdout/stderr via std::process::Stdio::piped()).

Cette approche classique échoue systématiquement sur :

  1. sudo qui refuse de lire le mot de passe depuis un pipe (exige un vrai tty).
  2. Les outils interactifs tels que git rebase -i, git commit, nano, vim, ou les prompts SSH.
  3. Tout binaire vérifiant isatty(STDIN_FILENO) ou _isatty().
  4. La mise en mémoire tampon automatique de la libc (setvbuf), qui retarde la sortie textuelle par bloc de 4 Ko au lieu de l'émettre au fil de l'eau.

Décision

  1. Passage systématique par un PTY natif : Toute commande est exécutée au travers de la bibliothèque portable-pty (s'appuyant sur ConPTY sous Windows et les pseudo-terminaux /dev/pts POSIX sous Linux).
  2. Pas d'interprétation ANSI côté moteur d'exécution : Le moteur lit les octets bruts du descripteur maître et les remonte tels quels sous forme d'événements ExecEvent::Stdout(Vec<u8>). Le traitement et le rendu des séquences ANSI (couleurs, positions de curseur, clear screen) relèvent de la responsabilité de l'interface utilisateur frontend (xterm.js ou terminal Tauri dans une passe ultérieure).
  3. Contrôle dynamique du terminal : L'API expose :
    • write_input(&[u8]) pour injecter des frappes clavier au processus interactif.
    • resize(cols, rows) pour notifier le terminal virtuel d'un changement de taille de fenêtre.
  4. Gestion de la négociation initiale ConPTY sous Windows : ConPTY émet par conception une séquence ANSI DSR (\x1b[6n) à l'initialisation pour interroger la position du curseur. Sans émulateur de terminal physique pour y répondre, cmd.exe peut bloquer. Notre couche PTY répond immédiatement par \x1b[1;1R dès l'ouverture du terminal sous Windows, éliminant tout blocage.

Conséquences

  • Avantages : Compatibilité totale avec les programmes interactifs, transmission immédiate et non bufférisée des caractères, comportement identique à une session terminal utilisateur.
  • Particularité : Dans un PTY, stdout et stderr sont fusionnés par le système d'exploitation au niveau du terminal esclave. Le flux est donc unifié en ExecEvent::Stdout.