feat(constructs): add structured check intent [ship]

[thebiglabasky]

Summary

• publicly expose future-extensible CheckIntent authoring as a goal plus typed constraints on the RCA/self-healing check types
• preserve the three deployment states: omitted intent is not owned, an object sets intent, and null explicitly clears it
• serialize the construct-shaped constraints array directly to project deploys
• consume construct-shaped intent from imports, with a fallback for persisted pre-cutover import plans that still contain requiredOutcomes / mustPreserve

Construct shape

intent: {
  goal: 'Verify that authenticated users can open the dashboard.',
  constraints: [
    {
      type: 'REQUIRED_OUTCOME',
      statement: 'The dashboard displays the account overview.',
    },
    {
      type: 'MUST_PRESERVE',
      statement: 'Do not weaken the authentication assertion.',
    },
  ],
}

constraints is optional for concise goal-only authoring. The currently supported constraint types are REQUIRED_OUTCOME and MUST_PRESERVE; new kinds can extend the discriminant without changing the enclosing intent shape.

Supported constructs

ApiCheck, BrowserCheck, MultiStepCheck, PlaywrightCheck, UrlMonitor, DnsMonitor, IcmpMonitor, TcpMonitor, and GrpcMonitor accept intent.

AgenticCheck, HeartbeatMonitor, SslMonitor, and TracerouteMonitor intentionally do not expose it. Their code generators also ignore unexpected backend intent so imports keep producing valid construct code.

Deployment semantics

• intent: undefined omits the field from the synthesized resource and preserves UI/API-authored intent
• an intent object trims its strings and sends goal plus typed constraints
• omitted constraints synthesizes constraints: []
• intent: null synthesizes an explicit clear
• intent stays in the atomic project deployment, preview, and diff lifecycle; there are no post-deploy self-healing API calls

Backend dependency and rollout

This CLI shape depends on checkly/monorepo#3661, which updates /v1/projects/deploy to accept typed constraints and returns the same shape from imports and /v3/checks while preserving /v1/checks and /v2/checks.

Merge and deploy the backend PR before releasing this CLI PR. Older CLI versions remain compatible because they omit intent entirely. The codegen fallback for the stored array shape covers import plans persisted before the backend cutover.

Validation

• pnpm lint
• pnpm --filter checkly run prepare:dist
• pnpm --filter checkly run test:types
• pnpm pack
• focused Vitest suites: 43 tests passed, including synthesis, construct-shaped codegen, legacy import-plan fallback, and a packed fixture project

[github-actions]

Auto-approved: ship/show PR from a same-repo branch.