Descriptor odkazuje na neregistrovanou executor capability
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Kanonický operation descriptor je syntakticky validní a obsahuje fáze preflight, execute a verify. Kampaň přesto zůstane v BLOCKED_ON_DEPENDENCY, protože uvedená templateId nejsou v načteném executor registru. Samotná existence descriptoru tedy mylně působí jako důkaz vykonatelnosti.
Root cause
Sekce “Root cause”Repo s auditovaným kandidátem a repo orchestrátoru ověřovaly jen svou polovinu kontraktu:
{ "templateId": "example-install-execute", "args": { "Go": "<HASH_BOUND_GO>" } }Kandidátní brána ověřila tvar descriptoru, ale neměla přístup k registru executoru. Registr zase neměl test, který by načetl konkrétní descriptor a prokázal, že všechny tři fáze vedou na existující, úzce omezený executable kontrakt. Vznikla mezera mezi „auditovatelný artefakt“ a „spustitelná capability“.
Fix
Sekce “Fix”Do registru byly přidány tři přesné šablony pro jediný auditovaný klientský wrapper: nemutující preflight, jediný mutující execute a nemutující verify. Registr nepovoluje obecný shell; každá šablona připouští pouze pevný executable, pevný mode argument a jediný validovaný hash-bound Go slot.
Finalizer současně ověřuje přesnou množinu template ID a doplní pouze deterministicky odvoditelné kotvy. Regresní test následně:
- načte skutečný descriptor,
- načte skutečný registr,
- ověří všechny tři požadavky runtime parserem,
- odmítne chybějící šablonu, jiný executable i volný shellový argument.
Recovery navíc váže každý pokus na konkrétní blocker event. Starší dokončená recovery téže operace nesmí zablokovat novější lineárně navázaný blocker.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: porovnejte množinu všech
templateIdv aktivních descriptorech s množinou načtených executor šablon a vyžadujte prázdný rozdíl. - Anti-pattern: test descriptoru kontroluje pouze JSON schema a test registru pouze vlastní položky; žádný test je nespojí.
- Lepší přístup: capability považujte za existující až po společném testu
descriptor → registry → runtime parser → fixed executable. Durable recovery identifikujte dvojicí operace a hash konkrétního blocker eventu, ne jen operation ID.
Sister bugs / související
Sekce “Sister bugs / související”read-only-krok-s-mutujici-prerekvizitou.md— instalační prerekvizita musí být samostatným effectful krokem.externi-recovery-a-stary-in-memory-kontext.md— out-of-process recovery vyžaduje zastavený daemon nebo versionovaný reload.implementer-no-go-nesmi-byt-incident.md— chybějící capability je dependency blocker, nikoli obecný incident.