{ "lexicon": 1, "id": "dev.knotless.queue", "description": "A pull put in the merge queue of the branch it targets, taken out of it, or turned away by the runner that lands the queue.", "defs": { "main": { "type": "record", "description": "Kept in the account of whoever wrote it; for a private repository, in their repo inside the repository's space. Readers take the latest about a pull from the repository's owner or a collaborator, who may merge it, and from no one else. A pull is in the queue while that is `queued` and the pull is open, in the order of those records' keys. A runner the repository names takes queued pulls in that order, a few at a time, squashes each onto the branch as a commit of its own, runs the workflows that run on a pull into the branch once, at the last of them, and once those pass moves the branch there, marking each pull `merged` with a dev.knotless.state. One that does not apply, or that its checks find breaks the branch, it marks `ejected`.", "key": "tid", "record": { "type": "object", "required": ["repo", "subject", "state", "createdAt"], "properties": { "repo": { "type": "ref", "ref": "dev.knotless.defs#repoRef", "description": "The repository the pull is on." }, "subject": { "type": "string", "format": "at-uri", "description": "The dev.knotless.pull queued, taken out or turned away." }, "state": { "type": "string", "maxLength": 64, "knownValues": ["queued", "left", "ejected"], "description": "`queued` puts the pull at the back of the queue; `left` takes it out; `ejected` is the runner turning it away, saying why in `reason`." }, "reason": { "type": "string", "maxLength": 4096, "maxGraphemes": 1000, "description": "For `ejected`, why: the paths it conflicts in, or the checks that failed and where to read their logs." }, "commit": { "type": "string", "minLength": 40, "maxLength": 64, "description": "The hex object ID of the pull's head: for `queued`, the one queued; for `ejected`, the one turned away." }, "checks": { "type": "array", "maxLength": 64, "description": "For `ejected` by a batch that failed its checks, those that did not pass.", "items": { "type": "ref", "ref": "#failedCheck" } }, "createdAt": { "type": "string", "format": "datetime" } } } }, "failedCheck": { "type": "object", "description": "A run of the batch that did not pass, as the runner filed it.", "required": ["workflow"], "properties": { "workflow": { "type": "string", "maxLength": 256, "description": "The workflow's name, as its file in .knotless/workflows names it." }, "status": { "type": "string", "maxLength": 64, "knownValues": ["failure", "error", "cancelled"], "description": "How it ended, as dev.knotless.check's status says." }, "check": { "type": "string", "format": "at-uri", "description": "The dev.knotless.check record of the run, with its steps and log." } } } } }