Unit, integration, live release gates, and public site contract checks.
Sidekick is a Shell/Bash and Markdown project. Tests are Bash scripts under tests/, and the public site has dedicated contract checks so docs stay aligned with supported sidekicks.
| Tier | Script | Purpose |
|---|---|---|
| Strict unit and integration | tests/run_unit.bash | Static, hook, installer, manifest, generated-surface, docs, and runner-contract checks. |
| Skip-safe local sweep | tests/run_all.bash | Unit checks plus live wrappers in skip-safe mode when live env vars are absent. |
| Live Codex release gate | tests/run_in_kay.bash SIDEKICK_LIVE_CODEX=1 bash tests/run_release.bash | Release-authorizing live path for delegated Codex work. |
| Suite | Coverage |
|---|---|
tests/test_homepage_sidekicks.bash | Homepage names Kay, Codex, Cursor, activation commands, host verification, and release evidence. |
tests/test_help_site_navigation.bash | Help pages exist, share navigation, document Kay/Codex workflows. |
tests/test_docs_contract.bash | Public Markdown docs align with the current Sidekick contract. |
Verification should catch missed requirements, integration errors, regressions, wrong logic, syntax errors, wrong files, unverified assumptions, knowledge gaps, misunderstood task scope, incomplete trials, provider API failures, and external execution failures.