🇬🇧 English version
Architecture Decision Records
Archives datées et immuables des décisions structurantes d'Orkeon. Un ADR remplacé conserve son texte d'origine ; celui qui le remplace pointe en retour.
Pourquoi la numérotation commence-t-elle à 002 ? Il n'existe pas d'ADR-001 — la première décision enregistrée en ADR a reçu le numéro 002 et le trou a été conservé plutôt que de renuméroter, pour garder stables les références croisées existantes.
| ADR | Décision | Statut |
|---|---|---|
| ADR-002 | Orkeon.Tools.Abstractions en shared kernel (l'exception Infrastructure → Tools.Abstractions) |
Accepté |
| ADR-003 | Shared kernels secondaires : Application → Analysis.Abstractions, Infrastructure → Analysis |
Accepté |
| ADR-004 | Les jumeaux de nommage scripting, documentés sans renommage | Remplacé par l'ADR-007 |
| ADR-005 | La famille Tools.* hétérogène (Tools.Web/Tools.EventHub → Application) |
Accepté |
| ADR-006 | Le sous-système src/rag/ : shared kernel Orkeon.Rag.Abstractions, anciens namespaces RAG retirés sans shims |
Accepté |
| ADR-007 | Décision D3 : Orkeon.Cli.Scripting renommé en Orkeon.Cli.Commands.Scripting avant toute publication NuGet |
Accepté |
| ADR-008 | Un chemin physique n'est jamais un chemin virtuel : les runners montent sous un nom, les montages d'infrastructure sont invisibles aux agents | Accepté — son RunnerMounts est devenu RunnerVirtualRoots (ADR-009) ; la décision tient, le type a bougé |
| ADR-009 | Une constante sur laquelle deux projets doivent s'accorder vit dans un satellite sans dépendance, pas dans une copie manuelle gardée par un test de drift | Accepté — mis en œuvre (cinq satellites sous src/constants/) |
| ADR-010 | L'interop Microsoft Agent Framework est un paquet séparé (Orkeon.Interop.AgentFramework), dans les deux sens : un crew comme AIAgent, un AIAgent comme cerveau ou outil d'un agent Orkeon ; le contexte initial atteint enfin les prompts |
Accepté |
| ADR-011 | Les runners exportent OpenTelemetry selon le contrat standard (OTEL_EXPORTER_OTLP_ENDPOINT) ; Orkeon.Hosting.Aspire les ajoute à un AppHost ; le dashboard Aspire est la surface d'observabilité cross-platform et aucun front-end web ne sera construit |
Accepté |
| ADR-012 | La famille d'outils e-mail (Orkeon.Tools.Email) est la deuxième exception motivée au gel du périmètre : MailKit/MimeKit pour IMAP, POP3 et SMTP, Microsoft Graph pour Outlook.com, OAuth2 écrit à la main avec les jetons dans la racine interne /credentials derrière la vue privilégiée du VFS, droits par compte et liste d'autorisation d'envoi fermée par défaut ; email_parser y est reconstruit |
Accepté |
| ADR-013 | La famille d'outils drive (Orkeon.Tools.Drive) est la troisième exception motivée au gel du périmètre : Google Drive et OneDrive en HTTP simple, la couche OAuth déplacée dans Orkeon.Tools.Abstractions et partagée avec l'e-mail, droits et dossier racine par compte, liste d'autorisation de partage fermée par défaut, jetons dans le sous-répertoire drive de /credentials |
Accepté |
| ADR-014 | shell_command est confiné par le système d'exploitation par défaut : Auto choisit bubblewrap, Seatbelt ou un AppContainer, rien dans un conteneur, l'appel échoue franchement quand le moteur ne peut pas tourner ; une session shell persistante par exécution d'agent, tuée avec elle |
Accepté |
| ADR-015 | Les fournisseurs de modèles se rangent en quatre catégories (génération, embedding, reranking, décision), chacune avec son contrat et listée dans ModelProviderCatalog ; les fournisseurs de décision System One (TypeSafe, Liquid, Kev) se tiennent derrière un port distinct IDecisionModel, pas comme 17ᵉ fournisseur LLM ; une étape de décision autour d'un appel au LLM bloque, route ou escalade et ne réécrit jamais |
Accepté |
| ADR-016 | Une tâche de décision pose au modèle de décision des questions typées sans agent, et une condition when sur une tâche suivante lit ses réponses pour la lancer ou l'ignorer ; Sequential, Parallel et Graph les prennent en charge et les autres processus les refusent au chargement ; une condition fausse ignore et n'échoue jamais ; le modèle plus riche (nœuds de décision autour d'une tâche, boucles, journal) est reporté |
Accepté |
| ADR-017 | Le transcript peint des plages sur un texte qui reste la seule source du retour à la ligne et de la sélection ; seul le contenu peint un fond, et un script donne une source et un genre, jamais une couleur | Accepté |
| ADR-018 | Deux moteurs de graphe restent (Domain et JavaScript) et partagent une validation de topologie, un vocabulaire et les budgets du Domain ; un bloc YAML graph: (nodes, edges avec when, start, maxTransitions, maxVisits) remplace graphConfig:, plusieurs arêtes depuis une tâche de décision forment une arête conditionnelle avec un « sinon » obligatoire, et une équipe sans le bloc exécute un nœud par tâche |
Accepté |
| ADR — RaggableTree | Graphe sémantique stratifié à 5 niveaux plus arêtes via Tree-sitter (non numéroté — vit avec son guide d'architecture ; amendé le 2026-08-18) | Accepté |