Lire les preuves de gouvernance
Touba expose des informations de gouvernance dans les sources, l'AIR, les manifests, les locks et les traces. La CLI, VS Code et l'API du serveur de projet permettent de les inspecter et de les intégrer aux besoins d'exploitation de votre application.
Où se trouve l'autorité
Le runtime applique les contrats et les refus. Un éditeur ou un client API ne peut pas créer d'autorité en dehors de ces contrats. Le source déclare le programme ; le manifest relie les tools et les grants hôte ; la trace décrit l'exécution réelle.
Inspecter avec la CLI et VS Code
Les commandes CLI permettent de compiler, inspecter et auditer. L'extension VS Code fournit les diagnostics, la navigation et les commandes fondés sur le même compilateur et la même CLI.
Avant un run, relisez capacités, callers, scopes mémoire et budgets. Après exécution, rapprochez la trace de l'AIR et du source correspondants.
Intégrer l'API de projet
L'API du serveur projet expose les états des runs, les demandes humaines et les événements. Une application peut associer ces contrats à son authentification et à son parcours utilisateur. Elle reste responsable de présenter une information claire et de ne demander que des actions autorisées.
Les changements sémantiques passent par des propositions validées par le serveur. Un client ne maintient pas un modèle d'autorité concurrent et ne réécrit pas les preuves du runtime.
Suivre l'exécution
Lisez les états et événements pour distinguer fin, refus, pause, annulation et dépassement de budget. Utilisez les exports de traces natives et l'audit des traces pour examiner la séquence.
Une réponse transport réussie ne suffit pas à prouver une opération métier. De même, un refus justifié constitue la preuve d'un contrôle, pas l'accomplissement de la tâche demandée.
Traiter les décisions humaines
La validation humaine porte l'approbation obligatoire ou la revue demandée par un agent. Rattachez chaque décision à sa demande et à son occurrence réelles. Le runtime la vérifie avant reprise ; une approbation n'accorde pas de permission de tool non déclarée.
Gardez les contextes privés et checkpoints dans un stockage autorisé. N'exposez pas de secrets résolus dans les messages client ou diagnostics. Le guide d'expiration décrit les demandes rejetées, annulées ou expirées.
Périmètre
Ces artefacts rendent les contrats représentés et l'exécution inspectables. L'évaluation réglementaire, l'attribution juridique et la revue des handlers hôtes restent du ressort des personnes et organisations qui exploitent l'application.