api

type AppendLogsJSONRequestBody = LogChunk

type AppendLogsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type Category = events.Category

type CheckGateJSONRequestBody = GateCheck

type CheckGateResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *GateCheckOK
	JSON409      *CodedError
	JSON500      *CodedError
	JSON503      *CodedError
}

type Claim = events.Claim

type ClaimsListRequest struct {
	Environment string `json:"environment"`
}

type ClaimsReleaseRequest struct {
	Environment string `json:"environment"`
	Pr          int    `json:"pr"`

	// Stack Empty releases all of the PR's claims in the environment.
	Stack string `json:"stack"`
}

type Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {
	// ListApprovals request
	ListApprovals(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListClaimsWithBody request with any body
	ListClaimsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ListClaims(ctx context.Context, body ListClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ReleaseClaimsWithBody request with any body
	ReleaseClaimsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ReleaseClaims(ctx context.Context, body ReleaseClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetExecution request
	GetExecution(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListExecutions request
	ListExecutions(ctx context.Context, params *ListExecutionsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// FinalizeExecutionWithBody request with any body
	FinalizeExecutionWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	FinalizeExecution(ctx context.Context, body FinalizeExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CheckGateWithBody request with any body
	CheckGateWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CheckGate(ctx context.Context, body CheckGateJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// RevokeGateWithBody request with any body
	RevokeGateWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	RevokeGate(ctx context.Context, body RevokeGateJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// InitExecutionWithBody request with any body
	InitExecutionWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	InitExecution(ctx context.Context, body InitExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AppendLogsWithBody request with any body
	AppendLogsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AppendLogs(ctx context.Context, body AppendLogsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ReportPhaseWithBody request with any body
	ReportPhaseWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ReportPhase(ctx context.Context, body ReportPhaseJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetPR request
	GetPR(ctx context.Context, n int, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateStackWithBody request with any body
	UpdateStackWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateStack(ctx context.Context, body UpdateStackJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {
	// ListApprovalsWithResponse request
	ListApprovalsWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*ListApprovalsResponse, error)

	// ListClaimsWithBodyWithResponse request with any body
	ListClaimsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ListClaimsResponse, error)

	ListClaimsWithResponse(ctx context.Context, body ListClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*ListClaimsResponse, error)

	// ReleaseClaimsWithBodyWithResponse request with any body
	ReleaseClaimsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ReleaseClaimsResponse, error)

	ReleaseClaimsWithResponse(ctx context.Context, body ReleaseClaimsJSONRequestBody, reqEditors ...RequestEditorFn) (*ReleaseClaimsResponse, error)

	// GetExecutionWithResponse request
	GetExecutionWithResponse(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*GetExecutionResponse, error)

	// ListExecutionsWithResponse request
	ListExecutionsWithResponse(ctx context.Context, params *ListExecutionsParams, reqEditors ...RequestEditorFn) (*ListExecutionsResponse, error)

	// FinalizeExecutionWithBodyWithResponse request with any body
	FinalizeExecutionWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*FinalizeExecutionResponse, error)

	FinalizeExecutionWithResponse(ctx context.Context, body FinalizeExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*FinalizeExecutionResponse, error)

	// CheckGateWithBodyWithResponse request with any body
	CheckGateWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CheckGateResponse, error)

	CheckGateWithResponse(ctx context.Context, body CheckGateJSONRequestBody, reqEditors ...RequestEditorFn) (*CheckGateResponse, error)

	// RevokeGateWithBodyWithResponse request with any body
	RevokeGateWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*RevokeGateResponse, error)

	RevokeGateWithResponse(ctx context.Context, body RevokeGateJSONRequestBody, reqEditors ...RequestEditorFn) (*RevokeGateResponse, error)

	// InitExecutionWithBodyWithResponse request with any body
	InitExecutionWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*InitExecutionResponse, error)

	InitExecutionWithResponse(ctx context.Context, body InitExecutionJSONRequestBody, reqEditors ...RequestEditorFn) (*InitExecutionResponse, error)

	// AppendLogsWithBodyWithResponse request with any body
	AppendLogsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AppendLogsResponse, error)

	AppendLogsWithResponse(ctx context.Context, body AppendLogsJSONRequestBody, reqEditors ...RequestEditorFn) (*AppendLogsResponse, error)

	// ReportPhaseWithBodyWithResponse request with any body
	ReportPhaseWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ReportPhaseResponse, error)

	ReportPhaseWithResponse(ctx context.Context, body ReportPhaseJSONRequestBody, reqEditors ...RequestEditorFn) (*ReportPhaseResponse, error)

	// GetPRWithResponse request
	GetPRWithResponse(ctx context.Context, n int, reqEditors ...RequestEditorFn) (*GetPRResponse, error)

	// UpdateStackWithBodyWithResponse request with any body
	UpdateStackWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateStackResponse, error)

	UpdateStackWithResponse(ctx context.Context, body UpdateStackJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateStackResponse, error)
}

type CodedError struct {
	// Code e.g. GATE-001, GATE-002, GATE-003, SRV-001
	Code    string `json:"code"`
	Message string `json:"message"`
}

type Counts = events.Counts

type Edge = events.Edge

type ExecutionDetail struct {
	// CheckRunID A database nullable int64, serialized raw (historical accident, preserved for wire compatibility).
	CheckRunID     NullInt64 `json:"CheckRunID"`
	CreatedAt      time.Time `json:"CreatedAt"`
	Environment    string    `json:"Environment"`
	ID             string    `json:"ID"`
	LogURL         string    `json:"LogURL"`
	PR             int       `json:"PR"`
	Phase          string    `json:"Phase"`
	Repo           string    `json:"Repo"`
	ReportMarkdown string    `json:"ReportMarkdown"`
	Rev            int       `json:"Rev"`
	SHA            string    `json:"SHA"`

	// Status Execution-level status (in_progress/success/failure).
	Status        string             `json:"Status"`
	StatusContext string             `json:"StatusContext"`
	SupersededBy  string             `json:"SupersededBy"`
	Gates         []StoredGateTarget `json:"gates"`

	// Graph The changed subgraph for one execution.
	Graph Graph `json:"graph"`

	// VerifyExecutionId Latest verify execution for the same (pr, environment), "" when none. Additive (2026-07) — snake_case unlike its legacy siblings.
	VerifyExecutionId string `json:"verify_execution_id"`
}

type ExecutionSummary struct {
	// Context The commit-status context the run drives (e.g. plan/<env>, apply/<env>, verify/<env>).
	Context     string    `json:"context"`
	CreatedAt   time.Time `json:"created_at"`
	Environment string    `json:"environment"`
	Id          string    `json:"id"`
	LogUrl      string    `json:"log_url"`

	// Phase Current lifecycle phase ("" before the first phase event).
	Phase string `json:"phase"`
	Pr    int    `json:"pr"`
	Repo  string `json:"repo"`
	Sha   string `json:"sha"`

	// Status Execution-level status (in_progress/success/failure).
	Status string `json:"status"`

	// SupersededBy Id of the execution that superseded this one ("" when live).
	SupersededBy string `json:"superseded_by"`
}

type Finalize = events.Finalize

type FinalizeExecutionJSONRequestBody = Finalize

type FinalizeExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type GateCheck = events.GateCheck

type GateCheckOK struct {
	// Requester Leased requester SA the apply impersonates; empty for a clean/no-gate pass.
	Requester string `json:"requester"`
}

type GateRevoke = events.GateRevoke

type GateTarget = events.GateTarget

type GetExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *ExecutionDetail
}

type GetPRResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *PRView
}

type Graph = events.Graph

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type Init = events.Init

type InitExecutionJSONRequestBody = Init

type InitExecutionResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type ListApprovalsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]PendingApproval
}

