S13 bootstrap copy of git: take the git seat as D5 defines it

The bootstrapped definition, its test copy and the captured contract file
are replaced by mesh-delivery's seats/git/seat.json at D5 (tags name their
commits, a holder says away), byte for byte.

Builds: design 47 H2 §796, §776; H-A-350 DMC-3
This commit is contained in:
2026-11-22 00:22:57 +01:00
parent 98ed28c1d1
commit e54151336e
4 changed files with 445 additions and 48 deletions
+148 -16
View File
@@ -5,7 +5,7 @@
"grain": "whole",
"domain": "Delivery",
"decision": "novox/hq ADR 0111",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 \u00a71, \u00a72). A failed read answers an error, never an empty answer.",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 §1, §2). A failed read answers an error, never an empty answer.",
"delivers": "git",
"verbs": [
{
@@ -48,6 +48,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what pull answers; error and error-kind alone when it fails"
@@ -96,6 +104,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what branch answers; error and error-kind alone when it fails"
@@ -126,6 +142,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what open-pulls answers; pulls always said, empty when none is open; error and error-kind beside an empty pulls when it fails",
@@ -171,9 +195,9 @@
"tags": {
"type": "array",
"items": {
"type": "string"
"$ref": "#/defs/Tag"
},
"description": "the tags of this page"
"description": "the tags of this page, each with the commit it names (design 47 H2 §796)"
},
"page": {
"type": "integer",
@@ -193,6 +217,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tags answers; error and error-kind alone when it fails"
@@ -201,7 +233,7 @@
},
{
"name": "trees",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part.",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part. A directory named in files or paths that the commit does not hold answers the error kind not-found (design 47 H2 §796).",
"input": {
"type": "object",
"properties": {
@@ -284,6 +316,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what trees answers; error and error-kind alone when it fails"
@@ -350,6 +390,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what file answers; error and error-kind alone when it fails"
@@ -410,6 +458,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what contains answers; error and error-kind alone when it fails"
@@ -464,6 +520,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what statuses answers; error and error-kind alone when it fails"
@@ -546,6 +610,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what status answers; error and error-kind alone when it fails"
@@ -607,6 +679,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what comment answers; error and error-kind alone when it fails"
@@ -668,6 +748,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what view answers; error and error-kind alone when it fails"
@@ -730,6 +818,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what note answers; error and error-kind alone when it fails"
@@ -738,7 +834,7 @@
},
{
"name": "merge-pull",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H \u00a7734, \u00a7735, \u00a7766; ADR 0682 \u00a71, \u00a72). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H §734, §735, §766; ADR 0682 §1, §2). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"input": {
"type": "object",
"properties": {
@@ -805,6 +901,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what merge-pull answers at the call's end; error and error-kind alone when it fails"
@@ -815,7 +919,7 @@
{
"name": "tag",
"class": "act",
"description": "Write the git tag of a released version, go/vMAJOR.MINOR.PATCH, at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"description": "Write the git tag of a released version, <directory>/vMAJOR.MINOR.PATCH for a Go package (design 47 H2 §796), at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"input": {
"type": "object",
"properties": {
@@ -856,6 +960,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tag answers; error and error-kind alone when it fails"
@@ -1259,7 +1371,7 @@
"name": "calls",
"template": "state",
"history": 1,
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H \u00a7766, H-A-47)",
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H §766, H-A-47)",
"key-forms": [
{
"key": "call.<call>",
@@ -1328,7 +1440,7 @@
"description": "its page on the forge"
}
},
"description": "one pull request as the forge holds it; never its description (ADR 0659 \u00a71)",
"description": "one pull request as the forge holds it; never its description (ADR 0659 §1)",
"required": [
"repository",
"number",
@@ -1361,7 +1473,7 @@
"description": "whether the forge's merging account may write the repository: false, its statuses and its merge are refused"
}
},
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 \u00a71): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 §1): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"required": [
"mergeable",
"protected",
@@ -1471,9 +1583,10 @@
"enum": [
"refused",
"not-found",
"failed"
"failed",
"away"
],
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed"
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed; away, a part the holder depends on (the forge, its store) is away, with part naming what did not answer and words: a caller reads it as a transport fault and calls again (design 47 H2 §776)"
},
"FailedStep": {
"type": "object",
@@ -1529,7 +1642,7 @@
},
"MemberOutcome": {
"type": "object",
"description": "one member of a merge call and where it stands (design 47 H \u00a7766, H-A-22)",
"description": "one member of a merge call and where it stands (design 47 H §766, H-A-22)",
"properties": {
"repository": {
"type": "string"
@@ -1564,7 +1677,7 @@
},
"Call": {
"type": "object",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H \u00a7766)",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H §766)",
"properties": {
"by": {
"type": "string",
@@ -1640,12 +1753,30 @@
"head",
"state"
]
},
"Tag": {
"type": "object",
"description": "a tag and the commit it names (design 47 H2 §796)",
"properties": {
"tag": {
"type": "string"
},
"commit": {
"type": "string",
"description": "the commit it names, its full 40-hex sha",
"pattern": "^[0-9a-f]{40}$"
}
},
"required": [
"tag",
"commit"
]
}
},
"bodies": {
"MergeCalled": {
"type": "object",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H \u00a7736, \u00a7767)",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H §736, §767)",
"properties": {
"call": {
"type": "string",
@@ -1702,7 +1833,7 @@
},
"refused": {
"type": "array",
"description": "one per member not merged after every member was judged (design 47 H \u00a7767)",
"description": "one per member not merged after every member was judged (design 47 H §767)",
"items": {
"type": "object",
"properties": {
@@ -1732,5 +1863,6 @@
"members"
]
}
}
},
"form": 2
}
+148 -16
View File
@@ -5,7 +5,7 @@
"grain": "whole",
"domain": "Delivery",
"decision": "novox/hq ADR 0111",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 \u00a71, \u00a72). A failed read answers an error, never an empty answer.",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 §1, §2). A failed read answers an error, never an empty answer.",
"delivers": "git",
"verbs": [
{
@@ -48,6 +48,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what pull answers; error and error-kind alone when it fails"
@@ -96,6 +104,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what branch answers; error and error-kind alone when it fails"
@@ -126,6 +142,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what open-pulls answers; pulls always said, empty when none is open; error and error-kind beside an empty pulls when it fails",
@@ -171,9 +195,9 @@
"tags": {
"type": "array",
"items": {
"type": "string"
"$ref": "#/defs/Tag"
},
"description": "the tags of this page"
"description": "the tags of this page, each with the commit it names (design 47 H2 §796)"
},
"page": {
"type": "integer",
@@ -193,6 +217,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tags answers; error and error-kind alone when it fails"
@@ -201,7 +233,7 @@
},
{
"name": "trees",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part.",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part. A directory named in files or paths that the commit does not hold answers the error kind not-found (design 47 H2 §796).",
"input": {
"type": "object",
"properties": {
@@ -284,6 +316,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what trees answers; error and error-kind alone when it fails"
@@ -350,6 +390,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what file answers; error and error-kind alone when it fails"
@@ -410,6 +458,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what contains answers; error and error-kind alone when it fails"
@@ -464,6 +520,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what statuses answers; error and error-kind alone when it fails"
@@ -546,6 +610,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what status answers; error and error-kind alone when it fails"
@@ -607,6 +679,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what comment answers; error and error-kind alone when it fails"
@@ -668,6 +748,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what view answers; error and error-kind alone when it fails"
@@ -730,6 +818,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what note answers; error and error-kind alone when it fails"
@@ -738,7 +834,7 @@
},
{
"name": "merge-pull",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H \u00a7734, \u00a7735, \u00a7766; ADR 0682 \u00a71, \u00a72). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H §734, §735, §766; ADR 0682 §1, §2). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"input": {
"type": "object",
"properties": {
@@ -805,6 +901,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what merge-pull answers at the call's end; error and error-kind alone when it fails"
@@ -815,7 +919,7 @@
{
"name": "tag",
"class": "act",
"description": "Write the git tag of a released version, go/vMAJOR.MINOR.PATCH, at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"description": "Write the git tag of a released version, <directory>/vMAJOR.MINOR.PATCH for a Go package (design 47 H2 §796), at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"input": {
"type": "object",
"properties": {
@@ -856,6 +960,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tag answers; error and error-kind alone when it fails"
@@ -1259,7 +1371,7 @@
"name": "calls",
"template": "state",
"history": 1,
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H \u00a7766, H-A-47)",
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H §766, H-A-47)",
"key-forms": [
{
"key": "call.<call>",
@@ -1328,7 +1440,7 @@
"description": "its page on the forge"
}
},
"description": "one pull request as the forge holds it; never its description (ADR 0659 \u00a71)",
"description": "one pull request as the forge holds it; never its description (ADR 0659 §1)",
"required": [
"repository",
"number",
@@ -1361,7 +1473,7 @@
"description": "whether the forge's merging account may write the repository: false, its statuses and its merge are refused"
}
},
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 \u00a71): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 §1): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"required": [
"mergeable",
"protected",
@@ -1471,9 +1583,10 @@
"enum": [
"refused",
"not-found",
"failed"
"failed",
"away"
],
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed"
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed; away, a part the holder depends on (the forge, its store) is away, with part naming what did not answer and words: a caller reads it as a transport fault and calls again (design 47 H2 §776)"
},
"FailedStep": {
"type": "object",
@@ -1529,7 +1642,7 @@
},
"MemberOutcome": {
"type": "object",
"description": "one member of a merge call and where it stands (design 47 H \u00a7766, H-A-22)",
"description": "one member of a merge call and where it stands (design 47 H §766, H-A-22)",
"properties": {
"repository": {
"type": "string"
@@ -1564,7 +1677,7 @@
},
"Call": {
"type": "object",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H \u00a7766)",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H §766)",
"properties": {
"by": {
"type": "string",
@@ -1640,12 +1753,30 @@
"head",
"state"
]
},
"Tag": {
"type": "object",
"description": "a tag and the commit it names (design 47 H2 §796)",
"properties": {
"tag": {
"type": "string"
},
"commit": {
"type": "string",
"description": "the commit it names, its full 40-hex sha",
"pattern": "^[0-9a-f]{40}$"
}
},
"required": [
"tag",
"commit"
]
}
},
"bodies": {
"MergeCalled": {
"type": "object",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H \u00a7736, \u00a7767)",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H §736, §767)",
"properties": {
"call": {
"type": "string",
@@ -1702,7 +1833,7 @@
},
"refused": {
"type": "array",
"description": "one per member not merged after every member was judged (design 47 H \u00a7767)",
"description": "one per member not merged after every member was judged (design 47 H §767)",
"items": {
"type": "object",
"properties": {
@@ -1732,5 +1863,6 @@
"members"
]
}
}
},
"form": 2
}
+1
View File
@@ -21,6 +21,7 @@ mesh-delivery f8bbde9627255fe37bd6603a40fcce14fb61d97b modules/mesh-delivery-co
mesh-delivery d24d6a08905996841b62c723736339e809ca4625 modules/mesh-delivery-contracts/seats/git/seat.json, taken again as seat.json.captured (milestone 47/H1, C2 amended, H-A-71)
mesh-delivery 6e027de59773affe80d7bf45cf49d81292893ff1 modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json, taken again as seat.json.captured (milestone 47/H1, C3)
mesh-delivery 9a55e6e8c0faa36dd96be2d90c13e5bb42be0bf3 modules/mesh-delivery-contracts/seats/git, mesh-delivery and mesh-catalog, taken again as seat.json.captured (milestone 47/H1, through C1d)
mesh-delivery d2d3ebbf44fbf0362edaf78d991615f564644615 modules/mesh-delivery-contracts/seats/git/seat.json, taken again as seat.json.captured (milestone 47/H2, D5)
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:
@@ -5,7 +5,7 @@
"grain": "whole",
"domain": "Delivery",
"decision": "novox/hq ADR 0111",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 \u00a71, \u00a72). A failed read answers an error, never an empty answer.",
"description": "The forge: every read and act a delivery part makes of the mesh's git repositories, and what the forge says happened (design 47 *The seat git*, ADR 0596 §1, §2). A failed read answers an error, never an empty answer.",
"delivers": "git",
"verbs": [
{
@@ -48,6 +48,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what pull answers; error and error-kind alone when it fails"
@@ -96,6 +104,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what branch answers; error and error-kind alone when it fails"
@@ -126,6 +142,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what open-pulls answers; pulls always said, empty when none is open; error and error-kind beside an empty pulls when it fails",
@@ -171,9 +195,9 @@
"tags": {
"type": "array",
"items": {
"type": "string"
"$ref": "#/defs/Tag"
},
"description": "the tags of this page"
"description": "the tags of this page, each with the commit it names (design 47 H2 §796)"
},
"page": {
"type": "integer",
@@ -193,6 +217,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tags answers; error and error-kind alone when it fails"
@@ -201,7 +233,7 @@
},
{
"name": "trees",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part.",
"description": "The trees of one commit: the root tree and the tree of every directory that holds a module.json, by their git hashes; with files, every blob under each named directory; with paths, the object of each named path. A listing the forge cut is refused, never answered in part. A directory named in files or paths that the commit does not hold answers the error kind not-found (design 47 H2 §796).",
"input": {
"type": "object",
"properties": {
@@ -284,6 +316,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what trees answers; error and error-kind alone when it fails"
@@ -350,6 +390,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what file answers; error and error-kind alone when it fails"
@@ -410,6 +458,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what contains answers; error and error-kind alone when it fails"
@@ -464,6 +520,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what statuses answers; error and error-kind alone when it fails"
@@ -546,6 +610,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what status answers; error and error-kind alone when it fails"
@@ -607,6 +679,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what comment answers; error and error-kind alone when it fails"
@@ -668,6 +748,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what view answers; error and error-kind alone when it fails"
@@ -730,6 +818,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what note answers; error and error-kind alone when it fails"
@@ -738,7 +834,7 @@
},
{
"name": "merge-pull",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H \u00a7734, \u00a7735, \u00a7766; ADR 0682 \u00a71, \u00a72). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"description": "Merge one or more pull requests with the forge tools' account, each at the head the caller names: one merge call, a delivery's start and, with two or more members, its group (design 47 H §734, §735, §766; ADR 0682 §1, §2). Every member is judged before any is merged: still the pull request's head, its base a watched branch, no run at the head's build-input fingerprint failed a required step (judged from its own state failed-steps), registrations heard; no branch protection is read. When one member is refused, none is merged. Then it merges them in the order named, writing the call in its state calls before the first merge, and says merge-called once. It answers once, at the call's end, naming the call and each member's outcome; a member already merged is refused already-merged, naming its commit.",
"input": {
"type": "object",
"properties": {
@@ -805,6 +901,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what merge-pull answers at the call's end; error and error-kind alone when it fails"
@@ -815,7 +919,7 @@
{
"name": "tag",
"class": "act",
"description": "Write the git tag of a released version, go/vMAJOR.MINOR.PATCH, at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"description": "Write the git tag of a released version, <directory>/vMAJOR.MINOR.PATCH for a Go package (design 47 H2 §796), at the commit its build was made from; the builder writes it only on the catalog's version-released (design 47 G section 370). A tag already at that commit is answered performed. An error answer carries error and error-kind.",
"input": {
"type": "object",
"properties": {
@@ -856,6 +960,14 @@
},
"error-kind": {
"$ref": "#/defs/ErrorKind"
},
"part": {
"type": "string",
"description": "with the error kind away, what did not answer (design 47 H2 §776)"
},
"words": {
"type": "string",
"description": "with the error kind away, the holder's words (design 47 H2 §776)"
}
},
"description": "what tag answers; error and error-kind alone when it fails"
@@ -1259,7 +1371,7 @@
"name": "calls",
"template": "state",
"history": 1,
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H \u00a7766, H-A-47)",
"description": "every merge call, written before its first merge; one whose merge-called is not said is said at the holder's start; deleted past the stream merge-called's age (design 47 H §766, H-A-47)",
"key-forms": [
{
"key": "call.<call>",
@@ -1328,7 +1440,7 @@
"description": "its page on the forge"
}
},
"description": "one pull request as the forge holds it; never its description (ADR 0659 \u00a71)",
"description": "one pull request as the forge holds it; never its description (ADR 0659 §1)",
"required": [
"repository",
"number",
@@ -1361,7 +1473,7 @@
"description": "whether the forge's merging account may write the repository: false, its statuses and its merge are refused"
}
},
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 \u00a71): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"description": "what the forge would merge now, for an open pull request (issues 1275, 1945; ADR 0441 §1): answered whole or not at all, and a read the forge could not make answers the verb's error, never a guess; absent for a merged or closed one",
"required": [
"mergeable",
"protected",
@@ -1471,9 +1583,10 @@
"enum": [
"refused",
"not-found",
"failed"
"failed",
"away"
],
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed"
"description": "which kind of error, set with error alone: refused, the forge or the holder refused and error says why in the forge's own words; not-found, the forge said that what was asked about (a repository, a commit, a pull request, a branch or a tag) does not exist, so a caller never reads it out of error's words; failed, the forge failed or could not be reached, so the act or read could not be performed; away, a part the holder depends on (the forge, its store) is away, with part naming what did not answer and words: a caller reads it as a transport fault and calls again (design 47 H2 §776)"
},
"FailedStep": {
"type": "object",
@@ -1529,7 +1642,7 @@
},
"MemberOutcome": {
"type": "object",
"description": "one member of a merge call and where it stands (design 47 H \u00a7766, H-A-22)",
"description": "one member of a merge call and where it stands (design 47 H §766, H-A-22)",
"properties": {
"repository": {
"type": "string"
@@ -1564,7 +1677,7 @@
},
"Call": {
"type": "object",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H \u00a7766)",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H §766)",
"properties": {
"by": {
"type": "string",
@@ -1640,12 +1753,30 @@
"head",
"state"
]
},
"Tag": {
"type": "object",
"description": "a tag and the commit it names (design 47 H2 §796)",
"properties": {
"tag": {
"type": "string"
},
"commit": {
"type": "string",
"description": "the commit it names, its full 40-hex sha",
"pattern": "^[0-9a-f]{40}$"
}
},
"required": [
"tag",
"commit"
]
}
},
"bodies": {
"MergeCalled": {
"type": "object",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H \u00a7736, \u00a7767)",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H §736, §767)",
"properties": {
"call": {
"type": "string",
@@ -1702,7 +1833,7 @@
},
"refused": {
"type": "array",
"description": "one per member not merged after every member was judged (design 47 H \u00a7767)",
"description": "one per member not merged after every member was judged (design 47 H §767)",
"items": {
"type": "object",
"properties": {
@@ -1732,5 +1863,6 @@
"members"
]
}
}
},
"form": 2
}