Table of Contents

🇬🇧 English version

Conformité console

Le code du framework ne touche jamais System.Console. La console du processus est un état global : une écriture dessus ne peut pas être capturée par un test qui tourne à côté d'un autre, un échange Console.SetOut entre en course avec tous les autres tests du processus, et sous orkeon mcp serve une ligne parasite sur stdout corrompt le canal JSON-RPC. Les sorties passent par un ILogger injecté ; les lectures et les écritures interactives par un TextWriter/TextReader injecté ou une abstraction de console que le point d'entrée de l'exécutable construit et transmet.

L'analyseur : ORKCON001

ConsoleUsageAnalyzer est livré dans src/analyzers/Orkeon.Compliance.Vfs/, à côté des règles VFS, et s'applique à tous les projets de src/. Il signale toute référence à un membre de System.Console (appel, propriété, événement, groupe de méthodes), jugée sur le symbole résolu : using static System.Console; WriteLine(...) est signalé, une propriété nommée Console de type IConsoleAdapter ne l'est pas. Un texte dans une chaîne littérale (le programme que HostProcessRunner écrit pour un processus enfant) n'est pas une référence et n'est pas signalé.

.editorconfig la place en error sous [src/**.cs]. Les tests (/tests/) et les exemples (/examples/) en sont exemptés.

Exemption : [SuppressConsoleCompliance]

L'attribut est public dans Orkeon.Domain (espace de noms Orkeon.Compliance.Vfs) ; un projet qui ne référence pas Orkeon.Domain en déclare une copie interne, reconnue par son nom. Sa raison commence par l'une de deux catégories, vérifiées par SuppressionReasonCategoryTests :

Catégorie Sens Où
CONSOLE-ADAPTER Une implémentation d'une abstraction de console sur la console du processus SystemConsoleAdapter, LineEditingConsoleAdapter, SystemLineEditorConsole (Orkeon.Cli.Abstractions), SystemRunnerConsole (Orkeon.Hosting), SystemTerminalProbe (Orkeon.Cli.TerminalGui)
CONSOLE-SINK L'unique point d'un exécutable qui transmet les vrais flux orkeon (Program.UseUtf8Console), orkeon-repl (Program.Main, Program.HandleReplayInterrupt et son CancelKeyRegistration, qui tiennent Ctrl+C pendant un replay dans la console simple), orkeon-host (HostConsole, StartupFailureReporting.cs)

Rien d'autre ne le porte : un nouvel exécutable reçoit un puits, une nouvelle abstraction de console un adaptateur.

D'où viennent les flux

Couche Abstraction Implémentation système
Commandes du REPL (Orkeon.Cli.Abstractions) IConsoleAdapter SystemConsoleAdapter, LineEditingConsoleAdapter
Runners et CLI orkeon (Orkeon.Hosting) IRunnerConsole : Output, ErrorOutput, Input, IsInputRedirected, OnInterrupt(handler) SystemRunnerConsole.Instance, porté par RunnerOptionsBase.RunnerConsole
Interface terminal (Orkeon.Cli.TerminalGui) ITerminalProbe : sondes de redirection, OutputIsUtf8, TreatControlCAsInput, Output, Diagnostics SystemTerminalProbe.Instance, porté par TerminalGuiOptions.Terminal
Adaptateurs de bibliothèque paramètres TextReader/TextWriter ConsoleHumanInputProvider(logger, input, output), McpServer.RunStdioAsync(reader, writer, ct)

Un verbe gère Ctrl+C par IRunnerConsole.OnInterrupt, jamais par Console.CancelKeyPress ; l'enregistrement est libéré à la fin du verbe.

Avertissements opérateur : la catégorie Orkeon.Operator

Les avertissements de démarrage de l'hôte des runners (jetons indisponibles, LLM non configuré, référence de clé d'API non résolue, serveur MCP indisponible) passent par la seule catégorie de logger Orkeon.Operator, parce qu'un hôte peut garder son logger sous Error : cette catégorie est servie par un fournisseur dédié dont le niveau minimal est forcé à Warning quel que soit -v, et qui écrit une ligne sur IRunnerConsole.ErrorOutput. RunnerHost l'ajoute pour le CLI orkeon et orkeon-host, après la configuration de journalisation de l'appelant (donc après un ClearProviders) ; orkeon-repl l'ajoute dans ReplStartup.