type ListClaimsJSONRequestBody = ClaimsListRequest

type ListClaimsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]Claim
}

type ListExecutionsParams struct {
	// Pr Only executions for this pull request.
	Pr    *int `form:"pr,omitempty" json:"pr,omitempty"`
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}

type ListExecutionsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *[]ExecutionSummary
}

type LogChunk = events.LogChunk

type MiddlewareFunc func(http.Handler) http.Handler

type NullInt64 struct {
	Int64 int64 `json:"Int64"`
	Valid bool  `json:"Valid"`
}

type PRMergeState struct {
	// Blocker Short human-readable blocker reason ("" when not blocked).
	Blocker string `json:"blocker"`

	// CheckConclusion GitHub check conclusion vocabulary; "" means still in progress.
	CheckConclusion string `json:"check_conclusion"`

	// Environment This serve's tier (empty when the tier has none configured).
	Environment  string `json:"environment"`
	MergeBlocked bool   `json:"merge_blocked"`

	// RequiredCheck The check name that gates merge (e.g. apply-lock/<env> or terraform/<env>).
	RequiredCheck string `json:"required_check"`
}

type PRMeta struct {
	AuthorLogin string `json:"author_login"`
	AutoMerge   bool   `json:"auto_merge"`
	Body        string `json:"body"`
	HeadRef     string `json:"head_ref"`
	Title       string `json:"title"`
	Url         string `json:"url"`
}

