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.

Pravidla, o nichž rozhoduje stroj, zapojená, otestovaná a blokující v CI

Pravidlo je vynucené, když o něm rozhoduje validátor, spouští ho příkaz, dokazuje ho test a blokuje na něm CI; cokoli menšího je dokumentace a nástroj ten rozdíl zná.

status
stav funkce: stabilní
doména
Governance
na domovské stránce
zvýrazněné

Co dělá

Efektivní sada pravidel je vendorovaný baseline, který nástroj dodává, plus pravidla, která napsal tento repozitář, vyřešená jako graf závislostí: chybějící závislost, cyklus nebo dvě pravidla nárokující si jednu identitu je chyba a sada, která se nevyřeší, se neaplikuje vůbec. Třída pravidla je blocking nebo advisory a žádná třetí; třída se čte v okamžiku dispatche a určuje, kam nález půjde, takže změna jednoho slova v souboru pravidla mění, zda majordomus check skončí nulou — a test přesně to ověřuje.

majordomus doctor čte zdroj, ne popis pravidla o sobě samém: funkce validátoru musí existovat, příkazy, které pravidlo jmenuje, ji musí volat, blokující pravidlo musí umět skončit nenulovým kódem, test ji musí dokazovat a CI musí ten test spouštět bez spolknutí jeho exit kódu. Validátor, který nedeklaruje žádné pravidlo, je vynucování běžící pod žádným pravidlem, a selže.

Co nedělá

Pravidlo bez validátoru je normativní pro toho, kdo ho čte, a nevynucuje ho nikdo, a říká to; nástroj nic jiného nepředstírá. Neexistuje žádný žebříček závažnosti, žádný baseline a žádné přepsání: projektové pravidlo smí přidat omezení a nikdy neoslabí vendorované.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Každý okamžik, na který odpovídá (31)

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Zdraví health ověřeno chováním

Zda je to, co tento proces servíruje, v pořádku, rozhodnuté stroji, které o tom už rozhodují: diagnostika indexu, builder registru, pokrytí projekce měření výkonu, porovnání, které provádí `generate --check`, a čtení lease, z něhož odpovídá `server.status`. Žádná zdejší kontrola nemá vlastní názor.

Pravidla rules ověřeno chováním

Co tento repozitář odmítá a co dokáže pro každé odmítnutí skutečně ukázat. Pravidlo deklaruje třídu — blocking, kde kontrola práci odmítne, nebo advisory, kde se očekává, že si ho čtenář přečetl — a blok vynucování, který pojmenovává buď validátor, jejž volá dispatcher, nebo případy chování, které ho dokazují. Tento modul tuto deklaraci spojuje se stromem a s knihou zaznamenaných běhů a hlásí pro každé pravidlo, zda to, co pojmenovává, existuje, zda ho vlastní nějaký runner, zda byl někdy spuštěn, zda běh prošel a zda je běh starší než to, čeho se týká. Blokující pravidlo, jehož důkaz chybí, visí v prázdnu nebo selhává, je nález, protože pravidlo, které nikdo nedokáže prokázat, je pravidlo, které nikdo nevynucuje.

Shellová automatizace shell ověřeno chováním

Shellová automatizace repozitáře změřená proti sledovanému inventáři migrace: nový shell se odmítne, pokud výjimka nedeklaruje, proč musí být shell a kdy přestane být, a odmítne se i výjimka, jejíž soubor zmizel, takže seznam se jen zmenšuje, jak se jednotky přesouvají do typovaných a skriptovaných schopností (ADR 0069).

Objekty, z nichž se skládá

Druhy objektů vrstvy. Každý je schéma, třída zdroje a soubor na disku; číslo vedle něj říká, kolik jich tento repozitář dnes obsahuje, spočítáno při sestavení.

  • rule189

Kde se nachází

doména
Governance — Pravidla se píšou jednou, v repozitáři, promítají se do instrukcí každého nástroje a blokující pravidlo příkaz zastaví, místo aby mu radilo.
oblasti práce
governanceověření
názvy
Kontrakt dokončeníPolitika
pojmenováno v
ZnalostiPokrytíKontrakt dokončeníPolitikaPřípady užitíCICommity

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

Schopnosti za touto funkcí podle rozhraní
schopnostpříkazová řádkaHTTPnástroj MCP
health.live —žádné GET /api/v1/live —žádné
health.ready —žádné GET /api/v1/ready —žádné
health.report —žádné GET /api/v1/health majordomus_health
rules.proves majordomus rules proves GET /api/v1/rules/proves majordomus_rule_proves
rules.report majordomus rules report GET /api/v1/rules majordomus_rules
rules.show majordomus rules show GET /api/v1/rules/rule majordomus_rule
shell.check majordomus shell check GET /api/v1/shell/check majordomus_shell_check
v Cockpitu, běžícího serveru
/cockpit/health Zdraví

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Spustitelné případy užití

Pravidla, která jej drží

  • blokující Nové vynucené pravidlo je doktrína, ne vložená kontrolaproject.rule-is-a-doctrine
  • blokující Integrita zapojení doktrínymajordomus.doctrine-wiring-integrity
  • blokující Zapojení vynucovánímajordomus.enforcement-wiring
  • blokující Integrita balíčku pravidelmajordomus.rule-package-integrity
  • blokující Žádné tvrzení bez testuproject.no-claim-without-test
  • blokující Pouze anglickyproject.english-only
  • blokující Každý nález nese příkaz k reprodukciproject.finding-carries-reproduce

Použití

Příkazy, které to spouštějí

  • majordomus rules inspect

    Efektivní sada pravidel: vendorovaný základ plus pravidla projektu.

  • majordomus doctrine inspect · jen pro čtení

    Která pravidla se vynucují, čím a zda je každé skutečně zapojené.

  • majordomus doctor inspect · jen pro čtení

    Kontroluje pouze správu: je samotný Majordomus v pořádku a je každé vynucování, které deklaruje, skutečně zapojeno i tady?

  • majordomus check verify · jen pro čtení

    Je aktuální úloha stále konzistentní se svou politikou, rozsahem a tímto checkoutem?

  • majordomus watch inspect · jen pro čtení

    Co se od poslední aktualizace rozešlo — politika, projekce, stav, retence.

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

Odkud tato stránka pochází

soubor
.ai/repo/features/doctrine.md
stejná odpověď
majordomus product show doctrine
číst dál

Doktrína

Dogfooding

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