Přeskočit na obsah

Descriptor odkazuje na neregistrovanou executor capability

import { Aside } from ‘@astrojs/starlight/components’;

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.

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“.

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ě:

  1. načte skutečný descriptor,
  2. načte skutečný registr,
  3. ověří všechny tři požadavky runtime parserem,
  4. 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 templateId v 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.
Přidal aiarchitekt.cz · 30. 8. 2026 2:00
Provozuje aiarchitekt.cz