Documentation

Automonique, en bref

Ce qu’est Automonique, comment il est construit et par où commencer.

Ce que fait Automonique

Automonique est un plan de contrôle d’agents durable et local-first. Il accepte du travail, l’exécute au moyen de plusieurs fournisseurs de modèles et d’outils, conserve son état à travers les pannes et les mises à jour, et expose la même autorité à chaque client.

Conçu d’abord pour Linux et écrit principalement en Rust, il vise à rendre chaque changement d’état et chaque effet externe typé, vérifié par révision, journalisé et réconciliable.

Les pièces du système

  • Le daemon : un état durable dans SQLite, tenu par une seule génération de processus clôturée, et des sockets Unix locaux privés, dont le socket d’administration qui authentifie le pair par ses identifiants noyau.
  • Le runner : il lance les processus des fournisseurs dans un sandbox noyau (cgroup v2, Landlock, seccomp) et supervise chaque tentative.
  • Le broker de sortie : un proxy CONNECT en loopback, ouvert pour une seule exécution, qui n’autorise que les couples hôte et port déclarés.
  • Les surfaces : Telegram, Slack, GitHub, l’intake support, l’exécution de fournisseurs, l’auto-amélioration et la mémoire durable. Les surfaces externes sont activées chacune par son propre fichier ; la mémoire durable, elle, fonctionne par défaut.
  • Les clients : la CLI automonique, le tableau de bord web (service distinct, en loopback) et les SDK sous Apache-2.0 : @automonique/sdk en TypeScript et automonique-platform-client en Rust. L’application Android en aperçu vit dans un dépôt séparé.

Organisation du dépôt

Arborescence
docs/product-plan/        objectifs produit, exigences, architecture, migration
docs/operational-state.md propriété du runtime et source de vérité
rust/crates/              crates produit en Rust et leurs tests
sdk/                      SDK clients sous Apache-2.0
tools/                    outils de développement et de diagnostic

AGENTS.md                 règles de développement et de sécurité
GOVERNANCE.md             frontières d’autorité
LICENSE-POLICY.md         répartition Elastic-2.0 / Apache-2.0
PROVENANCE.md             provenance clean-room

Par où commencer

DémarrerConstruire le workspace, lancer le daemon et lire son état.ConfigurationActiver une surface, déclarer les destinations réseau.Sandbox et garde-fousLes frontières noyau appliquées à chaque exécution.ExploitationService systemd, mises à jour, réconciliation, sauvegardes.État actuelCe qui fonctionne aujourd’hui et ce qui manque encore.LicencesElastic License 2.0, Apache-2.0 et provenance.