Susan

Outils

Toutes les commandes sont écrites en Go et rangées dans cmd/ du dépôt. make install à la racine compile, teste et installe nexusctl, nexusadm, nexushelm et harnessctl, avec leurs hooks pour Claude Code ; proxyctl s’installe à part avec make -C cmd/proxyctl install.

Commandes

CommandeConfigurationRôle
flowctlToutesClient de l’opérateur : submit demande un run (une exécution d’un workflow ; voir le glossaire), list, get, watch le suit jusqu’à sa fin, cancel, et usage totalise les jetons par modèle. --output json produit une sortie lisible par un programme ; les codes de sortie sont stables.
proxyctlPoste uniqueReverse proxy Traefik local en HTTPS sur *.localhost pour tous les projets de l’ordinateur, avec des certificats mkcert : up, routes add, domains add, domains check.
nexusadmHomelabAdministration du cluster : node add et node remove, grant pour les accès à durée limitée, secret pour le trousseau, audit du serveur d’API, doctor pour contrôler les nœuds, log des actions faites.
nexusctlHomelabkubectl avec un accès désigné, chaque appel journalisé.
nexushelmHomelabhelm avec un accès désigné, chaque appel journalisé, releases Helm rangées dans des Secrets.
harnessctlToutesGarde de Claude Code sur votre poste : modifications des règles de l’agent après confirmation, et dossiers hors projet ouverts à un agent pour 30 jours au plus.

Les actions qui demandent les droits d’administration du cluster ouvrent une fenêtre de confirmation sur votre session graphique.

Composants de la suite

ComposantTourne dansRôle
nexus-dashboardUn serviceSuit les items (unités de travail, comme une demande), affiche dans la vue « À traiter par vous » les questions que posent les runs, relance un run quand vous répondez, lit les pull requests sur Forgejo et pilote l’opérateur par son API HTTP.
nexus-operatorUn serviceTransforme les ressources WorkflowRun en Jobs Kubernetes, ou en conteneurs Docker avec son moteur docker, et suit chaque run jusqu’à sa fin. nexus-operator provision <projet> prépare les namespaces d’un projet.
nexus-agentLe pod de chaque runConteneur principal : lance AWF et remet ce qu’il en tire au collecteur, ou directement à l’opérateur sur un poste. Son code de sortie est celui d’AWF.
nexus-collectorLe pod de chaque run (cluster)Sidecar : reçoit sur une socket Unix les messages de l’agent et du plugin, les écrit dans son journal sur disque et les relaie à l’opérateur en gRPC avec TLS mutuel. C’est la seule sortie du pod vers le plan de contrôle.
nexus-pluginDans AWFPlugin AWF qui pousse les événements d’un run et porte les opérations ask et report.
nexus-execLe pod d’un run avec une stackExécute un programme dans un autre conteneur du pod, avec son entrée, sa sortie et son code de sortie.

Workflows

PackContenu
openspec-tddPack gplanchat/awf-workflow-openspec-tdd, version épinglée dans deploy/runner/Dockerfile et installée dans l’image des runs : des changes OpenSpec avec une relecture Elephant Goldfish Model (EGM) dans les phases de conception et un test écrit avant le code.
packs/factoryask, apply-change, apply-many, apply-task, tdd-slice et free-task : appliquent des changes OpenSpec en parallèle, un worktree par change, un cycle qui commence par les tests pour chaque tâche, les fusions une à une et un rapport JSON. Installation : bash packs/factory/install.sh.

Infrastructure

DossierContenu
compose.yamlLa configuration poste unique.
infra/Playbook et rôles Ansible de la configuration homelab : système de base, MicroK8s, Kueue, pare-feu, DNS, autorité de certification, WireGuard, machine de sauvegarde.
deploy/helm/nexus-factoryChart Helm des configurations sur cluster.
api/Contrat OpenAPI du tableau de bord.