Skip to content

docs: add Chainsaw stable-state assertion convention to AGENTS.md#94

Merged
SebTardif merged 1 commit into
mainfrom
docs/chainsaw-stable-state-convention
May 27, 2026
Merged

docs: add Chainsaw stable-state assertion convention to AGENTS.md#94
SebTardif merged 1 commit into
mainfrom
docs/chainsaw-stable-state-convention

Conversation

@SebTardif

Copy link
Copy Markdown
Contributor

Add E2E testing convention: Chainsaw assertions must target stable operator states, not transient ones.

Learned from #87 (PR #92) where the recommend-mode test asserted Ready=False/InsufficientData (a transient state the operator passes through in seconds with minimumDataPoints=1). The assert raced with the reconcile loop and intermittently timed out.

Chainsaw tests that assert transient operator states (InsufficientData)
race with the reconcile loop when minimumDataPoints is low. Add testing
convention to prefer stable state assertions or script-based polls that
accept multiple valid states.

Signed-off-by: Sebastien Tardif <sebtardif@ncf.ca>
@github-actions github-actions Bot added area/docs Documentation size/xs < 10 lines changed labels May 27, 2026
@SebTardif SebTardif merged commit c077360 into main May 27, 2026
27 checks passed
@SebTardif SebTardif deleted the docs/chainsaw-stable-state-convention branch May 27, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation size/xs < 10 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant