Prismatic × Sig Nihl // Diagnostika lidských systémů
Příkazy
Tento rejstřík obsahuje každý příkaz, který se kdekoli v dokumentaci projektu objevuje. Každá položka odkazuje na zdrojový soubor a uvádí testy nebo joby v CI, které příkaz spouštějí.
Rejstřík je vynucený. Stránka dokumentace, která zmíní příkaz chybějící v tomto seznamu nebo zmíní příkaz v textu bez odkazu na jeho položku zde, neprojde validací. Položka rejstříku, jejíž ověření nestojí na existujícím testu nebo jobu v CI, neprojde testy.
Příprava prostředí
npm ci#Nainstaluje zafixované závislosti Node.js z package-lock.json a nasměruje Git na hooky repozitáře v .githooks.
Zdroj: package.json · Ověřeno: ci:Validate and build, ci:End-to-end (subpath preview)
python3 -m venv .venv && .venv/bin/pip install -r requirements-dev.txt#Vytvoří virtuální prostředí projektu a nainstaluje zafixované nástroje pro testy v Pythonu.
Zdroj: requirements-dev.txt · Ověřeno: ci:Python tests
Vývoj a build
npm run dev#Spustí Tailwind ve sledovacím režimu vedle zola serve pro lokální psaní s živým obnovováním.
Zdroj: scripts/dev.sh · Ověřeno: pytest:test_dev_server_serves_the_site
npm run preview#Postaví produkční web a servíruje ho pod stejnou podcestou repozitáře, jakou používá GitHub Pages.
Zdroj: scripts/preview.sh · Ověřeno: ci:End-to-end (subpath preview)
npm run build#Zkopíruje přibalené knihovny pro prohlížeč, zkompiluje Tailwind a spustí zola build do public/.
Zdroj: package.json · Ověřeno: pytest:test_build_produces_the_site
Validace a testy
npm run validate#Spustí všechny statické kontroly: nástroje, assety, syntaxi JavaScriptu, shodu překladů, obsahové standardy, rejstřík příkazů, kontrolu a build Zoly, HTML a odkazy.
Zdroj: scripts/validate.sh · Ověřeno: ci:Validate and build
npm run test:python#Spustí sadu pytest pro validátory, exportéry a rejstřík příkazů.
Zdroj: tests/python · Ověřeno: ci:Python tests
npm test#Spustí prohlížečové testy Playwright proti lokálnímu produkčnímu buildu servírovanému pod podcestou Pages.
Zdroj: tests/site.spec.js · Ověřeno: ci:End-to-end (subpath preview)
scripts/lint-commits.sh <range>#Zkontroluje, že předměty commitů odpovídají Conventional Commits; stejný skript používá hook commit-msg.
Zdroj: scripts/lint-commits.sh · Ověřeno: ci:Conventional commits, pytest:test_lint_commits_accepts_and_rejects
python3 scripts/validate-content.py#Zkontroluje obsahové standardy (pole důkazů, SEO popisy, zakázané propagační formulace) a to, že každý zdokumentovaný příkaz je v rejstříku a je na něj odkaz.
Zdroj: scripts/validate-content.py · Ověřeno: ci:Validate and build, pytest:test_content_passes_on_repository
python3 scripts/validate-layout.py#Zkontroluje, že na webu nic neroluje uvnitř stránky: žádné rolovací overflow ve stylech ani šablonách a žádná minimální šířka uvnitř obrázku nebo tabulky.
Zdroj: scripts/validate-layout.py · Ověřeno: ci:Validate and build, pytest:test_layout_passes_on_repository
python3 scripts/validate-models.py#Zkontroluje registr interaktivních modelů proti docs/MODELS.md: dvojjazyčná pole, dohledatelná tvrzení a zdroje, epistemickou třídu pro každou část modelu, předpoklady, limity, pravidla, implementaci a její testy.
Zdroj: scripts/validate-models.py · Ověřeno: ci:Validate and build, pytest:test_registry_passes_on_the_repository
python3 scripts/validate-claims.py#Zkontroluje registr důkazů: ohodnocení všech zdrojů, úroveň tvrzení nejvýš podle zdrojů, intervaly a data revizí, pokrytí každé výzkumné poznámky a rady a slovník pojmů.
Zdroj: scripts/validate-claims.py · Ověřeno: ci:Validate and build, pytest:test_ledger_passes_on_repository
python3 scripts/validate-audiences.py#Zkontroluje taxonomii publik: šest pohledů a publika, která na ně vedou, dvojjazyčné popisky, existující výchozí stránky, sloty rozbalení, které nějaká komponenta vykresluje, a epistemický slovník přesně o šesti slovech.
Zdroj: scripts/validate-audiences.py · Ověřeno: ci:Validate and build, pytest:test_audiences_pass_on_repository
python3 scripts/check-references.py --online#Offline zkontroluje registr literatury; s --online porovná každé DOI, název a rok s Crossrefem.
Zdroj: scripts/check-references.py · Ověřeno: ci:References (Crossref), pytest:test_references_pass_offline_on_repository
Nasazení a vydání
npm run test:production#Spustí celou sadu prohlížečových testů proti živé URL na GitHub Pages (BASE_URL ji přepíše).
Zdroj: package.json · Ověřeno: ci:Verify production
npm run smoke#Zkontroluje, že každá stránka, feed, náhledový obrázek a asset živého webu odpovídá očekávaným stavem.
Zdroj: scripts/smoke-production.sh · Ověřeno: ci:Verify production
gh run list --workflow pages.yml --limit 5#Vypíše poslední běhy pipeline Pages a jejich stav.
Zdroj: .github/workflows/pages.yml · Ověřeno: pytest:test_gh_run_list_reads_the_pipeline
scripts/release.sh --dry-run#Vypíše další verzi a poznámky k vydání odvozené z commitů od posledního tagu, aniž by cokoli publikoval.
Zdroj: scripts/release.sh · Ověřeno: ci:Release, pytest:test_release_dry_run_computes_a_version
Integrace Rustu
python3 scripts/export-api.py --out public#Vyexportuje výzkumné poznámky, rady, literaturu a rejstřík příkazů jako verzované JSON API v adresáři api/v1.
Zdroj: scripts/export-api.py · Ověřeno: ci:Validate and build, pytest:test_export_api_writes_the_contract
cargo test --workspace#Spustí jednotkové testy Rustu a testy kontraktu a CLI proti exportovanému API.
Zdroj: Cargo.toml · Ověřeno: ci:Rust
cargo clippy --workspace --all-targets -- -D warnings#Zkontroluje Rust workspace lintem a každé varování považuje za chybu.
Zdroj: Cargo.toml · Ověřeno: ci:Rust
cargo fmt --all --check#Zkontroluje, že kód v Rustu je naformátovaný zafixovaným rustfmt.
Zdroj: rust-toolchain.toml · Ověřeno: ci:Rust
cargo run -p caas-cli -- claims list --due-by 2027-03-31#Spustí klienta caas pro příkazovou řádku: výpis a zobrazení rad, výpis výzkumu, tvrzení k revizi, zobrazení tvrzení nebo pojmu, kontrola knihovny, odpověď endpointu.
Zdroj: crates/caas-cli/src/main.rs · Ověřeno: ci:Rust
Dozor s Majordomem
majordomus start "<task>" --scope <paths>#Zahájí dozorovanou úlohu s deklarovaným rozsahem cest, na které smí práce sáhnout.
Zdroj: .ai/repo/workflows/task-lifecycle.md · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus check#Ohlásí, zda je aktivní úloha v souladu s politikou, rozsahem a zaznamenaným stavem (jen pro čtení).
Zdroj: .ai/repo/workflows/task-lifecycle.md · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus checkpoint < note.md#Zaznamená krátkou poznámku o průběhu aktivní úlohy.
Zdroj: .ai/repo/workflows/continuity.md · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus finish --outcome completed --verify-command "npm run smoke"#Vyhodnotí smlouvu o dokončení a uzavře úlohu, jen pokud projde ověřovací příkaz; --check běží v hooku pre-push.
Zdroj: .githooks/pre-push · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus watch#Ohlásí odchylky mezi zaznamenanou úlohou, jejím rozsahem, politikou a generovanými projekcemi.
Zdroj: .ai/repo/policy.yaml · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus doctor#Zkontroluje, že dozorová vrstva je v pořádku a zapojená; běží v hooku pre-commit a v CI.
Zdroj: .githooks/pre-commit · Ověřeno: ci:Majordomus supervision
majordomus history#Vypíše ledger se záznamy o startech úloh, checkpointech, handoverech a dokončeních, do kterého se jen přidává.
Zdroj: .ai/README.md · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus handover < body.md#Zapíše záznam pro navázání s cílem, aktuálním stavem a dalším krokem.
Zdroj: .ai/repo/workflows/continuity.md · Ověřeno: pytest:test_majordomus_commands_are_available
majordomus decision add "<decision>" --why "<rationale>"#Zaznamená trvalé rozhodnutí s odůvodněním, odmítnutými alternativami a důkazy.
Zdroj: .ai/README.md · Ověřeno: pytest:test_majordomus_commands_are_available
python3 scripts/export-case-study.py#Vyexportuje kurátorovaný snímek případové studie (data/case_study.json) z ledgeru Majordomu, Gitu a GitHubu; --check ověří snímek bez lokálního stavu a bez sítě.
Zdroj: scripts/export-case-study.py · Ověřeno: pytest:test_case_study_check_passes_on_repository, pytest:test_case_study_export_is_deterministic
majordomus rules list#Vypíše platnou sadu pravidel (převzatý základ a projektová pravidla) s třídou a příkazy, které každé pravidlo vynucují (jen pro čtení).
Zdroj: .ai/repo/rules/README.md · Ověřeno: pytest:test_majordomus_read_only_commands_used_by_the_case_study
majordomus adr list#Vypíše záznamy architektonických rozhodnutí s jejich stavem; přijetí zůstává na člověku (jen pro čtení).
Zdroj: .ai/repo/adrs/README.md · Ověřeno: pytest:test_majordomus_read_only_commands_used_by_the_case_study
Dílo a náhledy
npm run render:artwork#Znovu vykreslí master plakátu, náhledové karty a sadu ikon ze zdrojů v adresáři artwork/.
Zdroj: scripts/render-artwork.sh · Ověřeno: pytest:test_render_artwork_check_mode
python3 scripts/render-social.py#Vykreslí náhled 1200×630 pro sociální sítě pro každou stránku a jazyk z artwork/og.html; s --check bez prohlížeče ověří, že každá stránka má aktuální náhled.
Zdroj: scripts/render-social.py · Ověřeno: ci:Validate and build, pytest:test_social_check_reports_a_missing_preview