Table of Contents

🇬🇧 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é