Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Každý odkaz relativní k repozitáři ve vždy načítaném souboru je prokázaně vyřešitelný

Vždy načítaný instrukční soubor může odkazovat workery na další soubory (docs/DESIGN.md, .ai/repo/rules/README.md). doctor z něj vyextrahuje každý odkaz Markdown relativní k repozitáři a zkontroluje, že cíl existuje. Worker, který následuje rozbitý odkaz, promarní relaci na souboru, který tam není.

deklarovaný stavdeklarovaný stav: zaručeno Deklarováno jako deterministické a blokující, implementováno a s uvedeným behaviorálním testem, který to má dokázat. Zda to zaznamenaný běh podporuje, říká verdikt důkazů zobrazený vedle.

zaznamenané důkazyzaznamenané důkazy: nespuštěno Deklarováno jako zaručené, ale nepodložené zaznamenaným během: test je pojmenován, ale žádný úspěšný běh nad současnými vstupy zaznamenán není. jak se zaznamenávají důkazy

Co to znamená

Vždy načítaný instrukční soubor může workery odkazovat na další soubory (docs/DESIGN.md, .ai/repo/rules/README.md). doctor z něj vytáhne každý markdownový odkaz relativní k repozitáři a zkontroluje, že cíl existuje. Worker, který následuje rozbitý odkaz, promarní relaci na souboru, který tam není.

Princip

lib/doctor.sh prohledá vždy načtenou projekci na odkazy ](path), které nejsou absolutními URL, a každý otestuje proti souborovému systému relativně k adresáři souboru. Každá nerozřešená reference je selhávající nález jmenující cestu.

Jak to vidět

printf '\nSee [design](docs/MISSING.md).\n' >> AGENTS.md
majordomus doctor
# FAIL projection  AGENTS.md — content differs from its own stamp (hand-edited?)
# FAIL links       AGENTS.md — reference docs/MISSING.md does not resolve  [reproduce: ls docs/MISSING.md]

Co nepokrývá

Kontroluje se jen vždy načítaný soubor a jen cesty k souborům; kotvy uvnitř souborů ani externí URL se neověřují.

Proč existuje

Uzly pokynů zdrojového prostředí nashromáždily přes sto visících odkazů a jako doporučený workflow uváděly pět onboardingových skriptů, které neexistovaly. Linter, který je nakonec zachytil, měl jedinou ostrou řádku: nerozlišitelný odkaz je chyba.

Detail vykreslený z docs/claims/pointer-integrity.md.

Od tvrzení k důkazu

  1. 1 · veřejné tvrzení

    Každý odkaz relativní k repozitáři ve vždy načítaném souboru je prokázaně vyřešitelný

    Vzniklo na Doctor.

  2. 2 · kanonické tvrzení

    pointer-integritydeklarovaný stav: zaručeno v docs/CLAIMS.yaml

    Definováno v přečtěte si to na tomto webu · docs/DESIGN.md

  3. 3 · implementace

    lib/doctor.sh · majordomus doctor

  4. 4 · test a scénáře

    Test: test/cases/03_update.sh

    Provedeno v Udržet každý bootstrap providera tenký, generovaný a v rozpočtu.

  5. 5 · zaznamenané běhy

    zaznamenané důkazy: nespuštěno jak se zaznamenávají důkazy

Ověřte si to sami

Test běží v jednorázovém dočasném repozitáři a ověřuje chování, ne řetězec ve zdrojovém kódu.

z klonu repozitáře
bash test/run.sh 03_update

Kde se toto tvrzení používá

pokryté odpovědnosti

Související tvrzení stejná implementace

Okamžiky, na které to odpovídá

Prohledává názvy a popisy všech stránek, které tento web publikuje.