Cockpit et guide interactif Arclith CLI

Le cockpit plein écran transforme la CLI en espace de travail persistant : vous choisissez le résultat attendu, Arclith construit un plan complet, affiche les commandes équivalentes, génère le projet, puis permet de l'inspecter et de lancer ses transports sans quitter l'interface.

arclith-cli

Dans un vrai terminal, cette commande ouvre la TUI plein écran. Dans un pipe, un script, une CI ou un terminal déclaré TERM=dumb, elle conserve le comportement non-interactif historique et affiche l'aide avec un code de sortie 0. Pour ouvrir explicitement le cockpit :

arclith-cli tui

Le guide Questionary historique reste disponible comme interface de repli et pour le catalogue avancé complet :

arclith-cli guide

Interface plein écran

La TUI repose sur des écrans distincts et conserve le moteur de planification indépendant de l'interface :

• un accueil pour créer ou ouvrir un projet ;
• un assistant adaptatif couvrant les six intentions Arclith, avec une page par étape et des actions Précédent/Continuer toujours visibles ;
• un aperçu permanent du plan et des commandes directes ;
• une progression visible pendant la génération atomique ;
• un tableau de bord fondé sur l'état réel du disque ;
• un sélecteur de dossiers qui valide et ouvre un projet existant ;
• un catalogue natif pour ajouter et paramétrer de nouveaux adapters ;
• un cockpit runtime avec sélection du transport, logs, démarrage, arrêt et redémarrage ;
• une disposition réduite automatiquement dans les terminaux étroits ;
• navigation clavier, footer de raccourcis et palette de commandes Textual.

Dans les listes déroulantes, Entrée ou Espace ouvre les options, les flèches haut/bas déplacent la sélection et Entrée la valide. La valeur courante et la flèche restent visibles quand la liste est fermée. À la souris, un clic ouvre la liste puis un clic sur l'option la sélectionne.

Les raccourcis principaux du tableau de bord sont a pour ajouter un adapter, o pour ouvrir un autre projet, s pour démarrer, x pour arrêter, r pour actualiser, n pour un nouveau projet, g pour le guide avancé et q pour quitter. Un runtime actif est arrêté avant la fermeture de l'application afin de ne pas laisser de processus orphelin. Le changement ou la modification du projet est refusé tant que son runtime est actif.

Créer par intention

L'écran de création ne demande pas de connaître les commandes Arclith. Il propose six résultats :

Intention	Cœur généré	Décisions techniques explicites	Exposition
Socle minimal	projet vide, entité optionnelle	aucune	aucune
API REST CRUD	entité et cinq cas d'usage CRUD	repository + FastAPI	cinq routes REST
API REST sur mesure	entité et un cas d'usage	repository + FastAPI	une route typée
Serveur MCP	entité et un cas d'usage	repository + FastMCP	un outil MCP
Agent LangGraph	entité et un cas d'usage	repository + LangGraph	un nœud de graphe
Worker RabbitMQ	entité et un cas d'usage	repository + RabbitMQ	une commande versionnée

Le repository n'est jamais déduit du transport. Pour chaque parcours complet, vous choisissez explicitement memory, mongodb ou postgresql. De même, un profil CRUD décrit le comportement applicatif ; il n'installe pas FastAPI tout seul.

Avant génération, le récapitulatif présente chaque décision et sa commande directe équivalente. Exemple :

1  Initialiser catalog-service       arclith-cli init catalog-service
2  Ajouter l'entité Product (crud)   arclith-cli add-entity Product --profile crud
3  Ajouter repository/memory         arclith-cli add-adapter ...
4  Ajouter api/fastapi               arclith-cli add-adapter ...
5  Exposer la feature product        arclith-cli expose-feature ...

Ces commandes restent utilisables indépendamment dans un script. Les paramètres secrets éventuellement saisis dans le parcours avancé sont masqués dans le plan et dans arclith.recipe.yaml.

Continuer dans le tableau de bord

Après la création, le cockpit reste ouvert sur le nouveau projet. Lancé depuis n'importe quel sous-répertoire d'un projet Arclith, il retrouve automatiquement la racine et affiche :

