Le passe montrait la décision prise sur chaque assietteUn garde-fou dont la décision est inspectableThe pass showed the decision made on each plateA guardrail whose decision can be inspected
Chaque contrôle du passe laissait une marque lisible : assiette passée ou retenue. On pouvait ainsi lire l’état du service et ses changements sans deviner ce qui s’était produit derrière la porte. La décision du garde devenait visible au lieu d’être seulement supposée.L’observabilité est la capacité à lire l’état et les transitions nécessaires au diagnostic d’un comportement d’exécution. OpenHands en donne un cas net : les événements d’exécution de hooks, avec leur résultat success ou blocked, sont exposés par ses surfaces runtime et UI/API. Le comportement des garde-fous y est inspectable au lieu de rester déductible.Each check at the pass left a readable mark: plate sent or held. The state of service and its changes could then be read without guessing what happened behind the door. The guard’s decision became visible rather than merely assumed.Observability is the ability to read the state and transitions needed to diagnose runtime behavior. OpenHands is a clear case: hook execution events, carrying a success or blocked result, are exposed through its runtime and UI/API surfaces. Guardrail behavior there is inspectable instead of being something you infer.
Les contrôles et les preuvesValidation et preuvesChecks and proofValidation and evidence
Le signe était une décision que l’on pouvait lire sans reconstituerSignauxThe sign was a decision readable without reconstructionSignals
Le signe n’est pas une assiette plausible, mais un contrôle dont on peut lire le geste, le résultat et l’endroit où le trouver. Une même décision doit se voir au passe comme en salle. Sans cela, il reste seulement une fin de service crédible, jamais les étapes qui l’ont produite.On reconnaît l’observabilité à ce qui est lisible sans reconstitution : les événements d’exécution des contrôles, leur résultat, et la surface où les lire. Chez OpenHands, les deux résultats — success et blocked — apparaissent côté runtime comme côté UI/API, donc la même décision est consultable depuis deux points. À l’inverse, l’absence du motif se reconnaît à un résultat final plausible dont aucune étape n’est consultable.The sign is not a plausible plate, but a check whose move, result, and reading place can be seen. One decision must show at the pass and in the room alike. Without that, only a credible end of service remains, never the steps that made it.Observability shows up as what can be read without reconstruction: the execution events of the checks, their result, and a surface to read them on. In OpenHands both results — success and blocked — appear on the runtime side and on the UI/API side, so the same decision can be consulted from two places. Its absence shows up as a plausible final outcome whose intermediate steps cannot be consulted anywhere.
Un silence du passe laissait toutes les explications ouvertesMécanismeSilence at the pass left every explanation openMechanism
Un garde silencieux ressemble à un garde qui ne s’est jamais présenté. Une assiette absente peut avoir été retenue, ou ne jamais avoir été préparée. Sans marque pour chaque contrôle, une fin plausible absorbe aussi bien une bonne retenue qu’une règle jamais regardée.Un garde-fou silencieux est indistinguable d’un garde-fou qui ne s’est pas déclenché, et les deux ressemblent à une action qui n’a simplement pas eu lieu. Sans événement par exécution, seul l’effet final est disponible, et un effet final plausible absorbe aussi bien un blocage légitime qu’une règle jamais évaluée. Le diagnostic bascule alors sur la reconstitution, c’est-à-dire sur une hypothèse.A silent guard looks like one that never appeared. A missing plate may have been held, or never prepared. Without a mark for each check, a plausible ending covers both a proper hold and a rule never considered.A silent guardrail is indistinguishable from a guardrail that never fired, and both look like an action that simply did not happen. Without an event per execution, only the end effect is available, and a plausible end effect absorbs a legitimate block as easily as a rule that was never evaluated. Diagnosis then falls back on reconstruction, which is to say on a guess.
Faire annoncer à chaque garde ce qu’il a décidéRéponseLet each guard announce its decisionResponse
Chaque garde doit laisser une marque avec son nom et sa décision, surtout lorsqu’il retient une assiette. Rendez cette marque lisible là où l’on cherche réellement pendant le coup de feu, au passe comme en salle. Jugez-la à la question qu’elle tranche, non au nombre de lignes qu’elle remplit.Émettre un événement par exécution de contrôle, portant au minimum l’identité du contrôle et son résultat, y compris lorsque ce résultat est un blocage. Exposer ces événements sur les surfaces réellement consultées — côté runtime et côté UI/API, comme le fait OpenHands — puisqu’une trace lisible d’un seul côté n’est pas consultable pendant l’incident. Juger l’instrumentation sur la question qu’elle permet de trancher, pas sur le volume produit.Each guard must leave a mark with its name and decision, especially when it holds a plate. Make that mark readable where people actually look during the rush, at the pass and in the room. Judge it by the question it settles, not by the number of lines it fills.Emit one event per check execution, carrying at least the check identity and its result, including when that result is a block. Expose those events on the surfaces people actually consult — runtime side and UI/API side, as OpenHands does — since a trace readable from one side only is not consultable during the incident. Judge instrumentation by the question it settles, not by the volume it produces.
Une décision sans marque ne peut pas être vérifiéeLeçonA decision without a mark cannot be checkedLesson
Un garde doit laisser une marque de ce qu’il a décidé. Sans événement, sa décision ne peut pas être vérifiée. Une règle invérifiable ne vaut que l’hypothèse qu’on raconte à sa place.Un garde-fou doit laisser une trace observable de ce qu’il a décidé. Une décision qui ne produit aucun événement n’est pas vérifiable, et une règle invérifiable ne vaut que l’hypothèse formulée à sa place.A guard must leave a mark of what it decided. Without an event, that decision cannot be checked. A rule that cannot be checked is worth only the story told in its place.A guardrail must leave an observable trace of what it decided. A decision that produces no event cannot be verified, and an unverifiable rule is worth no more than the guess made in its place.