Docs menu

Health Engine

Define health checks and run health_check / health_enforce before promotion.

What you will learn

  • Configure .ags/health.yml
  • health_check
  • health_enforce

Prerequisites

Surface

MCPhealth_get · health_validate · health_enforce · health_check
Config.ags/health.yml

What this feature does

Health Engine probes endpoints or scripts declared in policy. Production promotion should require health_enforce green.

How to call it

Call these MCP tools through your AGS / tower-gov host — health_get, health_validate, health_enforce, health_check.. Prefer scan/get before validate/diff, and enforce only when the change set is ready.

  1. health_get
  2. health_check
  3. Fix failing targets
  4. health_enforce
MCP: health_check json
{ "environment": "staging" }

What success looks like

All checks pass

health_enforce ok

Common failure modes

Stale success cache

Wrong environment id

Skipping health before promote_enforce

Related reference

AGS documentation