Design 47 H1: seat definitions and generated packages (checker gone, callers API gone, Composed removed) #201
@@ -62,46 +62,9 @@
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "groups",
|
||||
"description": "Every delivery group: its members in merge order, its check and its state, derived from its members, and the acts the gate said it owes the forge for it, each with its id and its recorded outcome (design 47 *What the gate owes the forge*). With a group, that group alone, and none for a group it does not know: the forge bridge reads a group's members and catches up on what it owes from here, never from the gate's state.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"all": {
|
||||
"description": "\"true\": the groups that ended too",
|
||||
"enum": [
|
||||
"true",
|
||||
"false"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "one group's id: that group alone, ended or not"
|
||||
}
|
||||
}
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"groups": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Group"
|
||||
}
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it could not answer at all; a group it does not know is answered with no groups, never an error"
|
||||
}
|
||||
}
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "source",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the group that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the merge call that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -114,14 +77,14 @@
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved the source revision last; absent before the first"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "the source revision's number on the bus; 0 before the first"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved the source revision last; absent before the first"
|
||||
},
|
||||
"repositories": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -229,68 +192,11 @@
|
||||
"$ref": "#/defs/Owed"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pinned",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "freed",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "heads-replaced",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a candidate's heads replaced or its pull request closed: its graphs mean nothing any more",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string",
|
||||
"description": "the candidate's heads, 12 hex digits, as its revisions are keyed"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the member whose head moved or which closed"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "its pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its new head; absent when it closed",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"closed": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request closed"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"repository",
|
||||
"number"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "record-opened",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a delivery record opened: its merge was taken in, and the watchman times it against 24 hours",
|
||||
"description": "a delivery record opened for one source revision of a merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
@@ -298,27 +204,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the repository, <owner>/<name>"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "for a forge-made record, the pull request's number"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the merge commit"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the branch the merge moved"
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
@@ -328,9 +226,13 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
"subject": "record-opened.<call>"
|
||||
},
|
||||
{
|
||||
"name": "record-ended",
|
||||
@@ -344,11 +246,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"away": {
|
||||
"type": "array",
|
||||
@@ -379,7 +289,10 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
@@ -403,10 +316,10 @@
|
||||
},
|
||||
{
|
||||
"name": "source-moved",
|
||||
"subject": "source-moved.<branch>",
|
||||
"subject": "source-moved.<branch>.<source>",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a new source revision of a watched branch (design 47 *The verbs*)",
|
||||
"description": "a source revision of a watched branch, named once per merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer"
|
||||
@@ -414,22 +327,51 @@
|
||||
"branch": {
|
||||
"type": "string"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer"
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision, numbered by the gate alone"
|
||||
},
|
||||
"group": {
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it, when one did"
|
||||
"description": "the merge call that moved it"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
"start": {
|
||||
"type": "boolean",
|
||||
"description": "true only for a branch's first revision (design 47 H \u00a7768)"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"description": "the repositories it moved",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"commit"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"v",
|
||||
"branch",
|
||||
"revision"
|
||||
"source",
|
||||
"call",
|
||||
"start",
|
||||
"heads"
|
||||
]
|
||||
},
|
||||
"keep": {
|
||||
"max-age-days": 30,
|
||||
"max-mib": 64
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -477,65 +419,6 @@
|
||||
"why"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "approval-carried",
|
||||
"subject": "approval-carried.<repository>.<pull>",
|
||||
"keep": {
|
||||
"max-age-days": 90
|
||||
},
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "an Approve given before G, carried as that pull request's approval step: said at G's switch for each merges key the old bridge had not performed (design 47 G 542)",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number",
|
||||
"minimum": 1
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "the head the Approve named"
|
||||
},
|
||||
"approver": {
|
||||
"type": "string",
|
||||
"description": "who approved: the operator"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"pull",
|
||||
"commit",
|
||||
"approver",
|
||||
"at"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pins-stated",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "the gate states every pin it holds once its pinned events are said, so an indexer whose state pins was made later hears them all; kept as pinned is, on the seat's family (design 47 G 579, 652)",
|
||||
"properties": {
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"at"
|
||||
]
|
||||
}
|
||||
}
|
||||
],
|
||||
"states": [
|
||||
@@ -552,20 +435,25 @@
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the merged head, a full commit"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the branch's source revision, one above its newest"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved it; a call the newest revision already carries writes nothing (design 47 H \u00a7737, H-A-33)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"source",
|
||||
"call",
|
||||
"heads"
|
||||
],
|
||||
"description": "every repository's merged head; its revision is the mesh's source revision"
|
||||
@@ -576,140 +464,6 @@
|
||||
"description": "the mesh's source revision",
|
||||
"history": 64
|
||||
},
|
||||
{
|
||||
"name": "merges",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<group>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask key"
|
||||
},
|
||||
"approved": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "<repository>@<number> to the approved head"
|
||||
},
|
||||
"pulls": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "merging, merged or refused"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string"
|
||||
},
|
||||
"words": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"ask",
|
||||
"pulls"
|
||||
],
|
||||
"description": "one group's merge and how far each pull request is"
|
||||
},
|
||||
"description": "a group's merge"
|
||||
}
|
||||
],
|
||||
"description": "the merges",
|
||||
"history": 10
|
||||
},
|
||||
{
|
||||
"name": "asks",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "merge.<group>.<heads>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "<owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the full commit"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head"
|
||||
]
|
||||
}
|
||||
},
|
||||
"ask": {
|
||||
"description": "the operator-channel ask as raised"
|
||||
},
|
||||
"asking": {
|
||||
"type": "integer",
|
||||
"description": "the number of times it was asked"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"ask"
|
||||
]
|
||||
},
|
||||
"description": "the ask of the operator for one group at one set of heads"
|
||||
}
|
||||
],
|
||||
"description": "the asks of the operator for a merge",
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "owed",
|
||||
"template": "state",
|
||||
@@ -755,77 +509,36 @@
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "turns",
|
||||
"name": "heads",
|
||||
"template": "state",
|
||||
"history": 1,
|
||||
"description": "each head the forge bridge's head-moved said that source.<branch> does not name for that repository; deleted when source.<branch> names it (design 47 H \u00a7740)",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<repository>",
|
||||
"key": "<repository>.<branch>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the head head-moved said",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"waiting": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string"
|
||||
},
|
||||
"approved": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"waits-for": {
|
||||
"type": "string"
|
||||
},
|
||||
"waits-since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"step": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"approved",
|
||||
"since"
|
||||
]
|
||||
}
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when it was first heard"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"waiting"
|
||||
"head",
|
||||
"since"
|
||||
],
|
||||
"description": "the merges of a repository in the order they wait for their turn"
|
||||
"description": "an untaken head"
|
||||
},
|
||||
"description": "the merges waiting on a repository"
|
||||
"description": "one repository on one watched branch"
|
||||
}
|
||||
],
|
||||
"description": "which merge waits for which",
|
||||
"history": 5
|
||||
]
|
||||
}
|
||||
],
|
||||
"defs": {
|
||||
@@ -913,122 +626,6 @@
|
||||
"head"
|
||||
]
|
||||
},
|
||||
"Act": {
|
||||
"type": "object",
|
||||
"description": "an act the gate said for a group, with its recorded outcome once the forge bridge said one",
|
||||
"properties": {
|
||||
"owed": {
|
||||
"$ref": "#/defs/Owed"
|
||||
},
|
||||
"outcome": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"performed",
|
||||
"refused",
|
||||
"could not be performed",
|
||||
"undecodable",
|
||||
"dropped"
|
||||
],
|
||||
"description": "the outcome the forge bridge said as owed.ended and the gate recorded; absent while unanswered"
|
||||
},
|
||||
"words": {
|
||||
"type": "string",
|
||||
"description": "the forge's own words for a refusal, the error for an act that could not be performed, why one is undecodable or dropped"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when the outcome was recorded"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"owed"
|
||||
]
|
||||
},
|
||||
"Member": {
|
||||
"type": "object",
|
||||
"description": "one member of a group: a pull request",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery id"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository, <owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its head",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"base": {
|
||||
"type": "string",
|
||||
"description": "the branch it merges into"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery state"
|
||||
},
|
||||
"open": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request is open: not merged, closed or final"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
},
|
||||
"Group": {
|
||||
"type": "object",
|
||||
"description": "one delivery group: its members, its derived state and the acts the gate said for it",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the group's id, its branch"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "its state, derived from its members"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why it is in that state"
|
||||
},
|
||||
"check": {
|
||||
"type": "string",
|
||||
"description": "the group's check: its verdict, or asked as <id>"
|
||||
},
|
||||
"members": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Member"
|
||||
},
|
||||
"description": "its members in merge order"
|
||||
},
|
||||
"acts": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Act"
|
||||
},
|
||||
"description": "the acts the gate said for it, each with its id and its recorded outcome; an id said and not answered is the forge bridge's to perform"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"state",
|
||||
"members",
|
||||
"acts"
|
||||
]
|
||||
},
|
||||
"Fill": {
|
||||
"type": "object",
|
||||
"description": "the delivery records' ledger's fill against its cap",
|
||||
@@ -1060,104 +657,6 @@
|
||||
"cap"
|
||||
]
|
||||
},
|
||||
"Pins": {
|
||||
"type": "object",
|
||||
"description": "the graph revisions a delivery record starts or stops pointing at",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
"description": "the record's id"
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the record's milestone"
|
||||
},
|
||||
"catalog": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"description": "one catalog graph revision, named by its watched branch and its number on the seat mesh-catalog (revisions are numbered per branch)",
|
||||
"properties": {
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch the revision belongs to"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "its number on that branch"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"branch",
|
||||
"revision"
|
||||
]
|
||||
},
|
||||
"description": "catalog graph revisions, by watched branch and number on the seat mesh-catalog"
|
||||
},
|
||||
"assignment": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer"
|
||||
},
|
||||
"description": "assignment graph revisions, by their number on the seat mesh-wants"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on freed: the record ended past its retention, or was removed by hand"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
]
|
||||
},
|
||||
"Ask": {
|
||||
"type": "object",
|
||||
"description": "the one Approve ask of a milestone (ADR 0493 \u00a79), said apart from each delivery's transition",
|
||||
"properties": {
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the milestone"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask's id"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "its delivery group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the head asked"
|
||||
},
|
||||
"answer": {
|
||||
"type": "string",
|
||||
"description": "on answered: approve or decline"
|
||||
},
|
||||
"by": {
|
||||
"type": "string",
|
||||
"description": "on answered: who answered"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on withdrawn: why, such as a new head of a member"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"milestone",
|
||||
"ask",
|
||||
"group"
|
||||
]
|
||||
},
|
||||
"SourceHead": {
|
||||
"type": "object",
|
||||
"description": "one repository of the source revision: its trunk branch and that trunk's head",
|
||||
|
||||
@@ -62,46 +62,9 @@
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "groups",
|
||||
"description": "Every delivery group: its members in merge order, its check and its state, derived from its members, and the acts the gate said it owes the forge for it, each with its id and its recorded outcome (design 47 *What the gate owes the forge*). With a group, that group alone, and none for a group it does not know: the forge bridge reads a group's members and catches up on what it owes from here, never from the gate's state.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"all": {
|
||||
"description": "\"true\": the groups that ended too",
|
||||
"enum": [
|
||||
"true",
|
||||
"false"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "one group's id: that group alone, ended or not"
|
||||
}
|
||||
}
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"groups": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Group"
|
||||
}
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it could not answer at all; a group it does not know is answered with no groups, never an error"
|
||||
}
|
||||
}
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "source",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the group that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the merge call that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -114,14 +77,14 @@
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved the source revision last; absent before the first"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "the source revision's number on the bus; 0 before the first"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved the source revision last; absent before the first"
|
||||
},
|
||||
"repositories": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -229,68 +192,11 @@
|
||||
"$ref": "#/defs/Owed"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pinned",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "freed",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "heads-replaced",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a candidate's heads replaced or its pull request closed: its graphs mean nothing any more",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string",
|
||||
"description": "the candidate's heads, 12 hex digits, as its revisions are keyed"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the member whose head moved or which closed"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "its pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its new head; absent when it closed",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"closed": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request closed"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"repository",
|
||||
"number"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "record-opened",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a delivery record opened: its merge was taken in, and the watchman times it against 24 hours",
|
||||
"description": "a delivery record opened for one source revision of a merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
@@ -298,27 +204,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the repository, <owner>/<name>"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "for a forge-made record, the pull request's number"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the merge commit"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the branch the merge moved"
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
@@ -328,9 +226,13 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
"subject": "record-opened.<call>"
|
||||
},
|
||||
{
|
||||
"name": "record-ended",
|
||||
@@ -344,11 +246,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"away": {
|
||||
"type": "array",
|
||||
@@ -379,7 +289,10 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
@@ -403,10 +316,10 @@
|
||||
},
|
||||
{
|
||||
"name": "source-moved",
|
||||
"subject": "source-moved.<branch>",
|
||||
"subject": "source-moved.<branch>.<source>",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a new source revision of a watched branch (design 47 *The verbs*)",
|
||||
"description": "a source revision of a watched branch, named once per merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer"
|
||||
@@ -414,22 +327,51 @@
|
||||
"branch": {
|
||||
"type": "string"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer"
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision, numbered by the gate alone"
|
||||
},
|
||||
"group": {
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it, when one did"
|
||||
"description": "the merge call that moved it"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
"start": {
|
||||
"type": "boolean",
|
||||
"description": "true only for a branch's first revision (design 47 H \u00a7768)"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"description": "the repositories it moved",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"commit"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"v",
|
||||
"branch",
|
||||
"revision"
|
||||
"source",
|
||||
"call",
|
||||
"start",
|
||||
"heads"
|
||||
]
|
||||
},
|
||||
"keep": {
|
||||
"max-age-days": 30,
|
||||
"max-mib": 64
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -477,65 +419,6 @@
|
||||
"why"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "approval-carried",
|
||||
"subject": "approval-carried.<repository>.<pull>",
|
||||
"keep": {
|
||||
"max-age-days": 90
|
||||
},
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "an Approve given before G, carried as that pull request's approval step: said at G's switch for each merges key the old bridge had not performed (design 47 G 542)",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number",
|
||||
"minimum": 1
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "the head the Approve named"
|
||||
},
|
||||
"approver": {
|
||||
"type": "string",
|
||||
"description": "who approved: the operator"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"pull",
|
||||
"commit",
|
||||
"approver",
|
||||
"at"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pins-stated",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "the gate states every pin it holds once its pinned events are said, so an indexer whose state pins was made later hears them all; kept as pinned is, on the seat's family (design 47 G 579, 652)",
|
||||
"properties": {
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"at"
|
||||
]
|
||||
}
|
||||
}
|
||||
],
|
||||
"states": [
|
||||
@@ -552,20 +435,25 @@
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the merged head, a full commit"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the branch's source revision, one above its newest"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved it; a call the newest revision already carries writes nothing (design 47 H \u00a7737, H-A-33)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"source",
|
||||
"call",
|
||||
"heads"
|
||||
],
|
||||
"description": "every repository's merged head; its revision is the mesh's source revision"
|
||||
@@ -576,140 +464,6 @@
|
||||
"description": "the mesh's source revision",
|
||||
"history": 64
|
||||
},
|
||||
{
|
||||
"name": "merges",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<group>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask key"
|
||||
},
|
||||
"approved": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "<repository>@<number> to the approved head"
|
||||
},
|
||||
"pulls": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "merging, merged or refused"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string"
|
||||
},
|
||||
"words": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"ask",
|
||||
"pulls"
|
||||
],
|
||||
"description": "one group's merge and how far each pull request is"
|
||||
},
|
||||
"description": "a group's merge"
|
||||
}
|
||||
],
|
||||
"description": "the merges",
|
||||
"history": 10
|
||||
},
|
||||
{
|
||||
"name": "asks",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "merge.<group>.<heads>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "<owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the full commit"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head"
|
||||
]
|
||||
}
|
||||
},
|
||||
"ask": {
|
||||
"description": "the operator-channel ask as raised"
|
||||
},
|
||||
"asking": {
|
||||
"type": "integer",
|
||||
"description": "the number of times it was asked"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"ask"
|
||||
]
|
||||
},
|
||||
"description": "the ask of the operator for one group at one set of heads"
|
||||
}
|
||||
],
|
||||
"description": "the asks of the operator for a merge",
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "owed",
|
||||
"template": "state",
|
||||
@@ -755,77 +509,36 @@
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "turns",
|
||||
"name": "heads",
|
||||
"template": "state",
|
||||
"history": 1,
|
||||
"description": "each head the forge bridge's head-moved said that source.<branch> does not name for that repository; deleted when source.<branch> names it (design 47 H \u00a7740)",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<repository>",
|
||||
"key": "<repository>.<branch>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the head head-moved said",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"waiting": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string"
|
||||
},
|
||||
"approved": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"waits-for": {
|
||||
"type": "string"
|
||||
},
|
||||
"waits-since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"step": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"approved",
|
||||
"since"
|
||||
]
|
||||
}
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when it was first heard"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"waiting"
|
||||
"head",
|
||||
"since"
|
||||
],
|
||||
"description": "the merges of a repository in the order they wait for their turn"
|
||||
"description": "an untaken head"
|
||||
},
|
||||
"description": "the merges waiting on a repository"
|
||||
"description": "one repository on one watched branch"
|
||||
}
|
||||
],
|
||||
"description": "which merge waits for which",
|
||||
"history": 5
|
||||
]
|
||||
}
|
||||
],
|
||||
"defs": {
|
||||
@@ -913,122 +626,6 @@
|
||||
"head"
|
||||
]
|
||||
},
|
||||
"Act": {
|
||||
"type": "object",
|
||||
"description": "an act the gate said for a group, with its recorded outcome once the forge bridge said one",
|
||||
"properties": {
|
||||
"owed": {
|
||||
"$ref": "#/defs/Owed"
|
||||
},
|
||||
"outcome": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"performed",
|
||||
"refused",
|
||||
"could not be performed",
|
||||
"undecodable",
|
||||
"dropped"
|
||||
],
|
||||
"description": "the outcome the forge bridge said as owed.ended and the gate recorded; absent while unanswered"
|
||||
},
|
||||
"words": {
|
||||
"type": "string",
|
||||
"description": "the forge's own words for a refusal, the error for an act that could not be performed, why one is undecodable or dropped"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when the outcome was recorded"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"owed"
|
||||
]
|
||||
},
|
||||
"Member": {
|
||||
"type": "object",
|
||||
"description": "one member of a group: a pull request",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery id"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository, <owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its head",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"base": {
|
||||
"type": "string",
|
||||
"description": "the branch it merges into"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery state"
|
||||
},
|
||||
"open": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request is open: not merged, closed or final"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
},
|
||||
"Group": {
|
||||
"type": "object",
|
||||
"description": "one delivery group: its members, its derived state and the acts the gate said for it",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the group's id, its branch"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "its state, derived from its members"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why it is in that state"
|
||||
},
|
||||
"check": {
|
||||
"type": "string",
|
||||
"description": "the group's check: its verdict, or asked as <id>"
|
||||
},
|
||||
"members": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Member"
|
||||
},
|
||||
"description": "its members in merge order"
|
||||
},
|
||||
"acts": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Act"
|
||||
},
|
||||
"description": "the acts the gate said for it, each with its id and its recorded outcome; an id said and not answered is the forge bridge's to perform"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"state",
|
||||
"members",
|
||||
"acts"
|
||||
]
|
||||
},
|
||||
"Fill": {
|
||||
"type": "object",
|
||||
"description": "the delivery records' ledger's fill against its cap",
|
||||
@@ -1060,104 +657,6 @@
|
||||
"cap"
|
||||
]
|
||||
},
|
||||
"Pins": {
|
||||
"type": "object",
|
||||
"description": "the graph revisions a delivery record starts or stops pointing at",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
"description": "the record's id"
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the record's milestone"
|
||||
},
|
||||
"catalog": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"description": "one catalog graph revision, named by its watched branch and its number on the seat mesh-catalog (revisions are numbered per branch)",
|
||||
"properties": {
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch the revision belongs to"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "its number on that branch"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"branch",
|
||||
"revision"
|
||||
]
|
||||
},
|
||||
"description": "catalog graph revisions, by watched branch and number on the seat mesh-catalog"
|
||||
},
|
||||
"assignment": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer"
|
||||
},
|
||||
"description": "assignment graph revisions, by their number on the seat mesh-wants"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on freed: the record ended past its retention, or was removed by hand"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
]
|
||||
},
|
||||
"Ask": {
|
||||
"type": "object",
|
||||
"description": "the one Approve ask of a milestone (ADR 0493 \u00a79), said apart from each delivery's transition",
|
||||
"properties": {
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the milestone"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask's id"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "its delivery group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the head asked"
|
||||
},
|
||||
"answer": {
|
||||
"type": "string",
|
||||
"description": "on answered: approve or decline"
|
||||
},
|
||||
"by": {
|
||||
"type": "string",
|
||||
"description": "on answered: who answered"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on withdrawn: why, such as a new head of a member"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"milestone",
|
||||
"ask",
|
||||
"group"
|
||||
]
|
||||
},
|
||||
"SourceHead": {
|
||||
"type": "object",
|
||||
"description": "one repository of the source revision: its trunk branch and that trunk's head",
|
||||
|
||||
Vendored
+1
@@ -18,6 +18,7 @@ mesh-delivery 5bf848144283055a1ef37441eeda0e439fb6ad7e contracts/seats/mesh-cat
|
||||
mesh-delivery 0259d77d115c95dde492ac2360e9a518d992adb0 modules/mesh-delivery-contracts/seats/mesh-catalog and git, taken again and added (milestone 47/G lead answer A-387)
|
||||
mesh-delivery f006ab50bcc2e5759627f20fa7e5a9c62501032d modules/mesh-delivery-contracts/seats/git, mesh-delivery and mesh-catalog, taken again as seat.json.captured (milestone 47/H1, branch feat/47-H1-contracts-indexer-bridge; the checker seat is dropped)
|
||||
mesh-delivery f8bbde9627255fe37bd6603a40fcce14fb61d97b modules/mesh-delivery-contracts/seats/git/seat.json, taken again as seat.json.captured (milestone 47/H1, C2)
|
||||
mesh-delivery 6e027de59773affe80d7bf45cf49d81292893ff1 modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json, taken again as seat.json.captured (milestone 47/H1, C3)
|
||||
mesh-host cdcba9ca73755854d21e4e657d7e46c32b9b5265 internal/apply/placement_guard.go
|
||||
|
||||
The two seat copies are put back the same way (git show <commit>:<file> > <file>.captured, the path kept). To move the others, from this repository's go/ directory, with the two repositories checked out beside mesh-sdk:
|
||||
|
||||
+104
-605
@@ -62,46 +62,9 @@
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "groups",
|
||||
"description": "Every delivery group: its members in merge order, its check and its state, derived from its members, and the acts the gate said it owes the forge for it, each with its id and its recorded outcome (design 47 *What the gate owes the forge*). With a group, that group alone, and none for a group it does not know: the forge bridge reads a group's members and catches up on what it owes from here, never from the gate's state.",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"all": {
|
||||
"description": "\"true\": the groups that ended too",
|
||||
"enum": [
|
||||
"true",
|
||||
"false"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "one group's id: that group alone, ended or not"
|
||||
}
|
||||
}
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"groups": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Group"
|
||||
}
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it could not answer at all; a group it does not know is answered with no groups, never an error"
|
||||
}
|
||||
}
|
||||
},
|
||||
"class": "read"
|
||||
},
|
||||
{
|
||||
"name": "source",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the group that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"description": "One watched branch's source revision (design 47 *Watched branches and the catalog graph per branch*: source.<branch> in place of source.main): The source revision the gate holds: every repository it names, its trunk branch and that trunk's head as the gate merged or seeded it, and the merge call that moved it last. Read, never written: the node-engines read it to call a reverted build's catch-up tool once per repository, never the gate's state (design 47). Given no branch it answers branches alone, the branch of each source key the gate keeps; given a branch, that branch's source revision (design 47 G section 690).",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -114,14 +77,14 @@
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved the source revision last; absent before the first"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "the source revision's number on the bus; 0 before the first"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved the source revision last; absent before the first"
|
||||
},
|
||||
"repositories": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
@@ -229,68 +192,11 @@
|
||||
"$ref": "#/defs/Owed"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pinned",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "freed",
|
||||
"body": {
|
||||
"$ref": "#/defs/Pins"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "heads-replaced",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a candidate's heads replaced or its pull request closed: its graphs mean nothing any more",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string",
|
||||
"description": "the candidate's heads, 12 hex digits, as its revisions are keyed"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the member whose head moved or which closed"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "its pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its new head; absent when it closed",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"closed": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request closed"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"repository",
|
||||
"number"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "record-opened",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a delivery record opened: its merge was taken in, and the watchman times it against 24 hours",
|
||||
"description": "a delivery record opened for one source revision of a merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
@@ -298,27 +204,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the repository, <owner>/<name>"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "for a forge-made record, the pull request's number"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the merge commit"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "for a forge-made record, the branch the merge moved"
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
@@ -328,9 +226,13 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
"subject": "record-opened.<call>"
|
||||
},
|
||||
{
|
||||
"name": "record-ended",
|
||||
@@ -344,11 +246,19 @@
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "its milestone"
|
||||
"description": "its milestone, <branch>.<source>"
|
||||
},
|
||||
"forge-made": {
|
||||
"type": "boolean",
|
||||
"description": "a merge made at the forge, with no Approve"
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call"
|
||||
},
|
||||
"away": {
|
||||
"type": "array",
|
||||
@@ -379,7 +289,10 @@
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
"milestone",
|
||||
"branch",
|
||||
"source",
|
||||
"call"
|
||||
]
|
||||
}
|
||||
},
|
||||
@@ -403,10 +316,10 @@
|
||||
},
|
||||
{
|
||||
"name": "source-moved",
|
||||
"subject": "source-moved.<branch>",
|
||||
"subject": "source-moved.<branch>.<source>",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "a new source revision of a watched branch (design 47 *The verbs*)",
|
||||
"description": "a source revision of a watched branch, named once per merge call (design 47 H \u00a7737)",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer"
|
||||
@@ -414,22 +327,51 @@
|
||||
"branch": {
|
||||
"type": "string"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer"
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the source revision, numbered by the gate alone"
|
||||
},
|
||||
"group": {
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it, when one did"
|
||||
"description": "the merge call that moved it"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
"start": {
|
||||
"type": "boolean",
|
||||
"description": "true only for a branch's first revision (design 47 H \u00a7768)"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"description": "the repositories it moved",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"commit"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"v",
|
||||
"branch",
|
||||
"revision"
|
||||
"source",
|
||||
"call",
|
||||
"start",
|
||||
"heads"
|
||||
]
|
||||
},
|
||||
"keep": {
|
||||
"max-age-days": 30,
|
||||
"max-mib": 64
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -477,65 +419,6 @@
|
||||
"why"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "approval-carried",
|
||||
"subject": "approval-carried.<repository>.<pull>",
|
||||
"keep": {
|
||||
"max-age-days": 90
|
||||
},
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "an Approve given before G, carried as that pull request's approval step: said at G's switch for each merges key the old bridge had not performed (design 47 G 542)",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository"
|
||||
},
|
||||
"pull": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number",
|
||||
"minimum": 1
|
||||
},
|
||||
"commit": {
|
||||
"type": "string",
|
||||
"description": "the head the Approve named"
|
||||
},
|
||||
"approver": {
|
||||
"type": "string",
|
||||
"description": "who approved: the operator"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"pull",
|
||||
"commit",
|
||||
"approver",
|
||||
"at"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "pins-stated",
|
||||
"body": {
|
||||
"type": "object",
|
||||
"description": "the gate states every pin it holds once its pinned events are said, so an indexer whose state pins was made later hears them all; kept as pinned is, on the seat's family (design 47 G 579, 652)",
|
||||
"properties": {
|
||||
"at": {
|
||||
"type": "string",
|
||||
"description": "when it was said, RFC 3339",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"at"
|
||||
]
|
||||
}
|
||||
}
|
||||
],
|
||||
"states": [
|
||||
@@ -552,20 +435,25 @@
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "the group that moved it"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the merged head, a full commit"
|
||||
},
|
||||
"source": {
|
||||
"type": "integer",
|
||||
"description": "the branch's source revision, one above its newest"
|
||||
},
|
||||
"call": {
|
||||
"type": "string",
|
||||
"description": "the merge call that moved it; a call the newest revision already carries writes nothing (design 47 H \u00a7737, H-A-33)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"source",
|
||||
"call",
|
||||
"heads"
|
||||
],
|
||||
"description": "every repository's merged head; its revision is the mesh's source revision"
|
||||
@@ -576,140 +464,6 @@
|
||||
"description": "the mesh's source revision",
|
||||
"history": 64
|
||||
},
|
||||
{
|
||||
"name": "merges",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<group>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask key"
|
||||
},
|
||||
"approved": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "<repository>@<number> to the approved head"
|
||||
},
|
||||
"pulls": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "merging, merged or refused"
|
||||
},
|
||||
"commit": {
|
||||
"type": "string"
|
||||
},
|
||||
"words": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"ask",
|
||||
"pulls"
|
||||
],
|
||||
"description": "one group's merge and how far each pull request is"
|
||||
},
|
||||
"description": "a group's merge"
|
||||
}
|
||||
],
|
||||
"description": "the merges",
|
||||
"history": 10
|
||||
},
|
||||
{
|
||||
"name": "asks",
|
||||
"template": "state",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "merge.<group>.<heads>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
},
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "<owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the full commit"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"number",
|
||||
"head"
|
||||
]
|
||||
}
|
||||
},
|
||||
"ask": {
|
||||
"description": "the operator-channel ask as raised"
|
||||
},
|
||||
"asking": {
|
||||
"type": "integer",
|
||||
"description": "the number of times it was asked"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"ask"
|
||||
]
|
||||
},
|
||||
"description": "the ask of the operator for one group at one set of heads"
|
||||
}
|
||||
],
|
||||
"description": "the asks of the operator for a merge",
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "owed",
|
||||
"template": "state",
|
||||
@@ -755,77 +509,36 @@
|
||||
"history": 5
|
||||
},
|
||||
{
|
||||
"name": "turns",
|
||||
"name": "heads",
|
||||
"template": "state",
|
||||
"history": 1,
|
||||
"description": "each head the forge bridge's head-moved said that source.<branch> does not name for that repository; deleted when source.<branch> names it (design 47 H \u00a7740)",
|
||||
"key-forms": [
|
||||
{
|
||||
"key": "<repository>",
|
||||
"key": "<repository>.<branch>",
|
||||
"value": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"v": {
|
||||
"type": "integer",
|
||||
"description": "the layout version"
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "the head head-moved said",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string"
|
||||
},
|
||||
"waiting": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"group": {
|
||||
"type": "string"
|
||||
},
|
||||
"heads": {
|
||||
"type": "string"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string"
|
||||
},
|
||||
"approved": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"waits-for": {
|
||||
"type": "string"
|
||||
},
|
||||
"waits-since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when (RFC 3339 time)"
|
||||
},
|
||||
"step": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"group",
|
||||
"heads",
|
||||
"approved",
|
||||
"since"
|
||||
]
|
||||
}
|
||||
"since": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when it was first heard"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"repository",
|
||||
"waiting"
|
||||
"head",
|
||||
"since"
|
||||
],
|
||||
"description": "the merges of a repository in the order they wait for their turn"
|
||||
"description": "an untaken head"
|
||||
},
|
||||
"description": "the merges waiting on a repository"
|
||||
"description": "one repository on one watched branch"
|
||||
}
|
||||
],
|
||||
"description": "which merge waits for which",
|
||||
"history": 5
|
||||
]
|
||||
}
|
||||
],
|
||||
"defs": {
|
||||
@@ -913,122 +626,6 @@
|
||||
"head"
|
||||
]
|
||||
},
|
||||
"Act": {
|
||||
"type": "object",
|
||||
"description": "an act the gate said for a group, with its recorded outcome once the forge bridge said one",
|
||||
"properties": {
|
||||
"owed": {
|
||||
"$ref": "#/defs/Owed"
|
||||
},
|
||||
"outcome": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"performed",
|
||||
"refused",
|
||||
"could not be performed",
|
||||
"undecodable",
|
||||
"dropped"
|
||||
],
|
||||
"description": "the outcome the forge bridge said as owed.ended and the gate recorded; absent while unanswered"
|
||||
},
|
||||
"words": {
|
||||
"type": "string",
|
||||
"description": "the forge's own words for a refusal, the error for an act that could not be performed, why one is undecodable or dropped"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when the outcome was recorded"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"owed"
|
||||
]
|
||||
},
|
||||
"Member": {
|
||||
"type": "object",
|
||||
"description": "one member of a group: a pull request",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery id"
|
||||
},
|
||||
"repository": {
|
||||
"type": "string",
|
||||
"description": "the repository, <owner>/<name>"
|
||||
},
|
||||
"number": {
|
||||
"type": "integer",
|
||||
"description": "the pull request's number"
|
||||
},
|
||||
"head": {
|
||||
"type": "string",
|
||||
"description": "its head",
|
||||
"pattern": "^[0-9a-f]{40}$"
|
||||
},
|
||||
"base": {
|
||||
"type": "string",
|
||||
"description": "the branch it merges into"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "the member's delivery state"
|
||||
},
|
||||
"open": {
|
||||
"type": "boolean",
|
||||
"description": "the pull request is open: not merged, closed or final"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"repository",
|
||||
"number",
|
||||
"head",
|
||||
"state"
|
||||
]
|
||||
},
|
||||
"Group": {
|
||||
"type": "object",
|
||||
"description": "one delivery group: its members, its derived state and the acts the gate said for it",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the group's id, its branch"
|
||||
},
|
||||
"state": {
|
||||
"type": "string",
|
||||
"description": "its state, derived from its members"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why it is in that state"
|
||||
},
|
||||
"check": {
|
||||
"type": "string",
|
||||
"description": "the group's check: its verdict, or asked as <id>"
|
||||
},
|
||||
"members": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Member"
|
||||
},
|
||||
"description": "its members in merge order"
|
||||
},
|
||||
"acts": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/defs/Act"
|
||||
},
|
||||
"description": "the acts the gate said for it, each with its id and its recorded outcome; an id said and not answered is the forge bridge's to perform"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"id",
|
||||
"state",
|
||||
"members",
|
||||
"acts"
|
||||
]
|
||||
},
|
||||
"Fill": {
|
||||
"type": "object",
|
||||
"description": "the delivery records' ledger's fill against its cap",
|
||||
@@ -1060,104 +657,6 @@
|
||||
"cap"
|
||||
]
|
||||
},
|
||||
"Pins": {
|
||||
"type": "object",
|
||||
"description": "the graph revisions a delivery record starts or stops pointing at",
|
||||
"properties": {
|
||||
"record": {
|
||||
"type": "string",
|
||||
"description": "the record's id"
|
||||
},
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the record's milestone"
|
||||
},
|
||||
"catalog": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"description": "one catalog graph revision, named by its watched branch and its number on the seat mesh-catalog (revisions are numbered per branch)",
|
||||
"properties": {
|
||||
"branch": {
|
||||
"type": "string",
|
||||
"description": "the watched branch the revision belongs to"
|
||||
},
|
||||
"revision": {
|
||||
"type": "integer",
|
||||
"description": "its number on that branch"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"branch",
|
||||
"revision"
|
||||
]
|
||||
},
|
||||
"description": "catalog graph revisions, by watched branch and number on the seat mesh-catalog"
|
||||
},
|
||||
"assignment": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer"
|
||||
},
|
||||
"description": "assignment graph revisions, by their number on the seat mesh-wants"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on freed: the record ended past its retention, or was removed by hand"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"record",
|
||||
"milestone"
|
||||
]
|
||||
},
|
||||
"Ask": {
|
||||
"type": "object",
|
||||
"description": "the one Approve ask of a milestone (ADR 0493 \u00a79), said apart from each delivery's transition",
|
||||
"properties": {
|
||||
"milestone": {
|
||||
"type": "string",
|
||||
"description": "the milestone"
|
||||
},
|
||||
"ask": {
|
||||
"type": "string",
|
||||
"description": "the ask's id"
|
||||
},
|
||||
"group": {
|
||||
"type": "string",
|
||||
"description": "its delivery group"
|
||||
},
|
||||
"heads": {
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": "repository to the head asked"
|
||||
},
|
||||
"answer": {
|
||||
"type": "string",
|
||||
"description": "on answered: approve or decline"
|
||||
},
|
||||
"by": {
|
||||
"type": "string",
|
||||
"description": "on answered: who answered"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "on withdrawn: why, such as a new head of a member"
|
||||
},
|
||||
"at": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"description": "when"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"milestone",
|
||||
"ask",
|
||||
"group"
|
||||
]
|
||||
},
|
||||
"SourceHead": {
|
||||
"type": "object",
|
||||
"description": "one repository of the source revision: its trunk branch and that trunk's head",
|
||||
|
||||
Reference in New Issue
Block a user