// Package api serves the alertstore HTTP contract.
//
// The annotations on the handlers in this package generate
// packages/contracts/alertstore/swagger.yaml, which is the single description
// of this service's browser-facing API. Regenerate with `make generate-swagger`
// after changing a route, a request body or a response type — a hand-edited
// contract is one the compiler cannot keep honest.
//
// The Alertmanager and Jira webhooks are deliberately absent. They are machine
// ingress with payloads owned by the sender, not part of the contract the web
// client is generated from.
//
//	@title			Alertstore API
//	@version		1.0
//	@description	Operational alert lifecycle for TiDB Cloud: alerts, the
//	@description	events they were raised from, subscriptions and mute rules.
//	@BasePath		/api/v1/alertstore
package api