Crystal Teatest Golden
Use this skill when the Crystal repo already has golden fixtures and the job is to verify Crystal output, not define the oracle.
Scripts
scripts/run_crystal_teatest_verify.sh: default verification pathscripts/generate_crystal_golden.sh: raw capture fallbackscripts/generate_example_golden.sh: snapshot helper for simple examples
Default flow
- Prefer
scripts/run_crystal_teatest_verify.sh. - Run Crystal specs against existing goldens.
- Use raw capture only when the teatest harness is missing or broken.
- Treat Crystal-generated output as evidence, not as the source-of-truth oracle.
Typical command
./scripts/run_crystal_teatest_verify.sh \
--workdir <crystal_dir> \
--cmd 'crystal spec spec/examples/...'
Guardrails
- Keep Crystal cache local to the repo when possible.
- Prefer deterministic message injection over timing-heavy waits.
- If the golden oracle needs to be created or refreshed from Go, route to
bubbletea-go-teatest-goldenfirst.