2.4 KiB
2.4 KiB
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 :
sudoqui refuse de lire le mot de passe depuis un pipe (exige un vrai tty).- Les outils interactifs tels que
git rebase -i,git commit,nano,vim, ou les prompts SSH. - Tout binaire vérifiant
isatty(STDIN_FILENO)ou_isatty(). - 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
- 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/ptsPOSIX sous Linux). - 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). - 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.
- 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.exepeut bloquer. Notre couche PTY répond immédiatement par\x1b[1;1Rdè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,
stdoutetstderrsont fusionnés par le système d'exploitation au niveau du terminal esclave. Le flux est donc unifié enExecEvent::Stdout.