Věcný NO-GO implementačního agenta nesmí být terminální incident
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Implementační agent korektně vrátí strukturovaný NO_GO s vysvětlením a důkazy. Dashboard přesto ukáže obecný terminální incident, podrobný důvod zmizí a workflow nepokračuje do opravného kola.
Root cause
Sekce “Root cause”Parser obálky verdikt podporoval, ale metoda adaptéru měla užší návratový kontrakt a přijímala pouze úspěšného kandidáta. Platný záporný výsledek proto změnila na výjimku. Obecný orchestrátorový catch nerozeznal doménový výsledek od neočekávaného pádu procesu.
platná obálka NO_GO → adaptér očekává jen READY → throw → obecný catch → terminální INCIDENT bez původní klasifikaceFix
Sekce “Fix”Návratový typ implementace je diskriminovaná unie: hotový kandidát nebo strukturovaný NO_GO s commitem, shrnutím a evidencí. Stavový automat má pro druhou větev samostatnou událost, která:
- append-only uloží celý výsledek před přechodem;
- zvýší počítadlo opravné revize;
- vrátí operaci do implementace;
- po pevném limitu skončí pravdivou chybou;
- nikdy nevytvoří incidentní záznam jen kvůli očekávanému verdiktu.
Neočekávané výjimky adaptéru, neznámý stav vedlejších účinků a porušená integrita zůstávají terminální a fail-closed.
NO_GO může obsahovat hodnotnou rozpracovanou práci
Sekce “NO_GO může obsahovat hodnotnou rozpracovanou práci”Další varianta stejné chyby vzniká, když agent před věcným NO_GO bezpečně opraví část kandidáta. Orchestrátor výsledek uloží, ale nechá pracovní strom rozpracovaný. Následující kolo pak skončí na obecné kontrole čistoty ještě předtím, než agent dostane šanci pokračovat.
Oprava je oddělit WIP checkpoint od auditovaného kandidáta:
- po strukturovaném
NO_GOse při nezměněném výchozímHEADvytvoří interní checkpoint commit; - checkpoint nespouští produkční gate a nesmí být vydáván za auditovaný kandidát;
- další kolo začíná z čistého stromu a navazuje na zachovanou práci;
- jednorázová obnova staršího incidentu je vázaná na přesný hash incidentu, výchozí commit a digest dirty statusu;
- opakovaný běh obnovy pouze ověří už existující checkpoint.
Pokud NO_GO zároveň popisuje chybějící externí capability, orchestrátor nejprve rezervuje samostatný prerequisite krok. Původní operaci obnoví až po jeho strojově doloženém dokončení.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Pro každý povolený verdikt parseru ověř integračním testem cestu až do durable stavu a UI.
- Anti-pattern:
if (verdict !== SUCCESS) thrownebo okamžitý návrat zNO_GObez durable převzetí změn, následovaný požadavkem na čistý strom v dalším kole. - Lepší přístup: Odděl očekávané doménové výsledky, validační chyby, transportní chyby a neznámé vedlejší účinky do různých typů a přechodů; rozpracované změny převezmi explicitním WIP checkpointem.
Sister bugs / související
Sekce “Sister bugs / související”Související je Formátová chyba agentní obálky zastaví jinak úspěšný workflow. Tam je problém ve formátu přenosu; zde je obálka validní a ztrácí se její věcný záporný verdikt.