The only way to create or message a change_validation agent, the one long-lived agent for a change: a pull request, or a revision, which is a deployed commit named by a commit reference. A pull request's agent validates the policy's stages of scope pull_request; a revision's validates those of scope revision, at the commit itself. A stage.requested event asks it to validate one of the repository policy's stages, named by the workflow, at a head. The first one for a change creates its agent, stores the stage's request and policy on it and queues the event; the caller becomes the agent's principal for the rest of its life. Every caller, not only the first, must be able to do everything the agent does, since each event steers an agent acting with its principal's authority; a person must hold a role in the workspace. A later request is ordered against the same stage's stored request by event.occurred_at, and never against another stage's: an older one is superseded and changes nothing, the same time, head and base is a duplicate that is not queued twice, and a newer one replaces the stage's request and is queued. At the same time with another head or base, the later arrival replaces it, unless a request at that time already replaced that head and base, which is superseded. On a revision, a newer request for a stage runs that stage again, and its run replaces the earlier one as the stage's status. A command messages an existing pull request's agent. A pull_request.merged event says the pull request of an existing agent merged. When the policy read at the merge commit sets merge_mabl_branches, mabl merges the mabl branch the pull request's stages last ran on into master, as the caller and fast-forward only, so the caller must be able to merge branches (principal_too_narrow otherwise); a branch master moved past is reported diverged and left open, never forced. mabl records the merge and what became of the branch, which the status read gives as landed, and queues the event for the agent only when it tried to merge a branch. A pull request merges once: a later merged event for another merge commit is superseded, and one for the same commit a duplicate that merges nothing, except that a merge recorded without merging branches gives way to an event whose policy merges them. Events restart an agent a person stopped or one waiting on a question. POST /changeValidation/close turns a change's agent off, and POST /changeValidation/reset deletes it so the change's next stage request starts validation again. Branch on error_code in an error body: invalid_request (400), feature_disabled, principal_too_narrow and principal_gone (403), no_change_agent (404), change_agent_closed, too_many_stages and another_repository (409), and agent_stopping (503), which a client retries. A body that breaks the request schema is refused with a 400 that carries no error_code. A retry of any call is safe.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||