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