type PRView struct {
	// Merge A PR's merge-readiness on this serve's tier.
	Merge PRMergeState `json:"merge"`

	// Meta PR-level identity as last reported by the GitHub webhook (title, author, branch, automerge).
	Meta *PRMeta `json:"meta,omitempty"`
	Pr   int     `json:"pr"`

	// Repo Repo of the PR's latest execution ("" when none).
	Repo string `json:"repo"`
}

type PendingApproval struct {
	Class       string `json:"class"`
	Environment string `json:"environment"`

	// GrantName The approval-backend grant resource name ("" until a grant exists).
	GrantName string `json:"grant_name"`
	Pr        int    `json:"pr"`

	// Repo Repo of the PR's latest execution in this environment ("" when none).
	Repo string `json:"repo"`

	// Requester Leased requester SA for this grant.
	Requester string `json:"requester"`

	// State Backend grant state (e.g. AWAITING, ACTIVATING, DENIED, REVOKED).
	State  string `json:"state"`
	Target string `json:"target"`
}

type Phase = events.Phase

type PhaseEvent = events.PhaseEvent

type ReleaseClaimsJSONRequestBody = ClaimsReleaseRequest

type ReleaseClaimsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type ReportPhaseJSONRequestBody = PhaseEvent

type ReportPhaseResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type RequestEditorFn func(ctx context.Context, req *http.Request) error

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type RevokeGateJSONRequestBody = GateRevoke

type RevokeGateResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type ServeMux interface {
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
	http.Handler
}

type ServerInterface interface {
	// List gate targets awaiting human action, across all PRs
	// (GET /api/approvals)
	ListApprovals(w http.ResponseWriter, r *http.Request)
	// List the apply-lock claims for an environment
	// (POST /api/claims/list)
	ListClaims(w http.ResponseWriter, r *http.Request)
	// Admin-release one stack's claim or all of a PR's claims
	// (POST /api/claims/release)
	ReleaseClaims(w http.ResponseWriter, r *http.Request)
	// Read one execution's full state
	// (GET /api/execution/{id})
	GetExecution(w http.ResponseWriter, r *http.Request, id string)
	// List executions, newest first
	// (GET /api/executions)
	ListExecutions(w http.ResponseWriter, r *http.Request, params ListExecutionsParams)
	// Record the terminal plan state
	// (POST /api/finalize)
	FinalizeExecution(w http.ResponseWriter, r *http.Request)
	// Apply-time, fail-closed gate pre-check
	// (POST /api/gate/check)
	CheckGate(w http.ResponseWriter, r *http.Request)
	// Revoke the grants requested for (pr, environment)
	// (POST /api/gate/revoke)
	RevokeGate(w http.ResponseWriter, r *http.Request)
	// Register an execution and its changed subgraph
	// (POST /api/init)
	InitExecution(w http.ResponseWriter, r *http.Request)
	// Ingest a per-stack output chunk
	// (POST /api/logs)
	AppendLogs(w http.ResponseWriter, r *http.Request)
	// Narrate a lifecycle phase transition
	// (POST /api/phase)
	ReportPhase(w http.ResponseWriter, r *http.Request)
	// Read a pull request's identity and per-tier merge state
	// (GET /api/pr/{n})
	GetPR(w http.ResponseWriter, r *http.Request, n int)
	// Tick a single stack's status
	// (POST /api/update)
	UpdateStack(w http.ResponseWriter, r *http.Request)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StackState = events.StackState

type Status = events.Status

type StdHTTPServerOptions struct {
	BaseURL          string
	BaseRouter       ServeMux
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type StoredGateTarget struct {
	Class string `json:"Class"`

	// GrantName The approval-backend grant resource name (may be empty).
	GrantName string `json:"GrantName"`

	// Requester Leased requester SA for this grant.
	Requester string `json:"Requester"`

	// State Backend grant state (e.g. REQUESTED, ACTIVE, DENIED, REVOKED).
	State  string `json:"State"`
	Target string `json:"Target"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type Update = events.Update

type UpdateStackJSONRequestBody = Update

type UpdateStackResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}