diff --git a/go/catalogue/own_manifest_test.go b/go/catalogue/own_manifest_test.go index 5c86bd0b..449fa07c 100644 --- a/go/catalogue/own_manifest_test.go +++ b/go/catalogue/own_manifest_test.go @@ -58,8 +58,9 @@ func TestOwnManifestUsesNoWordTheRunningControllerRefuses(t *testing.T) { } // The two seats the milestone renamed (ADR 0634 §9) are read by their new names; a node-engine built with the baseline // reads the old ones, and a manifest of the new names is the milestone's to deliver after the engines. The word - // `waits` is no longer read: novox/hq ADR 0670 §2 retired it. - renamed := []string{"seat:mesh-enrolment", "seat:mesh-placement", "word:waits"} + // `waits` is no longer read: novox/hq ADR 0670 §2 retired it. The seat mesh-delivery-checker is gone with the checker + // (design 47 H §764, H-A-42). + renamed := []string{"seat:mesh-enrolment", "seat:mesh-placement", "word:waits", "seat:mesh-delivery-checker"} for _, b := range baseline { if !slices.Contains(reads, b) && !slices.Contains(renamed, b) { t.Errorf("the baseline's %s is no reader capability of this contract", b) diff --git a/go/process/call_test.go b/go/process/call_test.go index 75ba07f7..dd1a1121 100644 --- a/go/process/call_test.go +++ b/go/process/call_test.go @@ -175,9 +175,6 @@ func TestUserOfTokenAndAnswerSeatRefusals(t *testing.T) { {"the definition unread, a person (A-435)", "person.jo", func() (seatdef.Definition, bool) { return seatdef.Definition{}, false }, "may need approval"}, {"the definition unread, an unproven caller (A-435)", "", func() (seatdef.Definition, bool) { return seatdef.Definition{}, false }, "may need approval"}, {"a verb the definition does not name", "novox.mesh-recovery", func() (seatdef.Definition, bool) { return seatdef.Definition{Seat: "seat"}, true }, ""}, - {"a verb open to none", "novox.mesh-recovery", func() (seatdef.Definition, bool) { - return seatdef.Definition{Seat: "seat", Verbs: []seatdef.Verb{{Name: "v", Callers: &seatdef.Callers{List: []string{}}}}}, true - }, ""}, {"a marked verb with no gate (§677)", "novox.mesh-recovery", func() (seatdef.Definition, bool) { return seatdef.Definition{Seat: "seat", Verbs: []seatdef.Verb{{Name: "v", NeedsApproval: true}}}, true }, "through no gate"}, diff --git a/go/seatdef/callers.go b/go/seatdef/callers.go deleted file mode 100644 index 0ec3b333..00000000 --- a/go/seatdef/callers.go +++ /dev/null @@ -1,187 +0,0 @@ -package seatdef - -import ( - "bytes" - "encoding/json" - "errors" - "fmt" - "strings" -) - -// Callers says who may call a verb or send an accepted kind. It is read as text (the form every definition on main -// has) or as a list (the form design 47 G §336 writes); the reader release carries both so that a definition in -// either form is read (design 47 G §340), and G's own reader refuses the text. -type Callers struct { - // Text is the callers in words, when the definition gave them so. - Text string - // List is the callers as a list of entries, when the definition gave them so. - List []string -} - -// IsText says whether the definition gave its callers in words. -func (c Callers) IsText() bool { return c.List == nil } - -// UnmarshalJSON reads a string or a list of strings. -func (c *Callers) UnmarshalJSON(raw []byte) error { - raw = bytes.TrimSpace(raw) - switch { - case len(raw) > 0 && raw[0] == '"': - return json.Unmarshal(raw, &c.Text) - case len(raw) > 0 && raw[0] == '[': - c.List = []string{} - return json.Unmarshal(raw, &c.List) - } - return errors.New("callers is a text or a list of entries") -} - -// MarshalJSON writes the form the definition was read in. -func (c Callers) MarshalJSON() ([]byte, error) { - if c.IsText() { - return json.Marshal(c.Text) - } - return json.Marshal(c.List) -} - -func checkCallers(where string, c *Callers) Problems { - if c == nil { - return nil - } - if c.IsText() { - if c.Text == "" { - return Problems{{where, "is empty"}} - } - return nil - } - var ps Problems - for i, e := range c.List { - if why := CallerEntryProblem(e); why != "" { - ps = append(ps, Problem{fmt.Sprintf("%s[%d]", where, i), why}) - } - } - return ps -} - -// The entries of a list of callers that are not a name (design 47 G §336). -const ( - CallerOperator = "operator" - CallerHealers = "healers" - CallerPersons = "persons" - CallerSessions = "sessions" - CallerInvokers = "invokers" -) - -// The prefixes of the entries that name a seat's holder or a module (design 47 G §392, §336). -const ( - CallerSeatPrefix = "seat:" - CallerModulePrefix = "module:" - CallerHolderPrefix = "holder:" - CallerSameNode = "@same-node" -) - -// CallerEntryProblem says why an entry of a list of callers is none of the forms of design 47 G §336, §392; empty -// when it is one: `operator`, `healers`, `persons`, `sessions`, `invokers`, `seat:`, `module:` and -// `holder:@same-node`. A bare name is refused, since a name such as `mesh-grants` is both a seat and a module. -func CallerEntryProblem(e string) string { - switch e { - case CallerOperator, CallerHealers, CallerPersons, CallerSessions, CallerInvokers: - return "" - } - if n, ok := strings.CutPrefix(e, CallerSeatPrefix); ok && wordName.MatchString(n) { - return "" - } - if n, ok := strings.CutPrefix(e, CallerModulePrefix); ok && wordName.MatchString(n) { - return "" - } - if n, ok := strings.CutPrefix(e, CallerHolderPrefix); ok { - if seat, ok := strings.CutSuffix(n, CallerSameNode); ok && wordName.MatchString(seat) { - return "" - } - } - return fmt.Sprintf("%q is none of operator, healers, persons, sessions, invokers, seat:, module: and "+ - "holder:@same-node", e) -} - -// DefaultCallers are the callers a verb that names none takes by its class (design 47 G §610, amending §391): a read takes -// invokers, persons and sessions; an act, a warrant and an accepted kind (`accept`) the operator, sessions and invokers. A -// verb that names no class is a read. -func DefaultCallers(class string) []string { - switch class { - case ClassAct, ClassWarrant, "accept": - return []string{CallerOperator, CallerSessions, CallerInvokers} - } - return []string{CallerInvokers, CallerPersons, CallerSessions} -} - -// EffectiveCallers are the callers the verb is open to: the list it names, or the default of its class. A verb whose -// callers are text, as the definitions before G wrote them, names no list and takes the default. -func (v Verb) EffectiveCallers() []string { - if v.Callers != nil && !v.Callers.IsText() { - return v.Callers.List - } - return DefaultCallers(v.Class) -} - -// The classes of a verb (design 47 G §391). -const ( - ClassRead = "read" - ClassAct = "act" - ClassWarrant = "warrant" -) - -// Classes are the classes a verb's `class` may name. -var Classes = []string{ClassRead, ClassAct, ClassWarrant} - -// Keep is an event's `keep`: the string of today's definitions (KeepLastPerSubject or KeepStream, with the message's -// max-age-days and max-mib beside it) or the object of design 47 G §396 (`max-age-days`, `max-mib`, -// `last-per-subject`). The reader release reads both (design 47 G §340, §409). -type Keep struct { - // Mode is the string form; empty when the object form was given. - Mode string - // MaxAgeDays, MaxMiB and LastPerSubject are the object form's fields; MaxAgeDays and MaxMiB are nil when unsaid. - MaxAgeDays *int - MaxMiB *int - LastPerSubject bool - // Object says the object form was given. - Object bool -} - -type keepObject struct { - MaxAgeDays *int `json:"max-age-days"` - MaxMiB *int `json:"max-mib"` - LastPerSubject bool `json:"last-per-subject"` -} - -// UnmarshalJSON reads the string or the object, the object strictly. -func (k *Keep) UnmarshalJSON(raw []byte) error { - raw = bytes.TrimSpace(raw) - if len(raw) > 0 && raw[0] == '"' { - return json.Unmarshal(raw, &k.Mode) - } - var o keepObject - dec := json.NewDecoder(bytes.NewReader(raw)) - dec.DisallowUnknownFields() - if err := dec.Decode(&o); err != nil { - return fmt.Errorf("keep is a string or an object of max-age-days, max-mib and last-per-subject: %w", err) - } - *k = Keep{MaxAgeDays: o.MaxAgeDays, MaxMiB: o.MaxMiB, LastPerSubject: o.LastPerSubject, Object: true} - return nil -} - -// MarshalJSON writes the form the definition was read in. -func (k Keep) MarshalJSON() ([]byte, error) { - if !k.Object { - return json.Marshal(k.Mode) - } - return json.Marshal(keepObject{k.MaxAgeDays, k.MaxMiB, k.LastPerSubject}) -} - -func checkKeepObject(where string, k Keep) Problems { - var ps Problems - if k.MaxAgeDays != nil && *k.MaxAgeDays < 0 { - ps = append(ps, Problem{where + ".max-age-days", "is negative (0 is no age limit)"}) - } - if k.MaxMiB != nil && *k.MaxMiB <= 0 { - ps = append(ps, Problem{where + ".max-mib", "is not above zero"}) - } - return ps -} diff --git a/go/seatdef/classes_keep.go b/go/seatdef/classes_keep.go new file mode 100644 index 00000000..74a79a5e --- /dev/null +++ b/go/seatdef/classes_keep.go @@ -0,0 +1,72 @@ +package seatdef + +import ( + "bytes" + "encoding/json" + "fmt" +) + +// The classes of a verb (design 47 G §391). +const ( + ClassRead = "read" + ClassAct = "act" + ClassWarrant = "warrant" +) + +// Classes are the classes a verb's `class` may name. +var Classes = []string{ClassRead, ClassAct, ClassWarrant} + +// Keep is an event's `keep`: the string of today's definitions (KeepLastPerSubject or KeepStream, with the message's +// max-age-days and max-mib beside it) or the object of design 47 G §396 (`max-age-days`, `max-mib`, +// `last-per-subject`). The reader release reads both (design 47 G §340, §409). +type Keep struct { + // Mode is the string form; empty when the object form was given. + Mode string + // MaxAgeDays, MaxMiB and LastPerSubject are the object form's fields; MaxAgeDays and MaxMiB are nil when unsaid. + MaxAgeDays *int + MaxMiB *int + LastPerSubject bool + // Object says the object form was given. + Object bool +} + +type keepObject struct { + MaxAgeDays *int `json:"max-age-days"` + MaxMiB *int `json:"max-mib"` + LastPerSubject bool `json:"last-per-subject"` +} + +// UnmarshalJSON reads the string or the object, the object strictly. +func (k *Keep) UnmarshalJSON(raw []byte) error { + raw = bytes.TrimSpace(raw) + if len(raw) > 0 && raw[0] == '"' { + return json.Unmarshal(raw, &k.Mode) + } + var o keepObject + dec := json.NewDecoder(bytes.NewReader(raw)) + dec.DisallowUnknownFields() + if err := dec.Decode(&o); err != nil { + return fmt.Errorf("keep is a string or an object of max-age-days, max-mib and last-per-subject: %w", err) + } + *k = Keep{MaxAgeDays: o.MaxAgeDays, MaxMiB: o.MaxMiB, LastPerSubject: o.LastPerSubject, Object: true} + return nil +} + +// MarshalJSON writes the form the definition was read in. +func (k Keep) MarshalJSON() ([]byte, error) { + if !k.Object { + return json.Marshal(k.Mode) + } + return json.Marshal(keepObject{k.MaxAgeDays, k.MaxMiB, k.LastPerSubject}) +} + +func checkKeepObject(where string, k Keep) Problems { + var ps Problems + if k.MaxAgeDays != nil && *k.MaxAgeDays < 0 { + ps = append(ps, Problem{where + ".max-age-days", "is negative (0 is no age limit)"}) + } + if k.MaxMiB != nil && *k.MaxMiB <= 0 { + ps = append(ps, Problem{where + ".max-mib", "is not above zero"}) + } + return ps +} diff --git a/go/seatdef/refs_test.go b/go/seatdef/refs_test.go index aa81ce42..f8125aae 100644 --- a/go/seatdef/refs_test.go +++ b/go/seatdef/refs_test.go @@ -38,6 +38,5 @@ func subResolveRefsPutsNamedTypesInPlace(t *testing.T) { // TestResolveRefsPutsNamedTypesInPlace runs the tests of this package that were merged to keep the module within its test budget (design 47 G §419), each as a subtest. func TestResolveRefsPutsNamedTypesInPlace(t *testing.T) { t.Run("ResolveRefsPutsNamedTypesInPlace", subResolveRefsPutsNamedTypesInPlace) - t.Run("AVerbWithoutCallersTakesItsClassDefault", subAVerbWithoutCallersTakesItsClassDefault) t.Run("AKeptEventsStreamIsNamedAndBoundedByItsKeep", subAKeptEventsStreamIsNamedAndBoundedByItsKeep) } diff --git a/go/seatdef/seatdef.go b/go/seatdef/seatdef.go index 63376b86..e9efaafc 100644 --- a/go/seatdef/seatdef.go +++ b/go/seatdef/seatdef.go @@ -214,8 +214,6 @@ type Verb struct { Replaces []string `json:"replaces,omitempty"` Input map[string]any `json:"input,omitempty"` Answer map[string]any `json:"answer,omitempty"` - // Callers says who may call it, as a list (design 47 G §336) or, in the definitions before G, in words. - Callers *Callers `json:"callers,omitempty"` // Class is the verb's class, ClassRead, ClassAct or ClassWarrant (design 47 G §391). Class string `json:"class,omitempty"` // NeedsApproval marks the verb for every holder: the operator approves a call of it first (design 46 *The approval @@ -263,8 +261,6 @@ type Message struct { // node-engine's running.., so the last build of every module on every node stays on the bus however // long ago it was said). An event with a Keep has no dot in its name. Keep *Keep `json:"keep,omitempty"` - // Callers says who may send an accepted kind, as a verb's (design 47 G §338). - Callers *Callers `json:"callers,omitempty"` // Stream is the stream an accepted kind rides, StreamCheck or StreamDelivery: its queue, and its subject is the queue's, // `accept.`, the kind in the body alone (design 47 G §600, A-170). Its generated names and an invoke name it // `.`, so the same kind name may ride more than one stream (design 47 G §415). @@ -821,7 +817,6 @@ func checkVerbs(vs []Verb, whole bool) Problems { ps = append(ps, Problem{where + ".name", fmt.Sprintf("%q twice", v.Name)}) } seen[v.Name] = true - ps = append(ps, checkCallers(where+".callers", v.Callers)...) if v.Timeout != nil && (*v.Timeout < MinTimeout || *v.Timeout > MaxTimeout) { ps = append(ps, Problem{where + ".timeout", fmt.Sprintf("%d is not whole seconds from %d to %d", *v.Timeout, MinTimeout, MaxTimeout)}) } @@ -873,10 +868,6 @@ func checkMessages(field string, ms []Message, whole bool) Problems { ps = append(ps, Problem{where + ".keep", "an event of one subject kept last per subject is one message: give it a subject with parts"}) } } - if m.Callers != nil && field != "accepts" { - ps = append(ps, Problem{where + ".callers", "only an accepted kind carries callers"}) - } - ps = append(ps, checkCallers(where+".callers", m.Callers)...) if m.Subject != "" && field != "events" { ps = append(ps, Problem{where + ".subject", "only an event carries a subject of its own"}) } else if why := checkSubject(m); why != "" { diff --git a/go/seatdef/seatdef_test.go b/go/seatdef/seatdef_test.go index 63190174..cf5730d5 100644 --- a/go/seatdef/seatdef_test.go +++ b/go/seatdef/seatdef_test.go @@ -122,24 +122,16 @@ func TestADefinitionIsReadStrictlyNamingWhatIsWrong(t *testing.T) { "when: a field the format does not know"}, {"one step on one language twice", strings.Replace(listGrain, `"verbs":`, `"acts":[{"step":"grant"},{"step":"grant","on":"every"}],"verbs":`, 1), "acts[1]: the step grant on every twice"}, - // The reader release (design 47 G §340, §409): the forms G writes beside the ones on main. - {"callers as text", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":"a person",`, 1), ""}, - {"callers as a list", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["operator","seat:mesh-grants","invokers"],"class":"read",`, 1), ""}, - {"callers as neither", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":7,`, 1), "callers is a text or a list"}, - {"a list with an empty entry", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["operator",""],`, 1), "verbs[0].callers[1]"}, - {"a bare name among callers", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["mesh-grants"],`, 1), `"mesh-grants" is none of operator`}, - {"a class of the old branches", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["holder","invokes","reviewers"],`, 1), `"holder" is none of operator`}, - {"every form among callers", strings.Replace(whole, `"name":"list",`, - `"name":"list","callers":["operator","healers","persons","sessions","invokers","seat:mesh-grants","module:mesh-grants","holder:node-backup@same-node"],`, 1), ""}, - {"a holder not on the same node", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["holder:node-backup"],`, 1), "none of operator"}, {"a verb's timeout of 120 seconds", strings.Replace(whole, `"name":"list",`, `"name":"list","timeout":120,`, 1), ""}, {"a verb's timeout at either bound", strings.Replace(whole, `"name":"list",`, `"name":"list","timeout":600,`, 1), ""}, {"a verb's timeout of none", strings.Replace(whole, `"name":"list",`, `"name":"list","timeout":0,`, 1), "verbs[0].timeout: 0 is not whole seconds from 1 to 600"}, {"a verb's timeout over ten minutes", strings.Replace(whole, `"name":"list",`, `"name":"list","timeout":601,`, 1), "verbs[0].timeout: 601 is not whole seconds from 1 to 600"}, {"a verb's timeout in fractions", strings.Replace(whole, `"name":"list",`, `"name":"list","timeout":1.5,`, 1), "not a seat definition's JSON"}, + {"a verb naming callers", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":["operator"],`, 1), "callers: a field the format does not know"}, + {"a verb naming callers in words", strings.Replace(whole, `"name":"list",`, `"name":"list","callers":"a person",`, 1), "callers: a field the format does not know"}, + {"an accepted kind naming callers", strings.Replace(whole, `"events":`, `"accepts":[{"name":"step","body":{},"callers":["seat:mesh-pipeline-runner"]}],"events":`, 1), "callers: a field the format does not know"}, + {"an event naming callers", strings.Replace(whole, `"name":"created"`, `"name":"created","callers":["operator"]`, 1), "callers: a field the format does not know"}, {"a class that is none", strings.Replace(whole, `"name":"list",`, `"name":"list","class":"free",`, 1), `verbs[0].class: "free" is not a class (read, act, warrant)`}, - {"an accepted kind's callers", strings.Replace(whole, `"events":`, `"accepts":[{"name":"step","body":{},"callers":["seat:mesh-pipeline-runner"]}],"events":`, 1), ""}, - {"an event's callers", strings.Replace(whole, `"name":"created"`, `"name":"created","callers":["operator"]`, 1), "only an accepted kind carries callers"}, {"keep as an object", strings.Replace(whole, `"name":"created"`, `"name":"owed","keep":{"max-age-days":7,"max-mib":64}`, 1), ""}, {"keep as an object with no age limit", strings.Replace(whole, `"name":"created"`, @@ -346,26 +338,6 @@ func TestAKeptEventsStreamIsNamedFromTheSeatAndTheEvent(t *testing.T) { } } -// Design 47 G §391, §610: a verb that names no callers takes its class's default, a verb that names them keeps them. -func subAVerbWithoutCallersTakesItsClassDefault(t *testing.T) { - for _, c := range []struct { - verb Verb - want string - }{ - {Verb{}, "invokers persons sessions"}, - {Verb{Class: ClassRead}, "invokers persons sessions"}, - {Verb{Class: ClassAct}, "operator sessions invokers"}, - {Verb{Class: ClassWarrant}, "operator sessions invokers"}, - {Verb{Class: ClassAct, Callers: &Callers{List: []string{"seat:mesh-broker"}}}, "seat:mesh-broker"}, - {Verb{Class: ClassWarrant, Callers: &Callers{Text: "a person"}}, "operator sessions invokers"}, - {Verb{Class: "accept"}, "operator sessions invokers"}, - } { - if got := strings.Join(c.verb.EffectiveCallers(), " "); got != c.want { - t.Errorf("%+v is open to %q, want %q", c.verb, got, c.want) - } - } -} - // Design 47 G §260, §396, §331: a kept event's stream is named from the seat and the event, 90 days and 16 MiB unless // the keep says otherwise, and 0 is no age limit. func subAKeptEventsStreamIsNamedAndBoundedByItsKeep(t *testing.T) { diff --git a/go/seatlist/bootstrap/git.json b/go/seatlist/bootstrap/git.json index 283ca432..c24a4f12 100644 --- a/go/seatlist/bootstrap/git.json +++ b/go/seatlist/bootstrap/git.json @@ -52,9 +52,6 @@ }, "description": "what pull answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -107,9 +104,6 @@ }, "description": "what branch answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -143,9 +137,6 @@ "pulls" ] }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -210,9 +201,6 @@ }, "description": "what tags answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -304,9 +292,6 @@ }, "description": "what trees answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -373,9 +358,6 @@ }, "description": "what file answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -436,9 +418,6 @@ }, "description": "what contains answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -493,9 +472,6 @@ }, "description": "what statuses answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -578,9 +554,6 @@ }, "description": "what status answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -642,9 +615,6 @@ }, "description": "what comment answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -706,9 +676,6 @@ }, "description": "what view answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -771,9 +738,6 @@ }, "description": "what note answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -866,18 +830,11 @@ }, "description": "what merge-pull answers; error and error-kind alone when it fails" }, - "callers": [ - "persons", - "sessions" - ], "class": "act" }, { "name": "tag", "class": "act", - "callers": [ - "seat:mesh-builds" - ], "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.", "input": { "type": "object", diff --git a/go/seatlist/bootstrap/mesh-catalog.json b/go/seatlist/bootstrap/mesh-catalog.json index f8163534..ba7fdd0f 100644 --- a/go/seatlist/bootstrap/mesh-catalog.json +++ b/go/seatlist/bootstrap/mesh-catalog.json @@ -355,10 +355,6 @@ { "name": "register", "description": "Register a module whole, as an authorising ask of tier approve naming every value; written only on its warrant, a Decline or an expiry writes nothing. Refuses a watched branch the forge does not protect, read through the seat git's branch, and code review as a required step until forge accounts are bound to bus identities (ADR 0666 sections 2, 3, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -381,10 +377,6 @@ { "name": "policy", "description": "Change one module's step statuses, or one artifact's, as an authorising ask naming each moved status on its own line; refuses code review as required (ADR 0666 sections 2, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -415,10 +407,6 @@ { "name": "watch", "description": "Add a watched branch to a module's registration, as an authorising ask; refuses a branch the forge does not protect, naming it (ADR 0666 sections 2, 3).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -445,10 +433,6 @@ { "name": "unwatch", "description": "Remove a watched branch from a module's registration, as an authorising ask (ADR 0666 section 2).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -475,15 +459,6 @@ { "name": "versions", "class": "read", - "callers": [ - "seat:mesh-builds", - "seat:go-package-registry", - "seat:npm-package-registry", - "seat:container-image-registry", - "seat:oci-artifact-registry", - "persons", - "sessions" - ], "description": "A module's released versions, each artifact's digest, the source revision built and its edge entries; a reserved version is not in it (design 47 G section 349).", "input": { "type": "object", @@ -520,12 +495,6 @@ { "name": "outdated", "class": "read", - "callers": [ - "persons", - "sessions", - "healers", - "seat:mesh-pipeline-runner" - ], "description": "Every entry behind, by the part's digest: its module and version or build, the kind, the dependency with its watched branch and source revision, what was recorded and what is newest, and the act; may be asked for one dependency (design 47 G section 375).", "input": { "type": "object", @@ -558,11 +527,6 @@ { "name": "input", "class": "read", - "callers": [ - "seat:node-build-go", - "seat:node-build-node", - "seat:node-build-image" - ], "description": "A step's input by its digest, as the indexer keeps it for a validation step it asked a build seat to run (design 47 G section 354): its fields, then the bytes in chunks of at most 512 KiB on the chunk subject of the call, each acknowledged by the caller on the ack subject within 30 seconds; the input is of any size.", "input": { "type": "object", diff --git a/go/seatlist/bootstrap/mesh-delivery-checker.json b/go/seatlist/bootstrap/mesh-delivery-checker.json deleted file mode 100644 index 73ec5712..00000000 --- a/go/seatlist/bootstrap/mesh-delivery-checker.json +++ /dev/null @@ -1,862 +0,0 @@ -{ - "format": 1, - "seat": "mesh-delivery-checker", - "scope": "mesh", - "grain": "whole", - "domain": "Delivery", - "decision": "novox/hq ADR 0547", - "verbs": [ - { - "name": "try", - "description": "Try pushed heads before their pull requests are opened: the checker judges them as it judges a delivery group's pull requests, each member merged onto its trunk, its unit and integration levels through the build modules, then the members' manifests, the module graph and the composition on every placed node, and owes the forge nothing. Name the group's members (each a repository and the exact commit), or one repository and its head for a try of one member. Answers the try's id at once; try-read reads where it stands. The same members at the same commits, in any order, are the answer to a second ask while that try waits or runs; at most 4 run on a build node, and 8 wait for one, mesh-wide.", - "optional": true, - "replaces": [ - "sh merge-check.sh", - "docker run postgres" - ], - "input": { - "properties": { - "head": { - "description": "the full commit to try, 40 or 64 hex digits, for a try of one member (instead of members)", - "type": "string" - }, - "level": { - "description": "unit or integration: only this level; both when absent", - "type": "string" - }, - "repository": { - "description": "/, for a try of one member (instead of members)", - "type": "string" - }, - "tests": { - "description": "a go test -run pattern: only those tests run, and nothing is kept", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - }, - "members": { - "description": "the group: one repository at most once, each at the exact commit asked and the trunk commit it is merged onto; instead of repository and head", - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "description": "/", - "type": "string" - }, - "head": { - "description": "the full commit to try, 40 or 64 hex digits", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - } - }, - "required": [ - "repository", - "head" - ] - } - } - }, - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try's id" - }, - "state": { - "type": "string", - "description": "its state" - } - }, - "required": [ - "id" - ] - } - }, - { - "name": "try-read", - "description": "Where a try stands, as stored: queued, running, or its end (pass, fail, or error when it could not run), with what was said of it, the head and the trunk commit it was merged onto, the time it took and what failed first. Read-only.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - } - }, - "required": [ - "id" - ], - "type": "object" - }, - "answer": { - "type": "object", - "description": "the try: its state, its steps and its verdict when it has one" - } - }, - { - "name": "try-end", - "description": "End a try that waits or runs, as error, by hand: say why (kept in what it says). Its place among the tries is free at once and the next try of its head asks anew with a new id. A try that ended already is refused.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - }, - "why": { - "description": "why it is ended, in words", - "type": "string" - } - }, - "required": [ - "id", - "why" - ], - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try" - }, - "ended": { - "type": "boolean", - "description": "it is ended" - } - }, - "required": [ - "id", - "ended" - ] - } - }, - { - "name": "input", - "description": "A checking program's input the checker keeps, by the sha256 of its exact bytes: the facts of a check its verdict is asked of, or the heads its seat list is asked of, as a run ask names it (its input's verb and digest). Answers the digest and the bytes, base64; a digest it keeps no input of is an error. Asked by the build module that runs the program, as its manifest's invokes grants it. Read-only.", - "optional": true, - "input": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the input's sha256, 64 lowercase hex digits, as the run ask names it" - } - }, - "required": [ - "digest" - ] - }, - "answer": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the digest asked" - }, - "input": { - "type": "string", - "description": "the input's exact bytes, base64, so no encoding on the way changes a byte the digest covers" - } - }, - "required": [ - "digest", - "input" - ] - } - } - ], - "description": "The merge check's tries: start one, read one, end one. The seat says each check's end as checked and what the checker owes the forge as owed; the checker's other events stay under its own subjects (ADR 0620 §2).", - "family": { - "name": "mesh-delivery-checker.events", - "max-age-days": 7 - }, - "events": [ - { - "name": "checked", - "body": { - "type": "object", - "description": "a candidate checked: its entries judged at the group's heads (design 47 *What each step says*)", - "properties": { - "group": { - "type": "string", - "description": "the group, its branch" - }, - "heads": { - "type": "string", - "description": "the heads checked, 12 hex digits, as the candidate's revisions are keyed" - }, - "source": { - "type": "integer", - "description": "the source revision the heads are merged onto" - }, - "catalog": { - "type": "integer", - "description": "the candidate's catalog graph revision judged, by its number on the seat mesh-catalog" - }, - "verdict": { - "type": "string", - "enum": [ - "pass", - "fail", - "could not run" - ], - "description": "pass, fail, or could not run when a part the check needs did not answer" - }, - "words": { - "type": "string", - "description": "what failed first, or the part not heard" - }, - "entries": { - "type": "array", - "items": { - "$ref": "#/defs/CheckedEntry" - }, - "description": "the entries checked" - }, - "at": { - "type": "string", - "format": "date-time", - "description": "when" - } - }, - "required": [ - "group", - "heads", - "verdict" - ] - } - }, - { - "name": "owed", - "subject": "owed..", - "body": { - "$ref": "#/defs/Owed" - }, - "keep": { - "max-age-days": 7, - "max-mib": 64 - } - } - ], - "holder-events": [ - { - "name": "verdict", - "subject": "mesh.stream..event.verdict", - "family": "checker.asks", - "body": { - "type": "object", - "properties": { - "repository": { - "type": "string", - "description": "owner/repo" - }, - "pull": { - "type": "integer", - "description": "the pull request's number, for a pull request's check" - }, - "head": { - "type": "string", - "description": "the commit checked" - }, - "verdict": { - "type": "string", - "description": "pass or fail" - }, - "out-of-step": { - "type": "array", - "items": { - "type": "string" - }, - "description": "the generated files out of step with their seat definitions, each path (design 26)" - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string", - "description": "the module whose artifact's series changes" - }, - "artifact": { - "type": "string", - "description": "its artifact, or the package's ecosystem name as the module's packages name it" - }, - "from": { - "type": "string", - "description": "the series on trunk" - }, - "to": { - "type": "string", - "description": "the series the checked head gives it" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - }, - "description": "each change of an artifact's series the checked head makes against trunk's manifests, once each (design 32); absent when it changes none" - } - }, - "required": [ - "repository", - "head", - "verdict" - ] - } - }, - { - "name": "preview.written", - "subject": "mesh.stream..event.preview.written", - "family": "checks" - } - ], - "states": [ - { - "name": "verdicts", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "group": { - "type": "string" - }, - "heads": { - "type": "string", - "description": "12 hex digits" - }, - "trunk": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "repository to the trunk head merged onto" - }, - "state": { - "type": "string", - "description": "running, pass or fail" - }, - "failed": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - }, - "failures": { - "type": "array", - "items": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - } - }, - "levels": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "run": { - "type": "integer" - }, - "kept": { - "type": "integer" - }, - "skipped": { - "type": "integer" - } - }, - "required": [ - "run", - "kept" - ] - }, - "description": "by level, unit or integration" - }, - "took": { - "type": "object", - "properties": { - "queue": { - "type": "integer" - }, - "clone": { - "type": "integer" - }, - "unit": { - "type": "integer" - }, - "lint": { - "type": "integer" - }, - "integration-setup": { - "type": "integer" - }, - "integration-run": { - "type": "integer" - }, - "composition": { - "type": "integer" - } - }, - "description": "milliseconds" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "sdk": { - "type": "string" - }, - "composition": { - "type": "object", - "properties": { - "state": { - "type": "string", - "description": "not-run, pass or fail" - }, - "words": { - "type": "string" - }, - "sdk": { - "type": "string" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "fpset": { - "type": "string" - } - }, - "required": [ - "state" - ] - }, - "over-bound": { - "type": "array", - "items": { - "type": "string" - } - }, - "beside": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "carried-from": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string" - }, - "artifact": { - "type": "string" - }, - "from": { - "type": "string" - }, - "to": { - "type": "string" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - } - }, - "judged-by": { - "type": "object", - "description": "the checking program that judged the check: where it was built, the key its build is kept under, whether this check's run built it, and the heads it read (ADR 0644, ADR 0656). Absent in a value written before it", - "properties": { - "program": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - }, - "dir": { - "type": "string" - }, - "package": { - "type": "string" - } - }, - "required": [ - "repository", - "commit", - "dir", - "package" - ] - }, - "key": { - "type": "string", - "description": "program- and 16 hex digits" - }, - "built": { - "type": "boolean" - }, - "heads": { - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - } - }, - "required": [ - "repository", - "commit" - ] - } - } - }, - "required": [ - "program", - "key", - "heads" - ] - } - }, - "required": [ - "group", - "heads", - "state" - ], - "description": "one check of a group at one set of heads" - }, - "description": "one check of a group; the group is an escaped branch name, heads 12 hex digits" - } - ], - "description": "the checker's verdict of each group at each set of heads", - "history": 5 - }, - { - "name": "kept", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "state": { - "type": "string", - "description": "pass: a failure is never kept" - }, - "repository": { - "type": "string" - }, - "package": { - "type": "string" - }, - "level": { - "type": "string" - }, - "tests": { - "type": "integer" - }, - "took": { - "type": "integer" - }, - "toolchain": { - "type": "string" - }, - "at": { - "type": "string", - "description": "when (RFC 3339 time)" - } - }, - "required": [ - "state", - "repository", - "package", - "level" - ], - "description": "one passing level of one package, kept so the next check does not run it again" - }, - "description": "a passing level of one package by its content digest" - } - ], - "description": "the kept passing levels", - "history": 1 - }, - { - "name": "owed", - "template": "state", - "key-forms": [ - { - "key": "...", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "act": { - "type": "string", - "description": "status=, view, note or comment." - }, - "context": { - "type": "string" - }, - "target": { - "type": "string" - }, - "state": { - "type": "string" - }, - "text": { - "type": "string" - }, - "ref": { - "type": "string" - } - }, - "required": [ - "act" - ], - "description": "one act owed to the forge, written by its owner and done by the forge bridge" - }, - "description": "the status mesh/check the checker owes the forge for a head (its act is status=mesh/check)" - } - ], - "description": "the status the checker owes the forge", - "history": 5 - }, - { - "name": "previews", - "template": "state", - "key-forms": [ - { - "key": "..", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "repository": { - "type": "string" - }, - "head": { - "type": "string" - }, - "trunk": { - "type": "string" - }, - "merge": { - "type": "string", - "description": "the merge commit" - }, - "conflicts": { - "type": "array", - "items": { - "type": "string" - }, - "description": "files in conflict" - }, - "modules": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "tree": { - "type": "string" - }, - "manifest": { - "type": "string", - "description": "manifest digest" - }, - "locks": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "paths": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "packages": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "tree", - "manifest" - ] - }, - "description": "by directory" - } - }, - "required": [ - "repository", - "head", - "trunk" - ], - "description": "the merge of a head onto a trunk commit, read before a pull request is checked" - }, - "description": "the merge of a head onto a trunk commit" - } - ], - "description": "the previews of a head merged onto a trunk", - "history": 5 - } - ], - "defs": { - "Owed": { - "type": "object", - "description": "the status the checker owes the forge for a head, said under its id and safe to repeat (a status replaces what stands); the forge bridge performs it through the seat git's verb status (design 47 *What the gate owes the forge*)", - "properties": { - "id": { - "type": "string", - "description": "the act's id, the same each time it is said again" - }, - "act": { - "type": "string", - "enum": [ - "status" - ], - "description": "the act: always status" - }, - "repository": { - "type": "string", - "description": "the repository, /", - "minLength": 1 - }, - "number": { - "type": "integer", - "description": "the pull request's number" - }, - "head": { - "type": "string", - "description": "the pull request's head the status is on", - "pattern": "^[0-9a-f]{40}$" - }, - "context": { - "type": "string", - "description": "its context, mesh/check" - }, - "state": { - "type": "string", - "description": "pending, success, failure or error" - }, - "description": { - "type": "string", - "description": "what it says" - }, - "target": { - "type": "string", - "description": "the page it links to" - }, - "said": { - "type": "string", - "format": "date-time", - "description": "when the checker first said it" - } - }, - "required": [ - "id", - "act", - "repository", - "number", - "head", - "context", - "state" - ] - }, - "CheckedEntry": { - "type": "object", - "description": "one entry of the candidate checked: a module at its fingerprint", - "properties": { - "module": { - "type": "string", - "description": "the module" - }, - "fp": { - "type": "string", - "description": "the entry's fingerprint" - }, - "node": { - "type": "string", - "description": "the node it was composed for, when the check composed it on one" - } - }, - "required": [ - "module", - "fp" - ] - } - } -} diff --git a/go/seatlist/bootstrap/mesh-delivery.json b/go/seatlist/bootstrap/mesh-delivery.json index 93f31549..f6f75f8b 100644 --- a/go/seatlist/bootstrap/mesh-delivery.json +++ b/go/seatlist/bootstrap/mesh-delivery.json @@ -164,10 +164,6 @@ { "name": "recovery", "class": "act", - "callers": [ - "operator", - "sessions" - ], "description": "Mark a merge its author names a recovery: the commit and why; the delivery record is marked recovery with the caller the runtime proves, and recovery-merged is said (design 47 G section 305).", "input": { "type": "object", diff --git a/go/seatlist/bootstrap_contracts_test.go b/go/seatlist/bootstrap_contracts_test.go index ccf5d585..797a3926 100644 --- a/go/seatlist/bootstrap_contracts_test.go +++ b/go/seatlist/bootstrap_contracts_test.go @@ -25,7 +25,6 @@ func TestEveryBootstrappedDefinitionEqualsItsContractsFile(t *testing.T) { {"mesh-watchdogs", "mesh-contracts", "health-and-repair/seats/mesh-watchdogs/seat.json"}, {"operator-channel", "mesh-contracts", "operator-and-conversation/seats/operator-channel/seat.json"}, {"mesh-catalog", "mesh-delivery", "modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json"}, - {"mesh-delivery-checker", "mesh-delivery", "modules/mesh-delivery-contracts/seats/mesh-delivery-checker/seat.json"}, {"mesh-delivery", "mesh-delivery", "modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json"}, {"git", "mesh-delivery", "modules/mesh-delivery-contracts/seats/git/seat.json"}, } diff --git a/go/seatlist/seatlisttest/parts/registry.json b/go/seatlist/seatlisttest/parts/registry.json index ca0022f8..1a02c7e0 100644 --- a/go/seatlist/seatlisttest/parts/registry.json +++ b/go/seatlist/seatlisttest/parts/registry.json @@ -6,7 +6,6 @@ { "name": "publish", "description": "Open a transfer, naming the artifact and the digest of every part; answers the digests the holder lacks, which the caller then sends by publish-part. A transfer already open answers the parts held, so a cut transfer goes on from there. With no parts and a version, the held digest is published under that version and nothing is stored (the trunk's claim).", - "callers": "the build modules", "input": { "type": "object", "properties": { @@ -92,7 +91,6 @@ { "name": "publish-part", "description": "Send one chunk of one part of an open transfer; the last chunk of the last part ends the transfer, and the holder hashes what it received, asks builder_versions, stores it and says published or refused. A chunk's message stays under the bus's largest message (1 MiB), so at most 760 KiB of data, base64.", - "callers": "the build modules, and only the proved caller that opened the transfer", "input": { "type": "object", "properties": { @@ -155,7 +153,6 @@ { "name": "versions", "description": "The versions the seat holds of one name, newest first: each one's version, tag, digest, kind and when it was published.", - "callers": "any caller whose role grants it", "input": { "type": "object", "properties": { @@ -197,7 +194,6 @@ { "name": "remove", "description": "Remove one tagged version; the holder refuses an untagged one but for the retention removal of a bundle, archive or copied base by the artifact sweep's holder. Every removal emits removed with its reason. A tagged version the store cannot remove alone, because another tag names its digest, stays whole, its tag and bytes kept: the answer says kept with the reason shared-digest and the tags still naming the digest, removed false, and kept is emitted, never removed; the caller ends there without a retry.", - "callers": "the builder, for a tagged version; the artifact sweep's holder, for retention", "input": { "type": "object", "properties": { diff --git a/go/seatlist/seatlisttest/seats/container-image-registry.json b/go/seatlist/seatlisttest/seats/container-image-registry.json index 2afa16bc..ef6d16cd 100644 --- a/go/seatlist/seatlisttest/seats/container-image-registry.json +++ b/go/seatlist/seatlisttest/seats/container-image-registry.json @@ -13,9 +13,6 @@ { "name": "mirror", "description": "Copy an outside image into the store by its pinned digest; emits published or refused.", - "callers": [ - "seat:node-build-image" - ], "input": { "type": "object", "properties": { @@ -60,9 +57,6 @@ { "name": "tags", "description": "The tags of one image and the digest each names.", - "callers": [ - "invokers" - ], "input": { "type": "object", "properties": { @@ -114,9 +108,6 @@ { "name": "hold", "description": "Keep one untagged bundle, archive or copied base from removal by retention, as the artifact sweep's rules keep it (ADR 0617 \u00a72); never an image of the holder's own. Emits held.", - "callers": [ - "seat:mesh-artifact-sweep" - ], "input": { "type": "object", "properties": { @@ -160,9 +151,6 @@ { "name": "release", "description": "Let a hold go; emits released. A release of what is not held answers released false and emits nothing, never an error: the outcome asked holds already. By hand only through the holder's own tool, the operator's session as the proved caller, recorded as a hand act.", - "callers": [ - "seat:mesh-artifact-sweep" - ], "input": { "type": "object", "properties": { @@ -202,9 +190,6 @@ { "name": "list", "description": "What the store holds of one repository, or of every repository the seat holds when none is named: every image manifest and index, each with its digest, whether it is an index (and the manifests an index names), the tags naming it, its size and whether it is held. Read from the store itself, so a manifest no tag names is listed too; it reads only (ADR 0632 \u00a73).", - "callers": [ - "invokers" - ], "input": { "type": "object", "properties": { diff --git a/go/seatlist/seatlisttest/seats/git.json b/go/seatlist/seatlisttest/seats/git.json index 283ca432..c24a4f12 100644 --- a/go/seatlist/seatlisttest/seats/git.json +++ b/go/seatlist/seatlisttest/seats/git.json @@ -52,9 +52,6 @@ }, "description": "what pull answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -107,9 +104,6 @@ }, "description": "what branch answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -143,9 +137,6 @@ "pulls" ] }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -210,9 +201,6 @@ }, "description": "what tags answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -304,9 +292,6 @@ }, "description": "what trees answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -373,9 +358,6 @@ }, "description": "what file answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -436,9 +418,6 @@ }, "description": "what contains answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -493,9 +472,6 @@ }, "description": "what statuses answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -578,9 +554,6 @@ }, "description": "what status answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -642,9 +615,6 @@ }, "description": "what comment answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -706,9 +676,6 @@ }, "description": "what view answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -771,9 +738,6 @@ }, "description": "what note answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -866,18 +830,11 @@ }, "description": "what merge-pull answers; error and error-kind alone when it fails" }, - "callers": [ - "persons", - "sessions" - ], "class": "act" }, { "name": "tag", "class": "act", - "callers": [ - "seat:mesh-builds" - ], "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.", "input": { "type": "object", diff --git a/go/seatlist/seatlisttest/seats/mesh-catalog.json b/go/seatlist/seatlisttest/seats/mesh-catalog.json index f8163534..ba7fdd0f 100644 --- a/go/seatlist/seatlisttest/seats/mesh-catalog.json +++ b/go/seatlist/seatlisttest/seats/mesh-catalog.json @@ -355,10 +355,6 @@ { "name": "register", "description": "Register a module whole, as an authorising ask of tier approve naming every value; written only on its warrant, a Decline or an expiry writes nothing. Refuses a watched branch the forge does not protect, read through the seat git's branch, and code review as a required step until forge accounts are bound to bus identities (ADR 0666 sections 2, 3, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -381,10 +377,6 @@ { "name": "policy", "description": "Change one module's step statuses, or one artifact's, as an authorising ask naming each moved status on its own line; refuses code review as required (ADR 0666 sections 2, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -415,10 +407,6 @@ { "name": "watch", "description": "Add a watched branch to a module's registration, as an authorising ask; refuses a branch the forge does not protect, naming it (ADR 0666 sections 2, 3).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -445,10 +433,6 @@ { "name": "unwatch", "description": "Remove a watched branch from a module's registration, as an authorising ask (ADR 0666 section 2).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -475,15 +459,6 @@ { "name": "versions", "class": "read", - "callers": [ - "seat:mesh-builds", - "seat:go-package-registry", - "seat:npm-package-registry", - "seat:container-image-registry", - "seat:oci-artifact-registry", - "persons", - "sessions" - ], "description": "A module's released versions, each artifact's digest, the source revision built and its edge entries; a reserved version is not in it (design 47 G section 349).", "input": { "type": "object", @@ -520,12 +495,6 @@ { "name": "outdated", "class": "read", - "callers": [ - "persons", - "sessions", - "healers", - "seat:mesh-pipeline-runner" - ], "description": "Every entry behind, by the part's digest: its module and version or build, the kind, the dependency with its watched branch and source revision, what was recorded and what is newest, and the act; may be asked for one dependency (design 47 G section 375).", "input": { "type": "object", @@ -558,11 +527,6 @@ { "name": "input", "class": "read", - "callers": [ - "seat:node-build-go", - "seat:node-build-node", - "seat:node-build-image" - ], "description": "A step's input by its digest, as the indexer keeps it for a validation step it asked a build seat to run (design 47 G section 354): its fields, then the bytes in chunks of at most 512 KiB on the chunk subject of the call, each acknowledged by the caller on the ack subject within 30 seconds; the input is of any size.", "input": { "type": "object", diff --git a/go/seatlist/seatlisttest/seats/mesh-delivery-checker.json b/go/seatlist/seatlisttest/seats/mesh-delivery-checker.json deleted file mode 100644 index 73ec5712..00000000 --- a/go/seatlist/seatlisttest/seats/mesh-delivery-checker.json +++ /dev/null @@ -1,862 +0,0 @@ -{ - "format": 1, - "seat": "mesh-delivery-checker", - "scope": "mesh", - "grain": "whole", - "domain": "Delivery", - "decision": "novox/hq ADR 0547", - "verbs": [ - { - "name": "try", - "description": "Try pushed heads before their pull requests are opened: the checker judges them as it judges a delivery group's pull requests, each member merged onto its trunk, its unit and integration levels through the build modules, then the members' manifests, the module graph and the composition on every placed node, and owes the forge nothing. Name the group's members (each a repository and the exact commit), or one repository and its head for a try of one member. Answers the try's id at once; try-read reads where it stands. The same members at the same commits, in any order, are the answer to a second ask while that try waits or runs; at most 4 run on a build node, and 8 wait for one, mesh-wide.", - "optional": true, - "replaces": [ - "sh merge-check.sh", - "docker run postgres" - ], - "input": { - "properties": { - "head": { - "description": "the full commit to try, 40 or 64 hex digits, for a try of one member (instead of members)", - "type": "string" - }, - "level": { - "description": "unit or integration: only this level; both when absent", - "type": "string" - }, - "repository": { - "description": "/, for a try of one member (instead of members)", - "type": "string" - }, - "tests": { - "description": "a go test -run pattern: only those tests run, and nothing is kept", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - }, - "members": { - "description": "the group: one repository at most once, each at the exact commit asked and the trunk commit it is merged onto; instead of repository and head", - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "description": "/", - "type": "string" - }, - "head": { - "description": "the full commit to try, 40 or 64 hex digits", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - } - }, - "required": [ - "repository", - "head" - ] - } - } - }, - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try's id" - }, - "state": { - "type": "string", - "description": "its state" - } - }, - "required": [ - "id" - ] - } - }, - { - "name": "try-read", - "description": "Where a try stands, as stored: queued, running, or its end (pass, fail, or error when it could not run), with what was said of it, the head and the trunk commit it was merged onto, the time it took and what failed first. Read-only.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - } - }, - "required": [ - "id" - ], - "type": "object" - }, - "answer": { - "type": "object", - "description": "the try: its state, its steps and its verdict when it has one" - } - }, - { - "name": "try-end", - "description": "End a try that waits or runs, as error, by hand: say why (kept in what it says). Its place among the tries is free at once and the next try of its head asks anew with a new id. A try that ended already is refused.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - }, - "why": { - "description": "why it is ended, in words", - "type": "string" - } - }, - "required": [ - "id", - "why" - ], - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try" - }, - "ended": { - "type": "boolean", - "description": "it is ended" - } - }, - "required": [ - "id", - "ended" - ] - } - }, - { - "name": "input", - "description": "A checking program's input the checker keeps, by the sha256 of its exact bytes: the facts of a check its verdict is asked of, or the heads its seat list is asked of, as a run ask names it (its input's verb and digest). Answers the digest and the bytes, base64; a digest it keeps no input of is an error. Asked by the build module that runs the program, as its manifest's invokes grants it. Read-only.", - "optional": true, - "input": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the input's sha256, 64 lowercase hex digits, as the run ask names it" - } - }, - "required": [ - "digest" - ] - }, - "answer": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the digest asked" - }, - "input": { - "type": "string", - "description": "the input's exact bytes, base64, so no encoding on the way changes a byte the digest covers" - } - }, - "required": [ - "digest", - "input" - ] - } - } - ], - "description": "The merge check's tries: start one, read one, end one. The seat says each check's end as checked and what the checker owes the forge as owed; the checker's other events stay under its own subjects (ADR 0620 §2).", - "family": { - "name": "mesh-delivery-checker.events", - "max-age-days": 7 - }, - "events": [ - { - "name": "checked", - "body": { - "type": "object", - "description": "a candidate checked: its entries judged at the group's heads (design 47 *What each step says*)", - "properties": { - "group": { - "type": "string", - "description": "the group, its branch" - }, - "heads": { - "type": "string", - "description": "the heads checked, 12 hex digits, as the candidate's revisions are keyed" - }, - "source": { - "type": "integer", - "description": "the source revision the heads are merged onto" - }, - "catalog": { - "type": "integer", - "description": "the candidate's catalog graph revision judged, by its number on the seat mesh-catalog" - }, - "verdict": { - "type": "string", - "enum": [ - "pass", - "fail", - "could not run" - ], - "description": "pass, fail, or could not run when a part the check needs did not answer" - }, - "words": { - "type": "string", - "description": "what failed first, or the part not heard" - }, - "entries": { - "type": "array", - "items": { - "$ref": "#/defs/CheckedEntry" - }, - "description": "the entries checked" - }, - "at": { - "type": "string", - "format": "date-time", - "description": "when" - } - }, - "required": [ - "group", - "heads", - "verdict" - ] - } - }, - { - "name": "owed", - "subject": "owed..", - "body": { - "$ref": "#/defs/Owed" - }, - "keep": { - "max-age-days": 7, - "max-mib": 64 - } - } - ], - "holder-events": [ - { - "name": "verdict", - "subject": "mesh.stream..event.verdict", - "family": "checker.asks", - "body": { - "type": "object", - "properties": { - "repository": { - "type": "string", - "description": "owner/repo" - }, - "pull": { - "type": "integer", - "description": "the pull request's number, for a pull request's check" - }, - "head": { - "type": "string", - "description": "the commit checked" - }, - "verdict": { - "type": "string", - "description": "pass or fail" - }, - "out-of-step": { - "type": "array", - "items": { - "type": "string" - }, - "description": "the generated files out of step with their seat definitions, each path (design 26)" - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string", - "description": "the module whose artifact's series changes" - }, - "artifact": { - "type": "string", - "description": "its artifact, or the package's ecosystem name as the module's packages name it" - }, - "from": { - "type": "string", - "description": "the series on trunk" - }, - "to": { - "type": "string", - "description": "the series the checked head gives it" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - }, - "description": "each change of an artifact's series the checked head makes against trunk's manifests, once each (design 32); absent when it changes none" - } - }, - "required": [ - "repository", - "head", - "verdict" - ] - } - }, - { - "name": "preview.written", - "subject": "mesh.stream..event.preview.written", - "family": "checks" - } - ], - "states": [ - { - "name": "verdicts", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "group": { - "type": "string" - }, - "heads": { - "type": "string", - "description": "12 hex digits" - }, - "trunk": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "repository to the trunk head merged onto" - }, - "state": { - "type": "string", - "description": "running, pass or fail" - }, - "failed": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - }, - "failures": { - "type": "array", - "items": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - } - }, - "levels": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "run": { - "type": "integer" - }, - "kept": { - "type": "integer" - }, - "skipped": { - "type": "integer" - } - }, - "required": [ - "run", - "kept" - ] - }, - "description": "by level, unit or integration" - }, - "took": { - "type": "object", - "properties": { - "queue": { - "type": "integer" - }, - "clone": { - "type": "integer" - }, - "unit": { - "type": "integer" - }, - "lint": { - "type": "integer" - }, - "integration-setup": { - "type": "integer" - }, - "integration-run": { - "type": "integer" - }, - "composition": { - "type": "integer" - } - }, - "description": "milliseconds" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "sdk": { - "type": "string" - }, - "composition": { - "type": "object", - "properties": { - "state": { - "type": "string", - "description": "not-run, pass or fail" - }, - "words": { - "type": "string" - }, - "sdk": { - "type": "string" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "fpset": { - "type": "string" - } - }, - "required": [ - "state" - ] - }, - "over-bound": { - "type": "array", - "items": { - "type": "string" - } - }, - "beside": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "carried-from": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string" - }, - "artifact": { - "type": "string" - }, - "from": { - "type": "string" - }, - "to": { - "type": "string" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - } - }, - "judged-by": { - "type": "object", - "description": "the checking program that judged the check: where it was built, the key its build is kept under, whether this check's run built it, and the heads it read (ADR 0644, ADR 0656). Absent in a value written before it", - "properties": { - "program": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - }, - "dir": { - "type": "string" - }, - "package": { - "type": "string" - } - }, - "required": [ - "repository", - "commit", - "dir", - "package" - ] - }, - "key": { - "type": "string", - "description": "program- and 16 hex digits" - }, - "built": { - "type": "boolean" - }, - "heads": { - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - } - }, - "required": [ - "repository", - "commit" - ] - } - } - }, - "required": [ - "program", - "key", - "heads" - ] - } - }, - "required": [ - "group", - "heads", - "state" - ], - "description": "one check of a group at one set of heads" - }, - "description": "one check of a group; the group is an escaped branch name, heads 12 hex digits" - } - ], - "description": "the checker's verdict of each group at each set of heads", - "history": 5 - }, - { - "name": "kept", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "state": { - "type": "string", - "description": "pass: a failure is never kept" - }, - "repository": { - "type": "string" - }, - "package": { - "type": "string" - }, - "level": { - "type": "string" - }, - "tests": { - "type": "integer" - }, - "took": { - "type": "integer" - }, - "toolchain": { - "type": "string" - }, - "at": { - "type": "string", - "description": "when (RFC 3339 time)" - } - }, - "required": [ - "state", - "repository", - "package", - "level" - ], - "description": "one passing level of one package, kept so the next check does not run it again" - }, - "description": "a passing level of one package by its content digest" - } - ], - "description": "the kept passing levels", - "history": 1 - }, - { - "name": "owed", - "template": "state", - "key-forms": [ - { - "key": "...", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "act": { - "type": "string", - "description": "status=, view, note or comment." - }, - "context": { - "type": "string" - }, - "target": { - "type": "string" - }, - "state": { - "type": "string" - }, - "text": { - "type": "string" - }, - "ref": { - "type": "string" - } - }, - "required": [ - "act" - ], - "description": "one act owed to the forge, written by its owner and done by the forge bridge" - }, - "description": "the status mesh/check the checker owes the forge for a head (its act is status=mesh/check)" - } - ], - "description": "the status the checker owes the forge", - "history": 5 - }, - { - "name": "previews", - "template": "state", - "key-forms": [ - { - "key": "..", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "repository": { - "type": "string" - }, - "head": { - "type": "string" - }, - "trunk": { - "type": "string" - }, - "merge": { - "type": "string", - "description": "the merge commit" - }, - "conflicts": { - "type": "array", - "items": { - "type": "string" - }, - "description": "files in conflict" - }, - "modules": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "tree": { - "type": "string" - }, - "manifest": { - "type": "string", - "description": "manifest digest" - }, - "locks": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "paths": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "packages": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "tree", - "manifest" - ] - }, - "description": "by directory" - } - }, - "required": [ - "repository", - "head", - "trunk" - ], - "description": "the merge of a head onto a trunk commit, read before a pull request is checked" - }, - "description": "the merge of a head onto a trunk commit" - } - ], - "description": "the previews of a head merged onto a trunk", - "history": 5 - } - ], - "defs": { - "Owed": { - "type": "object", - "description": "the status the checker owes the forge for a head, said under its id and safe to repeat (a status replaces what stands); the forge bridge performs it through the seat git's verb status (design 47 *What the gate owes the forge*)", - "properties": { - "id": { - "type": "string", - "description": "the act's id, the same each time it is said again" - }, - "act": { - "type": "string", - "enum": [ - "status" - ], - "description": "the act: always status" - }, - "repository": { - "type": "string", - "description": "the repository, /", - "minLength": 1 - }, - "number": { - "type": "integer", - "description": "the pull request's number" - }, - "head": { - "type": "string", - "description": "the pull request's head the status is on", - "pattern": "^[0-9a-f]{40}$" - }, - "context": { - "type": "string", - "description": "its context, mesh/check" - }, - "state": { - "type": "string", - "description": "pending, success, failure or error" - }, - "description": { - "type": "string", - "description": "what it says" - }, - "target": { - "type": "string", - "description": "the page it links to" - }, - "said": { - "type": "string", - "format": "date-time", - "description": "when the checker first said it" - } - }, - "required": [ - "id", - "act", - "repository", - "number", - "head", - "context", - "state" - ] - }, - "CheckedEntry": { - "type": "object", - "description": "one entry of the candidate checked: a module at its fingerprint", - "properties": { - "module": { - "type": "string", - "description": "the module" - }, - "fp": { - "type": "string", - "description": "the entry's fingerprint" - }, - "node": { - "type": "string", - "description": "the node it was composed for, when the check composed it on one" - } - }, - "required": [ - "module", - "fp" - ] - } - } -} diff --git a/go/seatlist/seatlisttest/seats/mesh-delivery.json b/go/seatlist/seatlisttest/seats/mesh-delivery.json index 93f31549..f6f75f8b 100644 --- a/go/seatlist/seatlisttest/seats/mesh-delivery.json +++ b/go/seatlist/seatlisttest/seats/mesh-delivery.json @@ -164,10 +164,6 @@ { "name": "recovery", "class": "act", - "callers": [ - "operator", - "sessions" - ], "description": "Mark a merge its author names a recovery: the commit and why; the delivery record is marked recovery with the caller the runtime proves, and recovery-merged is said (design 47 G section 305).", "input": { "type": "object", diff --git a/go/seatlist/seatlisttest/seats/mesh-vault.json b/go/seatlist/seatlisttest/seats/mesh-vault.json index 749f1482..e2372428 100644 --- a/go/seatlist/seatlisttest/seats/mesh-vault.json +++ b/go/seatlist/seatlisttest/seats/mesh-vault.json @@ -597,9 +597,6 @@ "name": "retire", "optional": true, "description": "Retire one module's own secret, by node, module and name, on the operator's warrant bound to exactly those three (design 32 *A value no longer read*). Emits own-retired.", - "callers": [ - "seat:mesh-config" - ], "input": { "type": "object", "properties": { diff --git a/go/seatlist/seatlisttest/seats/mesh-wants.json b/go/seatlist/seatlisttest/seats/mesh-wants.json index e002258b..cb1ef5dc 100644 --- a/go/seatlist/seatlisttest/seats/mesh-wants.json +++ b/go/seatlist/seatlisttest/seats/mesh-wants.json @@ -159,11 +159,6 @@ { "name": "input", "class": "read", - "callers": [ - "seat:node-build-go", - "seat:node-build-node", - "seat:node-build-image" - ], "description": "A step's input by its digest, as the assigner keeps it for the composition step it asked a build seat to run (design 47 G section 354).", "input": { "type": "object", @@ -201,10 +196,7 @@ "name": "step", "body": { "$ref": "#/defs/StepRun" - }, - "callers": [ - "seat:mesh-pipeline-runner" - ] + } } ], "events": [ diff --git a/go/seatlist/seatlisttest/seats/node-build-go.json b/go/seatlist/seatlisttest/seats/node-build-go.json index 0e720750..6a69afa0 100644 --- a/go/seatlist/seatlisttest/seats/node-build-go.json +++ b/go/seatlist/seatlisttest/seats/node-build-go.json @@ -19,51 +19,31 @@ "name": "delivery", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-builds" - ] + } }, { "name": "check", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker", - "seat:mesh-catalog", - "seat:mesh-pipeline-runner" - ] + } }, { "name": "step", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-pipeline-runner" - ] + } }, { "name": "recheck", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker" - ] + } }, { "name": "run", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-pipeline-runner", - "seat:mesh-catalog", - "seat:mesh-wants", - "seat:mesh-delivery-checker" - ] + } } ], "description": "The Go build module on a node: it takes the asks of the builder and the checker, runs them as steps and answers.", diff --git a/go/seatlist/seatlisttest/seats/node-build-image.json b/go/seatlist/seatlisttest/seats/node-build-image.json index 383860af..ba029710 100644 --- a/go/seatlist/seatlisttest/seats/node-build-image.json +++ b/go/seatlist/seatlisttest/seats/node-build-image.json @@ -12,37 +12,25 @@ "name": "delivery", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-builds" - ] + } }, { "name": "check", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker" - ] + } }, { "name": "step", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-pipeline-runner" - ] + } }, { "name": "recheck", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker" - ] + } } ], "description": "The image build module on a node: it takes the asks of the builder and the checker, runs them as steps and answers.", diff --git a/go/seatlist/seatlisttest/seats/node-build-node.json b/go/seatlist/seatlisttest/seats/node-build-node.json index dd03154f..3a240daa 100644 --- a/go/seatlist/seatlisttest/seats/node-build-node.json +++ b/go/seatlist/seatlisttest/seats/node-build-node.json @@ -19,37 +19,25 @@ "name": "delivery", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-builds" - ] + } }, { "name": "check", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker" - ] + } }, { "name": "step", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-pipeline-runner" - ] + } }, { "name": "recheck", "body": { "$ref": "#/defs/StepAsk" - }, - "callers": [ - "seat:mesh-delivery-checker" - ] + } } ], "description": "The Node build module on a node: it takes the asks of the builder and the checker, runs them as steps and answers.", diff --git a/go/seatlist/seatlisttest/seats/oci-artifact-registry.json b/go/seatlist/seatlisttest/seats/oci-artifact-registry.json index 5db56ae1..a4fda915 100644 --- a/go/seatlist/seatlisttest/seats/oci-artifact-registry.json +++ b/go/seatlist/seatlisttest/seats/oci-artifact-registry.json @@ -13,9 +13,6 @@ { "name": "hold", "description": "Keep one untagged bundle, archive or copied base from removal by retention, as the artifact sweep's rules keep it (ADR 0617 \u00a72); never an image of the holder's own. Emits held.", - "callers": [ - "seat:mesh-artifact-sweep" - ], "input": { "type": "object", "properties": { @@ -59,9 +56,6 @@ { "name": "release", "description": "Let a hold go; emits released. A release of what is not held answers released false and emits nothing, never an error: the outcome asked holds already. By hand only through the holder's own tool, the operator's session as the proved caller, recorded as a hand act.", - "callers": [ - "seat:mesh-artifact-sweep" - ], "input": { "type": "object", "properties": { @@ -101,9 +95,6 @@ { "name": "list", "description": "What the store holds of one repository, or of every repository the seat holds when none is named: every manifest keeping one bundle or archive, each with its digest, whether it is an index (and the manifests an index names), the tags naming it, its size and whether it is held. Read from the store itself, so a manifest no tag names is listed too; it reads only (ADR 0632 \u00a73).", - "callers": [ - "invokers" - ], "input": { "type": "object", "properties": { diff --git a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/git/seat.json.captured b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/git/seat.json.captured index 283ca432..c24a4f12 100644 --- a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/git/seat.json.captured +++ b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/git/seat.json.captured @@ -52,9 +52,6 @@ }, "description": "what pull answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -107,9 +104,6 @@ }, "description": "what branch answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -143,9 +137,6 @@ "pulls" ] }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -210,9 +201,6 @@ }, "description": "what tags answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -304,9 +292,6 @@ }, "description": "what trees answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -373,9 +358,6 @@ }, "description": "what file answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -436,9 +418,6 @@ }, "description": "what contains answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -493,9 +472,6 @@ }, "description": "what statuses answers; error and error-kind alone when it fails" }, - "callers": [ - "invokers" - ], "class": "read" }, { @@ -578,9 +554,6 @@ }, "description": "what status answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -642,9 +615,6 @@ }, "description": "what comment answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -706,9 +676,6 @@ }, "description": "what view answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -771,9 +738,6 @@ }, "description": "what note answers; error and error-kind alone when it fails" }, - "callers": [ - "module:mesh-delivery-forge-bridge" - ], "class": "act" }, { @@ -866,18 +830,11 @@ }, "description": "what merge-pull answers; error and error-kind alone when it fails" }, - "callers": [ - "persons", - "sessions" - ], "class": "act" }, { "name": "tag", "class": "act", - "callers": [ - "seat:mesh-builds" - ], "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.", "input": { "type": "object", diff --git a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json.captured b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json.captured index f8163534..ba7fdd0f 100644 --- a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json.captured +++ b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json.captured @@ -355,10 +355,6 @@ { "name": "register", "description": "Register a module whole, as an authorising ask of tier approve naming every value; written only on its warrant, a Decline or an expiry writes nothing. Refuses a watched branch the forge does not protect, read through the seat git's branch, and code review as a required step until forge accounts are bound to bus identities (ADR 0666 sections 2, 3, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -381,10 +377,6 @@ { "name": "policy", "description": "Change one module's step statuses, or one artifact's, as an authorising ask naming each moved status on its own line; refuses code review as required (ADR 0666 sections 2, 22).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -415,10 +407,6 @@ { "name": "watch", "description": "Add a watched branch to a module's registration, as an authorising ask; refuses a branch the forge does not protect, naming it (ADR 0666 sections 2, 3).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -445,10 +433,6 @@ { "name": "unwatch", "description": "Remove a watched branch from a module's registration, as an authorising ask (ADR 0666 section 2).", - "callers": [ - "operator", - "sessions" - ], "input": { "type": "object", "properties": { @@ -475,15 +459,6 @@ { "name": "versions", "class": "read", - "callers": [ - "seat:mesh-builds", - "seat:go-package-registry", - "seat:npm-package-registry", - "seat:container-image-registry", - "seat:oci-artifact-registry", - "persons", - "sessions" - ], "description": "A module's released versions, each artifact's digest, the source revision built and its edge entries; a reserved version is not in it (design 47 G section 349).", "input": { "type": "object", @@ -520,12 +495,6 @@ { "name": "outdated", "class": "read", - "callers": [ - "persons", - "sessions", - "healers", - "seat:mesh-pipeline-runner" - ], "description": "Every entry behind, by the part's digest: its module and version or build, the kind, the dependency with its watched branch and source revision, what was recorded and what is newest, and the act; may be asked for one dependency (design 47 G section 375).", "input": { "type": "object", @@ -558,11 +527,6 @@ { "name": "input", "class": "read", - "callers": [ - "seat:node-build-go", - "seat:node-build-node", - "seat:node-build-image" - ], "description": "A step's input by its digest, as the indexer keeps it for a validation step it asked a build seat to run (design 47 G section 354): its fields, then the bytes in chunks of at most 512 KiB on the chunk subject of the call, each acknowledged by the caller on the ack subject within 30 seconds; the input is of any size.", "input": { "type": "object", diff --git a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery-checker/seat.json.captured b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery-checker/seat.json.captured deleted file mode 100644 index 73ec5712..00000000 --- a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery-checker/seat.json.captured +++ /dev/null @@ -1,862 +0,0 @@ -{ - "format": 1, - "seat": "mesh-delivery-checker", - "scope": "mesh", - "grain": "whole", - "domain": "Delivery", - "decision": "novox/hq ADR 0547", - "verbs": [ - { - "name": "try", - "description": "Try pushed heads before their pull requests are opened: the checker judges them as it judges a delivery group's pull requests, each member merged onto its trunk, its unit and integration levels through the build modules, then the members' manifests, the module graph and the composition on every placed node, and owes the forge nothing. Name the group's members (each a repository and the exact commit), or one repository and its head for a try of one member. Answers the try's id at once; try-read reads where it stands. The same members at the same commits, in any order, are the answer to a second ask while that try waits or runs; at most 4 run on a build node, and 8 wait for one, mesh-wide.", - "optional": true, - "replaces": [ - "sh merge-check.sh", - "docker run postgres" - ], - "input": { - "properties": { - "head": { - "description": "the full commit to try, 40 or 64 hex digits, for a try of one member (instead of members)", - "type": "string" - }, - "level": { - "description": "unit or integration: only this level; both when absent", - "type": "string" - }, - "repository": { - "description": "/, for a try of one member (instead of members)", - "type": "string" - }, - "tests": { - "description": "a go test -run pattern: only those tests run, and nothing is kept", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - }, - "members": { - "description": "the group: one repository at most once, each at the exact commit asked and the trunk commit it is merged onto; instead of repository and head", - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "description": "/", - "type": "string" - }, - "head": { - "description": "the full commit to try, 40 or 64 hex digits", - "type": "string" - }, - "trunk": { - "description": "the trunk commit to merge it onto, or the trunk's branch for its head now; the trunk's head when absent", - "type": "string" - } - }, - "required": [ - "repository", - "head" - ] - } - } - }, - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try's id" - }, - "state": { - "type": "string", - "description": "its state" - } - }, - "required": [ - "id" - ] - } - }, - { - "name": "try-read", - "description": "Where a try stands, as stored: queued, running, or its end (pass, fail, or error when it could not run), with what was said of it, the head and the trunk commit it was merged onto, the time it took and what failed first. Read-only.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - } - }, - "required": [ - "id" - ], - "type": "object" - }, - "answer": { - "type": "object", - "description": "the try: its state, its steps and its verdict when it has one" - } - }, - { - "name": "try-end", - "description": "End a try that waits or runs, as error, by hand: say why (kept in what it says). Its place among the tries is free at once and the next try of its head asks anew with a new id. A try that ended already is refused.", - "optional": true, - "input": { - "properties": { - "id": { - "description": "the try's id, try-", - "type": "string" - }, - "why": { - "description": "why it is ended, in words", - "type": "string" - } - }, - "required": [ - "id", - "why" - ], - "type": "object" - }, - "answer": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the try" - }, - "ended": { - "type": "boolean", - "description": "it is ended" - } - }, - "required": [ - "id", - "ended" - ] - } - }, - { - "name": "input", - "description": "A checking program's input the checker keeps, by the sha256 of its exact bytes: the facts of a check its verdict is asked of, or the heads its seat list is asked of, as a run ask names it (its input's verb and digest). Answers the digest and the bytes, base64; a digest it keeps no input of is an error. Asked by the build module that runs the program, as its manifest's invokes grants it. Read-only.", - "optional": true, - "input": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the input's sha256, 64 lowercase hex digits, as the run ask names it" - } - }, - "required": [ - "digest" - ] - }, - "answer": { - "type": "object", - "properties": { - "digest": { - "type": "string", - "description": "the digest asked" - }, - "input": { - "type": "string", - "description": "the input's exact bytes, base64, so no encoding on the way changes a byte the digest covers" - } - }, - "required": [ - "digest", - "input" - ] - } - } - ], - "description": "The merge check's tries: start one, read one, end one. The seat says each check's end as checked and what the checker owes the forge as owed; the checker's other events stay under its own subjects (ADR 0620 §2).", - "family": { - "name": "mesh-delivery-checker.events", - "max-age-days": 7 - }, - "events": [ - { - "name": "checked", - "body": { - "type": "object", - "description": "a candidate checked: its entries judged at the group's heads (design 47 *What each step says*)", - "properties": { - "group": { - "type": "string", - "description": "the group, its branch" - }, - "heads": { - "type": "string", - "description": "the heads checked, 12 hex digits, as the candidate's revisions are keyed" - }, - "source": { - "type": "integer", - "description": "the source revision the heads are merged onto" - }, - "catalog": { - "type": "integer", - "description": "the candidate's catalog graph revision judged, by its number on the seat mesh-catalog" - }, - "verdict": { - "type": "string", - "enum": [ - "pass", - "fail", - "could not run" - ], - "description": "pass, fail, or could not run when a part the check needs did not answer" - }, - "words": { - "type": "string", - "description": "what failed first, or the part not heard" - }, - "entries": { - "type": "array", - "items": { - "$ref": "#/defs/CheckedEntry" - }, - "description": "the entries checked" - }, - "at": { - "type": "string", - "format": "date-time", - "description": "when" - } - }, - "required": [ - "group", - "heads", - "verdict" - ] - } - }, - { - "name": "owed", - "subject": "owed..", - "body": { - "$ref": "#/defs/Owed" - }, - "keep": { - "max-age-days": 7, - "max-mib": 64 - } - } - ], - "holder-events": [ - { - "name": "verdict", - "subject": "mesh.stream..event.verdict", - "family": "checker.asks", - "body": { - "type": "object", - "properties": { - "repository": { - "type": "string", - "description": "owner/repo" - }, - "pull": { - "type": "integer", - "description": "the pull request's number, for a pull request's check" - }, - "head": { - "type": "string", - "description": "the commit checked" - }, - "verdict": { - "type": "string", - "description": "pass or fail" - }, - "out-of-step": { - "type": "array", - "items": { - "type": "string" - }, - "description": "the generated files out of step with their seat definitions, each path (design 26)" - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string", - "description": "the module whose artifact's series changes" - }, - "artifact": { - "type": "string", - "description": "its artifact, or the package's ecosystem name as the module's packages name it" - }, - "from": { - "type": "string", - "description": "the series on trunk" - }, - "to": { - "type": "string", - "description": "the series the checked head gives it" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - }, - "description": "each change of an artifact's series the checked head makes against trunk's manifests, once each (design 32); absent when it changes none" - } - }, - "required": [ - "repository", - "head", - "verdict" - ] - } - }, - { - "name": "preview.written", - "subject": "mesh.stream..event.preview.written", - "family": "checks" - } - ], - "states": [ - { - "name": "verdicts", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "group": { - "type": "string" - }, - "heads": { - "type": "string", - "description": "12 hex digits" - }, - "trunk": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "repository to the trunk head merged onto" - }, - "state": { - "type": "string", - "description": "running, pass or fail" - }, - "failed": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - }, - "failures": { - "type": "array", - "items": { - "type": "object", - "properties": { - "test": { - "type": "string" - }, - "machine": { - "type": "string" - }, - "words": { - "type": "string" - } - } - } - }, - "levels": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "run": { - "type": "integer" - }, - "kept": { - "type": "integer" - }, - "skipped": { - "type": "integer" - } - }, - "required": [ - "run", - "kept" - ] - }, - "description": "by level, unit or integration" - }, - "took": { - "type": "object", - "properties": { - "queue": { - "type": "integer" - }, - "clone": { - "type": "integer" - }, - "unit": { - "type": "integer" - }, - "lint": { - "type": "integer" - }, - "integration-setup": { - "type": "integer" - }, - "integration-run": { - "type": "integer" - }, - "composition": { - "type": "integer" - } - }, - "description": "milliseconds" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "sdk": { - "type": "string" - }, - "composition": { - "type": "object", - "properties": { - "state": { - "type": "string", - "description": "not-run, pass or fail" - }, - "words": { - "type": "string" - }, - "sdk": { - "type": "string" - }, - "machines": { - "type": "array", - "items": { - "type": "string" - } - }, - "fpset": { - "type": "string" - } - }, - "required": [ - "state" - ] - }, - "over-bound": { - "type": "array", - "items": { - "type": "string" - } - }, - "beside": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "carried-from": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "series": { - "type": "array", - "items": { - "type": "object", - "properties": { - "module": { - "type": "string" - }, - "artifact": { - "type": "string" - }, - "from": { - "type": "string" - }, - "to": { - "type": "string" - } - }, - "required": [ - "module", - "artifact", - "from", - "to" - ] - } - }, - "judged-by": { - "type": "object", - "description": "the checking program that judged the check: where it was built, the key its build is kept under, whether this check's run built it, and the heads it read (ADR 0644, ADR 0656). Absent in a value written before it", - "properties": { - "program": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - }, - "dir": { - "type": "string" - }, - "package": { - "type": "string" - } - }, - "required": [ - "repository", - "commit", - "dir", - "package" - ] - }, - "key": { - "type": "string", - "description": "program- and 16 hex digits" - }, - "built": { - "type": "boolean" - }, - "heads": { - "type": "array", - "items": { - "type": "object", - "properties": { - "repository": { - "type": "string" - }, - "commit": { - "type": "string" - } - }, - "required": [ - "repository", - "commit" - ] - } - } - }, - "required": [ - "program", - "key", - "heads" - ] - } - }, - "required": [ - "group", - "heads", - "state" - ], - "description": "one check of a group at one set of heads" - }, - "description": "one check of a group; the group is an escaped branch name, heads 12 hex digits" - } - ], - "description": "the checker's verdict of each group at each set of heads", - "history": 5 - }, - { - "name": "kept", - "template": "state", - "key-forms": [ - { - "key": ".", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "state": { - "type": "string", - "description": "pass: a failure is never kept" - }, - "repository": { - "type": "string" - }, - "package": { - "type": "string" - }, - "level": { - "type": "string" - }, - "tests": { - "type": "integer" - }, - "took": { - "type": "integer" - }, - "toolchain": { - "type": "string" - }, - "at": { - "type": "string", - "description": "when (RFC 3339 time)" - } - }, - "required": [ - "state", - "repository", - "package", - "level" - ], - "description": "one passing level of one package, kept so the next check does not run it again" - }, - "description": "a passing level of one package by its content digest" - } - ], - "description": "the kept passing levels", - "history": 1 - }, - { - "name": "owed", - "template": "state", - "key-forms": [ - { - "key": "...", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "act": { - "type": "string", - "description": "status=, view, note or comment." - }, - "context": { - "type": "string" - }, - "target": { - "type": "string" - }, - "state": { - "type": "string" - }, - "text": { - "type": "string" - }, - "ref": { - "type": "string" - } - }, - "required": [ - "act" - ], - "description": "one act owed to the forge, written by its owner and done by the forge bridge" - }, - "description": "the status mesh/check the checker owes the forge for a head (its act is status=mesh/check)" - } - ], - "description": "the status the checker owes the forge", - "history": 5 - }, - { - "name": "previews", - "template": "state", - "key-forms": [ - { - "key": "..", - "value": { - "type": "object", - "properties": { - "v": { - "type": "integer", - "description": "the layout version" - }, - "repository": { - "type": "string" - }, - "head": { - "type": "string" - }, - "trunk": { - "type": "string" - }, - "merge": { - "type": "string", - "description": "the merge commit" - }, - "conflicts": { - "type": "array", - "items": { - "type": "string" - }, - "description": "files in conflict" - }, - "modules": { - "type": "object", - "additionalProperties": { - "type": "object", - "properties": { - "tree": { - "type": "string" - }, - "manifest": { - "type": "string", - "description": "manifest digest" - }, - "locks": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "paths": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "packages": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "tree", - "manifest" - ] - }, - "description": "by directory" - } - }, - "required": [ - "repository", - "head", - "trunk" - ], - "description": "the merge of a head onto a trunk commit, read before a pull request is checked" - }, - "description": "the merge of a head onto a trunk commit" - } - ], - "description": "the previews of a head merged onto a trunk", - "history": 5 - } - ], - "defs": { - "Owed": { - "type": "object", - "description": "the status the checker owes the forge for a head, said under its id and safe to repeat (a status replaces what stands); the forge bridge performs it through the seat git's verb status (design 47 *What the gate owes the forge*)", - "properties": { - "id": { - "type": "string", - "description": "the act's id, the same each time it is said again" - }, - "act": { - "type": "string", - "enum": [ - "status" - ], - "description": "the act: always status" - }, - "repository": { - "type": "string", - "description": "the repository, /", - "minLength": 1 - }, - "number": { - "type": "integer", - "description": "the pull request's number" - }, - "head": { - "type": "string", - "description": "the pull request's head the status is on", - "pattern": "^[0-9a-f]{40}$" - }, - "context": { - "type": "string", - "description": "its context, mesh/check" - }, - "state": { - "type": "string", - "description": "pending, success, failure or error" - }, - "description": { - "type": "string", - "description": "what it says" - }, - "target": { - "type": "string", - "description": "the page it links to" - }, - "said": { - "type": "string", - "format": "date-time", - "description": "when the checker first said it" - } - }, - "required": [ - "id", - "act", - "repository", - "number", - "head", - "context", - "state" - ] - }, - "CheckedEntry": { - "type": "object", - "description": "one entry of the candidate checked: a module at its fingerprint", - "properties": { - "module": { - "type": "string", - "description": "the module" - }, - "fp": { - "type": "string", - "description": "the entry's fingerprint" - }, - "node": { - "type": "string", - "description": "the node it was composed for, when the check composed it on one" - } - }, - "required": [ - "module", - "fp" - ] - } - } -} diff --git a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json.captured b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json.captured index 93f31549..f6f75f8b 100644 --- a/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json.captured +++ b/go/testdata/beside/mesh-delivery/modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json.captured @@ -164,10 +164,6 @@ { "name": "recovery", "class": "act", - "callers": [ - "operator", - "sessions" - ], "description": "Mark a merge its author names a recovery: the commit and why; the delivery record is marked recovery with the caller the runtime proves, and recovery-merged is said (design 47 G section 305).", "input": { "type": "object",