• les entités détectées dans le domaine ;
• les ports inbound existants ;
• les features applicatives déclarées ;
• les adapters réellement installés ;
• les anomalies de manifeste ou de recette.

L'action « Ajouter un adapter » ouvre le catalogue complet sans quitter la TUI. Elle masque les adapters déjà présents, adapte les champs aux paramètres et aux profils déclarés par le catalogue, et affiche la commande directe équivalente. Les valeurs secrètes sont saisies dans un champ masqué et remplacées par <redacted> dans cet aperçu comme dans la recette.

Lorsqu'une capability possède déjà un adapter actif, par exemple repository/memory, le nouvel adapter est installé sans remplacer cette sélection par défaut. Vous pouvez activer explicitement le nouveau provider dans le formulaire. Les providers d'observabilité restent cumulables. Les capabilities sans clé d'activation ajoutent uniquement leur configuration et leur code. Si deux providers partagent un fichier de configuration exclusif, le formulaire indique clairement lequel sera remplacé avant l'installation. Une erreur de paramètre ou de prérequis reste affichée dans l'écran, sans fermer le cockpit.

Le guide avancé permet toujours d'ajouter une entité ou un cas d'usage, puis d'exposer un cas d'usage via FastAPI, FastMCP, LangGraph ou RabbitMQ. Une action impossible reste désactivée tant que ses prérequis ne sont pas présents.

L'action « Ouvrir un projet » est disponible depuis l'accueil et depuis le tableau de bord. Le navigateur n'affiche que les dossiers utiles, accepte aussi un chemin saisi au clavier et vérifie la structure Arclith avant d'ouvrir le projet. Un sous-dossier du projet peut être sélectionné : sa racine est retrouvée automatiquement.

La CLI ne peut pas changer le répertoire courant du shell parent. À la fin d'une création, elle affiche donc la commande cd <projet> à copier ; sa propre session utilise immédiatement le nouveau projet sans demander de relancer la CLI.

Écritures sûres et recette

Le plan d'un nouveau projet est exécuté dans un répertoire temporaire situé sur le même système de fichiers. La cible finale n'apparaît qu'après la réussite de toutes les étapes. Une erreur ou une interruption nettoie le staging et ne laisse pas de projet partiel. Une cible existante n'est jamais remplacée.

Chaque étape réussie alimente arclith.recipe.yaml avec les mêmes informations que sa commande directe : paramètres résolus, version et empreinte des blueprints, fichiers créés ou modifiés, et références de secrets sans leur valeur. Le menu « Rejouer une recette » reconstruit lui aussi une nouvelle cible par staging atomique et utilise le mode de compatibilité strict.

Inspection et automatisation

Le tableau de bord est également disponible hors du guide :

arclith-cli status
arclith-cli status --json
arclith-cli doctor

status lit l'état courant du disque ; il ne suppose pas que la recette reflète encore exactement le projet. La sortie JSON est adaptée aux scripts. doctor retourne un code non nul si le projet est introuvable ou si un manifeste ou la recette est absent ou illisible.

Lancer le projet

Le tableau de bord sélectionne les transports réellement installés et permet de les démarrer, arrêter ou redémarrer tout en conservant leurs logs dans un panneau dédié. La même opération reste disponible hors TUI, en avant-plan :

arclith-cli run api

La commande retrouve la racine depuis n'importe quel sous-répertoire, vérifie que l'adapter correspondant est réellement installé, puis exécute le point d'entrée généré avec uv. Le host, le port et le reload restent définis dans config/adapters/inbound/fastapi.yaml; run n'introduit pas de seconde configuration. L'URL locale est affichée avant le démarrage et Ctrl+C arrête le processus.

Les autres modes du point d'entrée généré sont également disponibles lorsqu'ils ont leurs adapters :

arclith-cli run mcp_http
arclith-cli run mcp_sse
arclith-cli run bus
arclith-cli run all

Le processus reste volontairement attaché au terminal : la CLI ne crée ni daemon caché, ni fichier PID global, ni runtime concurrent. Cette propriété garantit une propagation normale des logs, du code de sortie et des signaux.

Pour retrouver toutes les options spécialisées, utilisez toujours :

arclith-cli --help
arclith-cli <commande> --help