Write Canary Tests

Goal

Write correct test blocks for canary checks.

Golden Rules

• The test result must be boolean (true / false).
• Use null-safe access for optional fields (.? + orValue(...)).
• Tests add assertions; they do not bypass built-in check failures.

Test Fields

Common Test Context

Exact fields vary by check type.

Canonical Snippets

1) HTTP status + JSON assertion

test:
  expr: "code == 200 && json.uuid != ''"

2) HTTP header assertion

test:
  expr: "! ('Authorization' in headers.keys())"

3) Exec stdout assertion

test:
  expr: 'results.stdout == "hello"'

4) Kubernetes health assertion

test:
  expr: dyn(results).all(x, k8s.isHealthy(x))

5) JUnit summary assertion

test:
  expr: results.failed == 0 && results.passed > 0

6) dependsOn output assertion

test:
  expr: "code == 200 && outputs.getUuid.json.uuid != ''"

7) Nil-safe list check

test:
  expr: results.?files.orValue([]).size() > 0

References

• Canary Checker spec reference: https://flanksource.com/docs/reference/canary-checker/llms.txt