IdeA/.ideai/tickets/125/carnet.md

issueRef, version, updatedBy, updatedAt

issueRef	version	updatedBy	updatedAt
#125	4	kind agent_id agent a6ced819-b893-4213-b003-9e9dc79b9641	1785667057177

Problème

Le SDK public permet seulement :

• d’observer/contrôler des background tasks existantes
• d’ouvrir un PTY interactif

Il manque une API publique pour démarrer une commande/outillage externe de façon intégrée à IdeA.

Pourquoi c’est global

Le besoin est transversal à tous les plugins de développement : build, test, lint, génération, outils CLI, pipelines locaux, simulateurs, wrappers maison.

Ce que ce ticket doit produire

Une API publique de lancement de commandes/tâches permettant au minimum :

• exécuter une commande avec cwd, args, env
• choisir un mode tracked/background task plutôt qu’un PTY brut
• suivre statut, exit code, stdout/stderr
• annuler / éventuellement relancer
• corréler le run avec le modèle Work d’IdeA

Contraintes d’architecture

• Ne pas confondre terminal interactif et task runner.
• Contrat stable sur environnement, cwd, timeouts éventuels, sortie et erreurs.
• Le plugin ne doit pas avoir à bricoler une session PTY pour lancer un build.

Non-objectifs

• Pas de sémantique Android/Gradle/adb.
• Pas d’orchestration multi-étapes spécifique à une stack.

Dépendances

• Bloque #126.

Critères d’acceptation

• Un plugin peut lancer une commande externe sans passer par un cast interne ni un PTY interactif.
• L’exécution remonte un état observable et un résultat terminal clair.
• Le contrat est documenté côté SDK avec exemple de commande simple.