goOn - OUI

Orchestration Moteur local

goOn est le moteur d’orchestration local : il exécute les tâches, les projets, les agents et les productions sur votre machine, et expose une API REST utilisée par Yapuka Code et Yapuka Studio.

Présentation

goOn est un service écrit en Go qui tourne en tâche de fond sur chaque machine. C’est le seul backend de l’écosystème Yapuka : les applications de bureau ne font que lui parler. Il garde ses données en local, dans ~/.config/goon/ (base SQLite, configuration, cache des marques).

Tâches : déclenchées à la main, par planification (cron), par un fichier modifié ou par un webhook.
Projets et missions : un projet regroupe des missions découpées en sous-tâches, chacune avec un rôle (architecte, relecteur…) et une estimation.
Agents : les sous-tâches sont confiées à des agents IA (par exemple Claude Code) qui travaillent dans les dossiers et dépôts Git du projet, sur des branches dédiées.
Productions : les livrables créatifs pilotés depuis Yapuka Studio.

Comment fonctionne une exécution

Chaque exécution suit le même pipeline :

un déclencheur lance la tâche ;
les hooks préalables s’exécutent et peuvent annuler ou ignorer l’exécution ;
l’exécuteur réalise le travail (commande shell, appel HTTP, chaîne de tâches, agent IA) ;
les hooks finaux s’exécutent toujours, même après un échec ;
le résultat et les journaux sont enregistrés dans la base locale.

Les exécuteurs, déclencheurs et hooks sont des plugins : on étend goOn sans toucher à son cœur.

Installation et service

goOn est livré avec Yapuka Code, qui le démarre automatiquement. Pour l’utiliser seul, installez-le comme service système :

goon daemon install    # installe et démarre le service
goon daemon status     # vérifie qu’il tourne
goon daemon restart    # redémarre après un changement de configuration

La configuration se trouve dans ~/.config/goon/config.yaml et les définitions de tâches dans ~/.config/goon/tasks.yaml.

Ligne de commande

Commande	Rôle
`goon serve`	Lance le serveur au premier plan
`goon list`	Liste les tâches déclarées
`goon run <tâche>`	Exécute une tâche immédiatement
`goon logs <exécution>`	Affiche les journaux d’une exécution
`goon plugins`	Liste les plugins chargés
`goon brands import <dossier>`	Importe un paquet de marque dans le cache local

API REST

L’API écoute sur http://localhost:18080, en JSON. Chaque requête doit porter la clé locale, lue dans ~/.config/goon/api_key, dans l’en-tête X-API-Key.

Méthode	Chemin	Rôle
GET	`/health`	État du service
GET	`/api/v1/tasks`	Liste des tâches
POST	`/api/v1/tasks/{id}/run`	Lance une tâche
GET	`/api/v1/runs`	Historique des exécutions (paginé)
GET	`/api/v1/runs/{id}/logs`	Journaux en direct (SSE)
GET	`/api/v1/projects`	Projets, missions et sous-tâches
GET	`/api/v1/plugins`	Plugins disponibles

curl -H "X-API-Key: $(cat ~/.config/goon/api_key)" \
  http://localhost:18080/api/v1/tasks

Ne versionnez jamais la clé et n’exposez pas le port 18080 sur le réseau : l’API est prévue pour la machine locale.

Pour aller plus loin

goOn fonctionne seul, mais il peut aussi rejoindre Maestro pour partager le travail entre plusieurs machines. Pour le piloter avec une interface, utilisez Yapuka Code (développement) ou Yapuka Studio (production créative).