Co to znamená
Ať je poradce cokoli — API, klientský nástroj, lokální runtime, peer meshe — komunikace s ním končí jedním ze stejných výsledků: normalizovanou odpovědí, nebo typovaným selháním (timeout, rate_limited, auth_failed, malformed, empty, unavailable, cancelled, error) s diagnostikou, která nenese žádné tajemství. Zvláštnosti poskytovatele končí u adaptéru.
Princip
scripts/lib/advisors/contract.mjs definuje typ selhání, klasifikaci stavů HTTP a ukončení procesů, prompt (důkazy, hypotézu vykonavatele a dřívější rady označené jako názory), normalizaci odpovědi a consultOne, který spouští adaptér s termínem a signálem zrušení a jakékoli selhání promění ve výsledek. contract.test.mjs spouští každý adaptér proti falešnému fetch nebo falešnému procesu.
Jak to vidět
node --test scripts/lib/advisors/contract.test.mjs
test/cases/731_advisor_transport_contract.sh spouští sadu bez jakéhokoli přihlašovacího údaje v prostředí.
Co nepokrývá
Neprokazuje, že se živý dodavatel chová jako atrapy; to se zjistí při první konzultaci a zaznamená. Netestuje živý mesh dvou runtime; adaptér peera je testován proti falešnému serveru.
Proč existuje
Adaptér, který do workflow vhazuje vlastní chybu dodavatele, nutí každého volajícího učit se tohoto dodavatele. Jeden kontrakt, testovaný bez dodavatele, drží CI bez živých modelů (ADR 0098).