sdk-seat-copies-h1: the copy of git equals mesh-delivery's file at C2 (f8bbde96); the timeout comment names the 30 seconds bound

Builds: design 47 H §734, §736, H-A-42, H-A-65
This commit is contained in:
2026-11-20 02:46:24 +01:00
parent 77a7b187f4
commit 809fe9aa66
5 changed files with 827 additions and 208 deletions
+1
View File
@@ -17,6 +17,7 @@ mesh-contracts dca9ce0245595cce2ff75ff155833ecc50a99bc0 seats/node-engine/seat.
mesh-delivery 5bf848144283055a1ef37441eeda0e439fb6ad7e contracts/seats/mesh-catalog and mesh-delivery-checker, as seat.json.captured (go/seatlist's bootstrap test; milestone 47/G)
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-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. The act verbs are the forge bridge's alone.",
"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.",
"delivers": "git",
"verbs": [
{
@@ -56,7 +56,7 @@
},
{
"name": "branch",
"description": "A branch's head, and whether a protection rule refuses a direct push and admits only merges (design 47 *The seat git*, *Watched branches and the catalog graph per branch*). A branch the forge does not hold answers the error kind not-found.",
"description": "A branch's head (design 47 *The seat git*, *Watched branches and the catalog graph per branch*). A branch the forge does not hold answers the error kind not-found.",
"input": {
"type": "object",
"properties": {
@@ -90,10 +90,6 @@
"description": "a commit, its full 40-hex sha",
"pattern": "^[0-9a-f]{40}$"
},
"protected": {
"type": "boolean",
"description": "a protection rule refuses a direct push and admits only merges"
},
"error": {
"type": "string",
"description": "why the forge could not answer, or refused: set alone with error-kind, and a caller reads it as a failure, never as none"
@@ -742,83 +738,66 @@
},
{
"name": "merge-pull",
"description": "Merge a pull request with the forge tools' account at the head the caller names (design 47 *Approval is a step, and a session merges a pull request*). It judges that this is still the pull request's head and that the base branch's protection refuses a direct push, read again on every branch-moved, and refuses a head when any run at its build-input fingerprint failed a required step, judged from its own state failed-steps heard from the runner's step-ended, never by a call; a head with no run yet or a passed one merges, it never waits for a run and never asks an Approve (ADR 0666 section 11). Refused, naming why: a head that moved, a branch no protection guards, a failed required step (naming the run, the module and the step), no registrations yet (ADR 0667 section 10), a merge git refuses. A pull request already merged at that head is answered performed.",
"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.",
"input": {
"type": "object",
"properties": {
"id": {
"pulls": {
"type": "array",
"minItems": 1,
"description": "the members, in the order they are merged",
"items": {
"type": "object",
"properties": {
"repository": {
"type": "string",
"description": "the repository, <owner>/<name>",
"minLength": 1
},
"number": {
"type": "integer",
"description": "the pull request's number"
},
"head": {
"type": "string",
"description": "the head the caller names",
"pattern": "^[0-9a-f]{40}$"
}
},
"additionalProperties": false,
"required": [
"repository",
"number",
"head"
]
}
},
"by": {
"type": "string",
"description": "the act's id",
"description": "the caller as who@node, recorded beside the bus account the tool runner proves",
"minLength": 1
},
"repository": {
"type": "string",
"description": "the repository, <owner>/<name>",
"minLength": 1
},
"number": {
"type": "integer",
"description": "the pull request's number"
},
"head": {
"type": "string",
"description": "the head the caller names",
"pattern": "^[0-9a-f]{40}$"
}
},
"additionalProperties": false,
"required": [
"id",
"repository",
"number",
"head"
"pulls",
"by"
]
},
"answer": {
"type": "object",
"properties": {
"id": {
"call": {
"type": "string",
"description": "the act's id, as the caller gave it"
"description": "the merge call, 16 lowercase hex characters made once per call",
"pattern": "^[0-9a-f]{16}$"
},
"performed": {
"type": "boolean",
"description": "the forge holds the act now"
},
"held": {
"type": "boolean",
"description": "the id was already held on the pull request or the note, so nothing was done again"
},
"merge-commit": {
"type": "string",
"description": "the merge commit"
},
"refused": {
"type": "string",
"description": "why the forge or the holder refused the merge; the act is not performed"
},
"refused-kind": {
"type": "string",
"enum": [
"head-moved",
"unprotected",
"policy-failed",
"no-registrations",
"git-refused"
],
"description": "which refusal, set with refused: head-moved, the pull request's head is not the one named; unprotected, the base branch's protection does not refuse a direct push; policy-failed, a run at the head's fingerprint failed a required step (run, module and step name it); no-registrations, no registration-changed heard yet (ADR 0667 section 10); git-refused, git refused the merge"
},
"run": {
"type": "string",
"description": "for policy-failed, the run that failed the step: the runner's pipeline key"
},
"module": {
"type": "string",
"description": "for policy-failed, the module"
},
"step": {
"type": "string",
"description": "for policy-failed, the step"
"members": {
"type": "array",
"description": "each member's outcome, in the order named",
"items": {
"$ref": "#/defs/MemberOutcome"
}
},
"error": {
"type": "string",
@@ -828,9 +807,10 @@
"$ref": "#/defs/ErrorKind"
}
},
"description": "what merge-pull answers; error and error-kind alone when it fails"
"description": "what merge-pull answers at the call's end; error and error-kind alone when it fails"
},
"class": "act"
"class": "act",
"timeout": 120
},
{
"name": "tag",
@@ -1242,6 +1222,17 @@
"max-age-days": 90,
"max-mib": 64
}
},
{
"name": "merge-called",
"subject": "merge-called.<call>",
"body": {
"$ref": "#/bodies/MergeCalled"
},
"keep": {
"max-age-days": 30,
"max-mib": 64
}
}
],
"family": {
@@ -1263,6 +1254,21 @@
"description": "a failed required step"
}
]
},
{
"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)",
"key-forms": [
{
"key": "call.<call>",
"value": {
"$ref": "#/defs/Call"
},
"description": "one merge call"
}
]
}
],
"defs": {
@@ -1520,6 +1526,206 @@
"run",
"commits"
]
},
"MemberOutcome": {
"type": "object",
"description": "one member of a merge call and where it stands (design 47 H \u00a7766, H-A-22)",
"properties": {
"repository": {
"type": "string"
},
"number": {
"type": "integer"
},
"state": {
"type": "string",
"enum": [
"judged",
"merged",
"refused"
],
"description": "judged, judged and not merged; merged, with its commit; refused, with why"
},
"commit": {
"type": "string",
"description": "for merged, the merge commit; for a member refused already-merged, its commit",
"pattern": "^[0-9a-f]{40}$"
},
"why": {
"type": "string",
"description": "for refused, why, naming the step for a failed required step"
}
},
"required": [
"repository",
"number",
"state"
]
},
"Call": {
"type": "object",
"description": "one merge call, written before its first merge and updated as each member merges (design 47 H \u00a7766)",
"properties": {
"by": {
"type": "string",
"description": "the caller as who@node"
},
"account": {
"type": "string",
"description": "the bus account the tool runner proved for the call"
},
"at": {
"type": "string",
"format": "date-time"
},
"members": {
"type": "array",
"items": {
"$ref": "#/defs/CallMember"
}
},
"said": {
"type": "boolean",
"description": "merge-called was said for it"
}
},
"required": [
"by",
"account",
"at",
"members",
"said"
]
},
"CallMember": {
"type": "object",
"description": "one member of a kept call",
"properties": {
"repository": {
"type": "string"
},
"number": {
"type": "integer"
},
"head": {
"type": "string",
"pattern": "^[0-9a-f]{40}$"
},
"state": {
"type": "string",
"enum": [
"judged",
"merged",
"refused"
]
},
"commit": {
"type": "string",
"description": "for merged, the merge commit",
"pattern": "^[0-9a-f]{40}$"
},
"why": {
"type": "string",
"description": "for refused, why"
}
},
"required": [
"repository",
"number",
"head",
"state"
]
}
},
"bodies": {
"MergeCalled": {
"type": "object",
"description": "a merge call's members merged or refused, said once by the forge module (design 47 H \u00a7736, \u00a7767)",
"properties": {
"call": {
"type": "string",
"description": "the merge call, 16 lowercase hex characters made once per call",
"pattern": "^[0-9a-f]{16}$"
},
"by": {
"type": "string",
"description": "the caller as who@node"
},
"account": {
"type": "string",
"description": "the bus account the tool runner proved"
},
"at": {
"type": "string",
"format": "date-time",
"description": "the time of the last merge"
},
"members": {
"type": "array",
"description": "one per landed member",
"items": {
"type": "object",
"properties": {
"repository": {
"type": "string"
},
"number": {
"type": "integer"
},
"branch": {
"type": "string",
"description": "the pull request's base, a watched branch"
},
"head": {
"type": "string",
"pattern": "^[0-9a-f]{40}$"
},
"commit": {
"type": "string",
"description": "the merge commit the forge records for the pull request",
"pattern": "^[0-9a-f]{40}$"
}
},
"required": [
"repository",
"number",
"branch",
"head",
"commit"
]
}
},
"refused": {
"type": "array",
"description": "one per member not merged after every member was judged (design 47 H \u00a7767)",
"items": {
"type": "object",
"properties": {
"repository": {
"type": "string"
},
"number": {
"type": "integer"
},
"why": {
"type": "string"
}
},
"required": [
"repository",
"number",
"why"
]
}
}
},
"required": [
"call",
"by",
"account",
"at",
"members"
]
}
}
}