smoke

Golden-file / snapshot smoke testing of shell-command output with the SMOKE CLI. Capture a command's observable output once, lock it into a *.lock.yml, and let later runs go UNCHANGED when output matches or CHANGED when it drifts. TRIGGER when: setting up snapshot or golden-file testing for a CLI tool or shell command, capturing command output as a baseline/golden, detecting output drift across runs, writing or editing a tests.yml / *.cue smoke spec, or interpreting SMOKE's UNCHANGED / CHANGED / NEW verdicts and 0 / 1 / 2 / 3 / 64 / 65 exit codes. Critical framing other tools get wrong: SMOKE detects DRIFT, not correctness — CHANGED is the expected "eyeball and re-commit" state, NOT a failing test; UNCHANGED means drift-free, NOT verified-correct. An agent must never chase output back to green or auto-commit a CHANGED result it did not read. DO NOT TRIGGER for assertion-based unit/integration frameworks (go test, pytest, jest), or test work that is not snapshot/golden-file based.