C14: the generated Go and TypeScript of every seat follow the definitions
Written by seatgen at c62650e4 (GEN3) with mesh-sdk b19fc7fa (reader release): the seat mesh-grants new, every TypeScript contract as index.js with index.d.ts, events with subject and stream. mesh-watchdogs gains its family, which a definition with events needs. Written with the reader as it is: the field needs-approval (node-login-shell) and the section bodies (mesh-conditions) are unknown to it, so they were laid aside for the run; nothing generated carries either. Builds: design 47 G §339, §341, §261, §389 Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
@@ -3,18 +3,22 @@
|
||||
// Package meshbroker is the contract of the seat "mesh-broker", defined whole (seats/mesh-broker/seat.json): The mesh's bus, and the bus state modules ask of it in requires (design 25 § 12). create, apply, recreate and drop are granted to the bus module's own credential alone.
|
||||
package meshbroker
|
||||
|
||||
import "time"
|
||||
|
||||
// Seat is the seat's name.
|
||||
const Seat = "mesh-broker"
|
||||
|
||||
const (
|
||||
VerbList = "list"
|
||||
VerbShow = "show"
|
||||
VerbCheck = "check"
|
||||
VerbOrphans = "orphans"
|
||||
VerbCreate = "create"
|
||||
VerbApply = "apply"
|
||||
VerbRecreate = "recreate"
|
||||
VerbDrop = "drop"
|
||||
VerbList = "list"
|
||||
VerbShow = "show"
|
||||
VerbCheck = "check"
|
||||
VerbOrphans = "orphans"
|
||||
VerbCreate = "create"
|
||||
VerbApply = "apply"
|
||||
VerbRecreate = "recreate"
|
||||
VerbDrop = "drop"
|
||||
VerbSnapshotKept = "snapshot-kept"
|
||||
VerbRestoreKept = "restore-kept"
|
||||
)
|
||||
|
||||
const (
|
||||
@@ -31,7 +35,7 @@ const (
|
||||
|
||||
// Verbs is every verb the seat serves, in its definition's order: a new copy each call.
|
||||
func Verbs() []string {
|
||||
return []string{VerbList, VerbShow, VerbCheck, VerbOrphans, VerbCreate, VerbApply, VerbRecreate, VerbDrop}
|
||||
return []string{VerbList, VerbShow, VerbCheck, VerbOrphans, VerbCreate, VerbApply, VerbRecreate, VerbDrop, VerbSnapshotKept, VerbRestoreKept}
|
||||
}
|
||||
|
||||
// Events is every event published on the seat's subject: a new copy each call.
|
||||
@@ -72,10 +76,30 @@ const SubjectRecreated = "mesh.seat.mesh-broker.event.recreated"
|
||||
// SubjectDropped is where dropped is published.
|
||||
const SubjectDropped = "mesh.seat.mesh-broker.event.dropped"
|
||||
|
||||
// Aside is live kept data a restore set aside, never removed but by discard-aside.
|
||||
type Aside struct {
|
||||
// when it was set aside
|
||||
At *time.Time `json:"at,omitempty"`
|
||||
// the form it held
|
||||
Form int64 `json:"form,omitempty"`
|
||||
// its id, for discard-aside
|
||||
ID string `json:"id"`
|
||||
// the kept data
|
||||
Kept string `json:"kept"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// the name it is kept under on the bus
|
||||
Name string `json:"name"`
|
||||
// its size in bytes
|
||||
Size int64 `json:"size,omitempty"`
|
||||
}
|
||||
|
||||
// Binding is the binding a module receives in its membership for one entry (ADR 0595 §1, §7).
|
||||
type Binding struct {
|
||||
// the entry's name on the bus
|
||||
BusName string `json:"bus-name"`
|
||||
// the bus name of the state's <state>-objects, where its large values go (design 47 G 58, 399)
|
||||
Objects string `json:"objects,omitempty"`
|
||||
// how the bus keeps it
|
||||
StorageType string `json:"storage-type"`
|
||||
// its subjects, for a stream
|
||||
@@ -183,6 +207,44 @@ const (
|
||||
HeldTemplate = ""
|
||||
)
|
||||
|
||||
// KeptPointCatchUp is the catch-up tool and its arguments the restore point records (design 47 G 406).
|
||||
type KeptPointCatchUp struct {
|
||||
Arguments map[string]any `json:"arguments,omitempty"`
|
||||
Tool string `json:"tool"`
|
||||
}
|
||||
|
||||
// KeptPointConsumersItem is a type of the contract.
|
||||
type KeptPointConsumersItem struct {
|
||||
// the durable consumer
|
||||
Consumer string `json:"consumer"`
|
||||
// its acknowledged position
|
||||
Sequence int64 `json:"sequence"`
|
||||
// the stream
|
||||
Stream string `json:"stream"`
|
||||
}
|
||||
|
||||
// KeptPoint is a restore point of one module's kept data on the bus, whole, with its consumers' positions.
|
||||
type KeptPoint struct {
|
||||
// when it was taken
|
||||
At *time.Time `json:"at,omitempty"`
|
||||
// the catch-up tool and its arguments the restore point records (design 47 G 406)
|
||||
CatchUp *KeptPointCatchUp `json:"catch-up,omitempty"`
|
||||
// each durable consumer the module reads with, and its position
|
||||
Consumers []KeptPointConsumersItem `json:"consumers,omitempty"`
|
||||
// the fingerprint the restore point is taken before
|
||||
Fingerprint string `json:"fingerprint"`
|
||||
// its form, the number the holder raises when it changes how it writes it (0 when undeclared)
|
||||
Form int64 `json:"form"`
|
||||
// the kept data, its local name in the module's manifest
|
||||
Kept string `json:"kept"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// its size in bytes
|
||||
Size int64 `json:"size,omitempty"`
|
||||
// the restore point's name
|
||||
Snapshot string `json:"snapshot"`
|
||||
}
|
||||
|
||||
// Named is a type of the contract.
|
||||
type Named struct {
|
||||
// the entry's local name
|
||||
@@ -335,6 +397,64 @@ type DropAnswer struct {
|
||||
Snapshot string `json:"snapshot,omitempty"`
|
||||
}
|
||||
|
||||
// SnapshotKeptInputCatchUp is the catch-up tool the newer manifest declares beside the kept data and its arguments whole, recorded in the restore point (design 47 G 299, 406).
|
||||
type SnapshotKeptInputCatchUp struct {
|
||||
Arguments map[string]any `json:"arguments,omitempty"`
|
||||
Tool string `json:"tool"`
|
||||
}
|
||||
|
||||
// SnapshotKeptInput is what snapshot-kept takes.
|
||||
type SnapshotKeptInput struct {
|
||||
// the catch-up tool the newer manifest declares beside the kept data and its arguments whole, recorded in the restore point (design 47 G 299, 406)
|
||||
CatchUp *SnapshotKeptInputCatchUp `json:"catch-up,omitempty"`
|
||||
// the fingerprint the restore point is taken before
|
||||
Fingerprint string `json:"fingerprint"`
|
||||
// its form, the number the holder raises when it changes how it writes it (0 when undeclared)
|
||||
Form int64 `json:"form"`
|
||||
// the kept data, its local name in the module's manifest
|
||||
Kept string `json:"kept"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// why it is taken
|
||||
Why string `json:"why,omitempty"`
|
||||
}
|
||||
|
||||
// SnapshotKeptAnswer is what snapshot-kept answers.
|
||||
type SnapshotKeptAnswer struct {
|
||||
// why it failed; set alone
|
||||
Error string `json:"error,omitempty"`
|
||||
Point *KeptPoint `json:"point,omitempty"`
|
||||
}
|
||||
|
||||
// RestoreKeptInput is what restore-kept takes.
|
||||
type RestoreKeptInput struct {
|
||||
// set the live data aside and restore nothing
|
||||
AsideOnly bool `json:"aside-only,omitempty"`
|
||||
// the name of data set aside: remove it and restore nothing
|
||||
DiscardAside string `json:"discard-aside,omitempty"`
|
||||
// the fingerprint the restore point is taken before
|
||||
Fingerprint string `json:"fingerprint"`
|
||||
// its form, the number the holder raises when it changes how it writes it (0 when undeclared)
|
||||
Form int64 `json:"form"`
|
||||
// the kept data, its local name in the module's manifest
|
||||
Kept string `json:"kept"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// the restore point's name; not with aside-only or discard-aside
|
||||
Snapshot string `json:"snapshot,omitempty"`
|
||||
// why
|
||||
Why string `json:"why,omitempty"`
|
||||
}
|
||||
|
||||
// RestoreKeptAnswer is what restore-kept answers.
|
||||
type RestoreKeptAnswer struct {
|
||||
Aside *Aside `json:"aside,omitempty"`
|
||||
// why it failed; set alone
|
||||
Error string `json:"error,omitempty"`
|
||||
// the restore point is the live data now
|
||||
Restored bool `json:"restored,omitempty"`
|
||||
}
|
||||
|
||||
// CreatedEvent is the body of the event created.
|
||||
type CreatedEvent = Said
|
||||
|
||||
|
||||
@@ -41,6 +41,12 @@ func TestFixtures(t *testing.T) {
|
||||
decode: func(b []byte) (any, error) { var v DropInput; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "list answers every entry", subject: "", given: "{\"entries\":[{\"bus-name\":\"mesh-knowledge_ledger\",\"fill\":{\"bytes\":2048,\"cap\":67108864,\"count\":10},\"local-name\":\"ledger\",\"module\":\"mesh-knowledge\",\"options\":{\"max-mib\":64},\"settings\":{\"max-mib\":64},\"storage-type\":\"ledger\",\"template\":\"ledger\"}]}", wire: "{\"entries\":[{\"bus-name\":\"mesh-knowledge_ledger\",\"fill\":{\"bytes\":2048,\"cap\":67108864,\"count\":10},\"local-name\":\"ledger\",\"module\":\"mesh-knowledge\",\"options\":{\"max-mib\":64},\"settings\":{\"max-mib\":64},\"storage-type\":\"ledger\",\"template\":\"ledger\"}]}",
|
||||
decode: func(b []byte) (any, error) { var v ListAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "snapshot-kept answers the restore point", subject: "", given: "{\"point\":{\"at\":\"2026-11-09T20:00:00Z\",\"consumers\":[{\"consumer\":\"novox_mesh-delivery-indexer\",\"sequence\":4711,\"stream\":\"forge\"}],\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"form\":1,\"kept\":\"catalog-revisions\",\"module\":\"mesh-delivery-indexer\",\"size\":1048576,\"snapshot\":\"kept-mesh-delivery-indexer-catalog-revisions-1-aaaa\"}}", wire: "{\"point\":{\"at\":\"2026-11-09T20:00:00Z\",\"consumers\":[{\"consumer\":\"novox_mesh-delivery-indexer\",\"sequence\":4711,\"stream\":\"forge\"}],\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"form\":1,\"kept\":\"catalog-revisions\",\"module\":\"mesh-delivery-indexer\",\"size\":1048576,\"snapshot\":\"kept-mesh-delivery-indexer-catalog-revisions-1-aaaa\"}}",
|
||||
decode: func(b []byte) (any, error) { var v SnapshotKeptAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "snapshot-kept answers an error", subject: "", given: "{\"error\":\"the object store catalog-revisions is not on the bus\"}", wire: "{\"error\":\"the object store catalog-revisions is not on the bus\"}",
|
||||
decode: func(b []byte) (any, error) { var v SnapshotKeptAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "restore-kept answers what it set aside", subject: "", given: "{\"aside\":{\"at\":\"2026-11-09T21:00:00Z\",\"form\":2,\"id\":\"aside-1\",\"kept\":\"catalog-revisions\",\"module\":\"mesh-delivery-indexer\",\"name\":\"catalog-revisions-aside-20261109\",\"size\":2097152},\"restored\":true}", wire: "{\"aside\":{\"at\":\"2026-11-09T21:00:00Z\",\"form\":2,\"id\":\"aside-1\",\"kept\":\"catalog-revisions\",\"module\":\"mesh-delivery-indexer\",\"name\":\"catalog-revisions-aside-20261109\",\"size\":2097152},\"restored\":true}",
|
||||
decode: func(b []byte) (any, error) { var v RestoreKeptAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
}
|
||||
for _, c := range cases {
|
||||
v, err := c.decode([]byte(c.given))
|
||||
|
||||
@@ -423,9 +423,13 @@ type NodeDecided struct {
|
||||
// PlacedModule is one module placed on a node.
|
||||
type PlacedModule struct {
|
||||
// by provision, the provider each requirement that keeps data is bound to
|
||||
Bindings map[string]Provider `json:"bindings,omitempty"`
|
||||
HasLayer bool `json:"has-layer,omitempty"`
|
||||
HasMeshWide bool `json:"has-mesh-wide,omitempty"`
|
||||
Bindings map[string]Provider `json:"bindings,omitempty"`
|
||||
// the watched branch this node runs the module from; absent, the first watched branch of the module's registration (design 47 G 14)
|
||||
Branch string `json:"branch,omitempty"`
|
||||
// the fingerprint of the build the node runs; absent, the newest delivered of the branch (design 47 G 78, 402)
|
||||
Build string `json:"build,omitempty"`
|
||||
HasLayer bool `json:"has-layer,omitempty"`
|
||||
HasMeshWide bool `json:"has-mesh-wide,omitempty"`
|
||||
// this node's settings layer of the module's assignments
|
||||
Layer map[string]any `json:"layer,omitempty"`
|
||||
// the whole mesh's settings layer of the module's assignments
|
||||
@@ -475,9 +479,13 @@ type ProposalChangeKeys struct {
|
||||
// ProposalChange is one change of a proposal.
|
||||
type ProposalChange struct {
|
||||
Bindings map[string]Provider `json:"bindings,omitempty"`
|
||||
Claim string `json:"claim,omitempty"`
|
||||
Decided *NodeDecided `json:"decided,omitempty"`
|
||||
Field string `json:"field,omitempty"`
|
||||
// for place, the watched branch the node runs the module from; absent, the first watched branch of the module's registration (design 47 G 14)
|
||||
Branch string `json:"branch,omitempty"`
|
||||
// for place, the build of that branch the node runs, a return to an earlier build being this one value; absent, the newest delivered of the branch (ADR 0666 section 24)
|
||||
Build string `json:"build,omitempty"`
|
||||
Claim string `json:"claim,omitempty"`
|
||||
Decided *NodeDecided `json:"decided,omitempty"`
|
||||
Field string `json:"field,omitempty"`
|
||||
// the public halves of a joining node's keys
|
||||
Keys *ProposalChangeKeys `json:"keys,omitempty"`
|
||||
Kind string `json:"kind,omitempty"`
|
||||
|
||||
@@ -41,12 +41,24 @@ func TestFixtures(t *testing.T) {
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: nil},
|
||||
{name: "a module's key on a watched branch and a build", subject: "", given: "{\"node\":\"ace\",\"placed\":{\"branch\":\"beta\",\"build\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"plex\"},\"v\":1}", wire: "{\"node\":\"ace\",\"placed\":{\"branch\":\"beta\",\"build\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"plex\"},\"v\":1}",
|
||||
decode: func(b []byte) (any, error) {
|
||||
var v AssignmentsByNodeModuleValue
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: nil},
|
||||
{name: "an open proposal", subject: "", given: "{\"at\":\"2026-11-05T12:00:00Z\",\"base\":{\"ace\":3},\"by\":\"operator\",\"changes\":[{\"module\":\"plex\",\"node\":\"ace\",\"op\":\"place\",\"ports\":{\"32400\":32400}}],\"id\":\"p-20261105t120000-aabbccdd\",\"state\":\"answering\",\"why\":\"move plex\"}", wire: "{\"at\":\"2026-11-05T12:00:00Z\",\"base\":{\"ace\":3},\"by\":\"operator\",\"changes\":[{\"module\":\"plex\",\"node\":\"ace\",\"op\":\"place\",\"ports\":{\"32400\":32400}}],\"id\":\"p-20261105t120000-aabbccdd\",\"state\":\"answering\",\"why\":\"move plex\"}",
|
||||
decode: func(b []byte) (any, error) {
|
||||
var v ProposalsByProposalValue
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: nil},
|
||||
{name: "a proposal placing a module on a watched branch at an earlier build", subject: "", given: "{\"at\":\"2026-11-10T12:00:00Z\",\"base\":{\"ace\":3},\"by\":\"operator\",\"changes\":[{\"branch\":\"beta\",\"build\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"nats\",\"node\":\"ace\",\"op\":\"place\"}],\"id\":\"p-20261110t120000-aabbccdd\",\"state\":\"answering\",\"why\":\"run nats from beta, back one build\"}", wire: "{\"at\":\"2026-11-10T12:00:00Z\",\"base\":{\"ace\":3},\"by\":\"operator\",\"changes\":[{\"branch\":\"beta\",\"build\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"nats\",\"node\":\"ace\",\"op\":\"place\"}],\"id\":\"p-20261110t120000-aabbccdd\",\"state\":\"answering\",\"why\":\"run nats from beta, back one build\"}",
|
||||
decode: func(b []byte) (any, error) {
|
||||
var v ProposalsByProposalValue
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: nil},
|
||||
{name: "a candidate", subject: "", given: "{\"proposal\":\"p-20261105t120000-aabbccdd\",\"v\":1}", wire: "{\"proposal\":\"p-20261105t120000-aabbccdd\",\"v\":1}",
|
||||
decode: func(b []byte) (any, error) {
|
||||
var v CandidatesByProposalNodeValue
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
// Code generated by seatgen from the seat definitions; DO NOT EDIT.
|
||||
|
||||
// Package nodeengine is the contract of the seat "node-engine", defined whole (seats/node-engine/seat.json): The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 §3, §4): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token.
|
||||
// Package nodeengine is the contract of the seat "node-engine", defined whole (seats/node-engine/seat.json): The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 §3, §4): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token, or, for an event whose subject names <node>, there (composed.<node>, running.<node>.<module>): the grants part grants a node's account only its own node's subjects (ADR 0363 §2).
|
||||
package nodeengine
|
||||
|
||||
import (
|
||||
@@ -28,6 +28,7 @@ const (
|
||||
VerbManifestReads = "manifest-reads"
|
||||
VerbSeatList = "seat-list"
|
||||
VerbSeatListAgain = "seat-list-again"
|
||||
VerbProcessBuilds = "process-builds"
|
||||
)
|
||||
|
||||
const (
|
||||
@@ -35,16 +36,19 @@ const (
|
||||
EventDone = "done"
|
||||
EventRefused = "refused"
|
||||
EventManifestReadsChanged = "manifest-reads-changed"
|
||||
EventComposed = "composed"
|
||||
EventRunning = "running"
|
||||
EventCapabilitiesChanged = "capabilities-changed"
|
||||
)
|
||||
|
||||
// Verbs is every verb the seat serves, in its definition's order: a new copy each call.
|
||||
func Verbs() []string {
|
||||
return []string{VerbHandOver, VerbAccessAct, VerbJudgeDirectories, VerbSetuidSearch, VerbRootFree, VerbActs, VerbPackages, VerbComposition, VerbCompose, VerbComposeCandidate, VerbManifestReads, VerbSeatList, VerbSeatListAgain}
|
||||
return []string{VerbHandOver, VerbAccessAct, VerbJudgeDirectories, VerbSetuidSearch, VerbRootFree, VerbActs, VerbPackages, VerbComposition, VerbCompose, VerbComposeCandidate, VerbManifestReads, VerbSeatList, VerbSeatListAgain, VerbProcessBuilds}
|
||||
}
|
||||
|
||||
// Events is every event published on the seat's subject: a new copy each call.
|
||||
func Events() []string {
|
||||
return []string{EventAsked, EventDone, EventRefused, EventManifestReadsChanged}
|
||||
return []string{EventAsked, EventDone, EventRefused, EventManifestReadsChanged, EventComposed, EventRunning, EventCapabilitiesChanged}
|
||||
}
|
||||
|
||||
// Family is where the seat's events are kept: the shared events stream, filtered to the seat's subjects.
|
||||
@@ -67,6 +71,31 @@ func SubjectManifestReadsChanged(caller string) string {
|
||||
return "mesh.seat.node-engine.event.manifest-reads-changed." + caller
|
||||
}
|
||||
|
||||
// SubjectComposed is where composed is published, on mesh.seat.node-engine.event.composed.<node>.
|
||||
func SubjectComposed(node string) string { return "mesh.seat.node-engine.event.composed." + node }
|
||||
|
||||
// SubjectComposedAll hears every composed.
|
||||
const SubjectComposedAll = "mesh.seat.node-engine.event.composed.*"
|
||||
|
||||
// StreamRunning is the stream running is kept in.
|
||||
const StreamRunning = "SEAT_node-engine_running"
|
||||
|
||||
// SubjectRunning is where running is published, on mesh.seat.node-engine.event.running.<node>.<module>.
|
||||
func SubjectRunning(node, module string) string {
|
||||
return "mesh.seat.node-engine.event.running." + node + "." + module
|
||||
}
|
||||
|
||||
// SubjectRunningAll hears every running.
|
||||
const SubjectRunningAll = "mesh.seat.node-engine.event.running.*.*"
|
||||
|
||||
// SubjectCapabilitiesChanged is where capabilities-changed is published, on mesh.seat.node-engine.event.capabilities-changed.<node>.
|
||||
func SubjectCapabilitiesChanged(node string) string {
|
||||
return "mesh.seat.node-engine.event.capabilities-changed." + node
|
||||
}
|
||||
|
||||
// SubjectCapabilitiesChangedAll hears every capabilities-changed.
|
||||
const SubjectCapabilitiesChangedAll = "mesh.seat.node-engine.event.capabilities-changed.*"
|
||||
|
||||
const (
|
||||
StateHave = "have"
|
||||
StateComposed = "composed"
|
||||
@@ -523,6 +552,34 @@ type CandidateRefusal struct {
|
||||
Why string `json:"why"`
|
||||
}
|
||||
|
||||
// CapabilitiesChanged is a node's capabilities changed, which the assigner places by.
|
||||
type CapabilitiesChanged struct {
|
||||
// when, RFC 3339
|
||||
At time.Time `json:"at"`
|
||||
// its capabilities now
|
||||
Capabilities []string `json:"capabilities"`
|
||||
// the node
|
||||
Node string `json:"node"`
|
||||
// the layout's version
|
||||
V int64 `json:"v"`
|
||||
}
|
||||
|
||||
// Composed is an entry composed on a node (design 47 *What each step says*).
|
||||
type Composed struct {
|
||||
// when, RFC 3339
|
||||
At time.Time `json:"at"`
|
||||
// the digest of the composition (design 47 G 404)
|
||||
Digest string `json:"digest"`
|
||||
// the fingerprint of the want composed
|
||||
Fingerprint string `json:"fingerprint"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// the node
|
||||
Node string `json:"node"`
|
||||
// the layout's version
|
||||
V int64 `json:"v"`
|
||||
}
|
||||
|
||||
// DeclaredGroup is a group.
|
||||
type DeclaredGroup struct {
|
||||
Gid int64 `json:"gid"`
|
||||
@@ -742,6 +799,38 @@ type PlacedDataItem struct {
|
||||
Protection string `json:"protection,omitempty"`
|
||||
}
|
||||
|
||||
// ProcessBuild is the build one process of a module was started with.
|
||||
type ProcessBuild struct {
|
||||
// the fingerprint handed to it in MESH_FINGERPRINT; empty when it was started without one
|
||||
Fingerprint string `json:"fingerprint,omitempty"`
|
||||
// service or container
|
||||
Kind string `json:"kind"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// the service's unit or the container's name
|
||||
Process string `json:"process"`
|
||||
// when it was started, RFC 3339
|
||||
Started *time.Time `json:"started,omitempty"`
|
||||
// why its build is unknown: started before the node-engine handed MESH_FINGERPRINT, or the value could not be read
|
||||
Unknown string `json:"unknown,omitempty"`
|
||||
}
|
||||
|
||||
// The values of ProcessBuild's kind.
|
||||
const (
|
||||
ProcessBuildKindService = "service"
|
||||
ProcessBuildKindContainer = "container"
|
||||
)
|
||||
|
||||
// ProcessBuilds is what process-builds answers.
|
||||
type ProcessBuilds struct {
|
||||
// why they could not be read
|
||||
Error string `json:"error,omitempty"`
|
||||
// the node
|
||||
Node string `json:"node"`
|
||||
// every process the node-engine started, by module
|
||||
Processes []ProcessBuild `json:"processes"`
|
||||
}
|
||||
|
||||
// PullWait is the pull from a store a failed apply waits on.
|
||||
type PullWait struct {
|
||||
// when the pull began
|
||||
@@ -796,6 +885,24 @@ type RootVerdict struct {
|
||||
Why string `json:"why"`
|
||||
}
|
||||
|
||||
// Running is a module running healthy on a node at a build: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 §2), kept last per subject with no age limit.
|
||||
type Running struct {
|
||||
// when it was seen running healthy, RFC 3339
|
||||
At time.Time `json:"at"`
|
||||
// the fingerprint of the build it runs; none with stopped
|
||||
Fingerprint string `json:"fingerprint,omitempty"`
|
||||
// the digest of that build's manifest, the indexer's manifest of it, read by digest from the catalog half
|
||||
Manifest string `json:"manifest,omitempty"`
|
||||
// the module
|
||||
Module string `json:"module"`
|
||||
// the node
|
||||
Node string `json:"node"`
|
||||
// true when the module no longer runs on the node: no fingerprint or manifest then (design 47 G 365, 404); mesh-sdk's SeatsToPassOn counts such a module as not running there
|
||||
Stopped bool `json:"stopped,omitempty"`
|
||||
// the layout's version
|
||||
V int64 `json:"v"`
|
||||
}
|
||||
|
||||
// Said is the answer of a read-only judgement.
|
||||
type Said struct {
|
||||
// the node
|
||||
@@ -1217,6 +1324,15 @@ type SeatListAgainInput struct {
|
||||
// SeatListAgainAnswer is what seat-list-again answers.
|
||||
type SeatListAgainAnswer = SeatList
|
||||
|
||||
// ProcessBuildsInput is what process-builds takes.
|
||||
type ProcessBuildsInput struct {
|
||||
// only this module's processes
|
||||
Module string `json:"module,omitempty"`
|
||||
}
|
||||
|
||||
// ProcessBuildsAnswer is what process-builds answers.
|
||||
type ProcessBuildsAnswer = ProcessBuilds
|
||||
|
||||
// AskedEvent is the body of the event asked.
|
||||
type AskedEvent = ActSaid
|
||||
|
||||
@@ -1229,6 +1345,15 @@ type RefusedEvent = ActSaid
|
||||
// ManifestReadsChangedEvent is the body of the event manifest-reads-changed.
|
||||
type ManifestReadsChangedEvent = ManifestReadsChanged
|
||||
|
||||
// ComposedEvent is the body of the event composed.
|
||||
type ComposedEvent = Composed
|
||||
|
||||
// RunningEvent is the body of the event running.
|
||||
type RunningEvent = Running
|
||||
|
||||
// CapabilitiesChangedEvent is the body of the event capabilities-changed.
|
||||
type CapabilitiesChangedEvent = CapabilitiesChanged
|
||||
|
||||
// HaveByNodeModuleValue is one value of the state have under the key <node>.<module>.
|
||||
type HaveByNodeModuleValue struct {
|
||||
Build string `json:"build,omitempty"`
|
||||
|
||||
@@ -35,6 +35,18 @@ func TestFixtures(t *testing.T) {
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: regexp.MustCompile("^mesh\\.seat\\.node-engine\\.event\\.manifest-reads-changed\\.[A-Za-z0-9_-]+$")},
|
||||
{name: "composed is said", subject: "mesh.seat.node-engine.event.composed.ace", given: "{\"at\":\"2026-11-09T20:00:00Z\",\"digest\":\"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"nats\",\"node\":\"ace\",\"v\":1}", wire: "{\"at\":\"2026-11-09T20:00:00Z\",\"digest\":\"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"module\":\"nats\",\"node\":\"ace\",\"v\":1}",
|
||||
decode: func(b []byte) (any, error) { var v ComposedEvent; err := json.Unmarshal(b, &v); return v, err }, subjectIs: regexp.MustCompile("^mesh\\.seat\\.node-engine\\.event\\.composed\\.[^.*> ]+$")},
|
||||
{name: "running is said, its node and module in its subject", subject: "mesh.seat.node-engine.event.running.ace.nats", given: "{\"at\":\"2026-11-09T20:01:00Z\",\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"manifest\":\"sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\",\"module\":\"nats\",\"node\":\"ace\",\"v\":1}", wire: "{\"at\":\"2026-11-09T20:01:00Z\",\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"manifest\":\"sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\",\"module\":\"nats\",\"node\":\"ace\",\"v\":1}",
|
||||
decode: func(b []byte) (any, error) { var v RunningEvent; err := json.Unmarshal(b, &v); return v, err }, subjectIs: regexp.MustCompile("^mesh\\.seat\\.node-engine\\.event\\.running\\.[^.*> ]+\\.[^.*> ]+$")},
|
||||
{name: "running says a module stopped on the node, with no fingerprint", subject: "mesh.seat.node-engine.event.running.ace.nats", given: "{\"at\":\"2026-11-11T09:00:00Z\",\"module\":\"nats\",\"node\":\"ace\",\"stopped\":true,\"v\":1}", wire: "{\"at\":\"2026-11-11T09:00:00Z\",\"module\":\"nats\",\"node\":\"ace\",\"stopped\":true,\"v\":1}",
|
||||
decode: func(b []byte) (any, error) { var v RunningEvent; err := json.Unmarshal(b, &v); return v, err }, subjectIs: regexp.MustCompile("^mesh\\.seat\\.node-engine\\.event\\.running\\.[^.*> ]+\\.[^.*> ]+$")},
|
||||
{name: "capabilities-changed is said", subject: "mesh.seat.node-engine.event.capabilities-changed.ace", given: "{\"at\":\"2026-11-09T20:02:00Z\",\"capabilities\":[\"build-go\",\"docker\"],\"node\":\"ace\",\"v\":1}", wire: "{\"at\":\"2026-11-09T20:02:00Z\",\"capabilities\":[\"build-go\",\"docker\"],\"node\":\"ace\",\"v\":1}",
|
||||
decode: func(b []byte) (any, error) {
|
||||
var v CapabilitiesChangedEvent
|
||||
err := json.Unmarshal(b, &v)
|
||||
return v, err
|
||||
}, subjectIs: regexp.MustCompile("^mesh\\.seat\\.node-engine\\.event\\.capabilities-changed\\.[^.*> ]+$")},
|
||||
{name: "the finding of a seat list unread, as the engine writes it", subject: "", given: "{\"at\":\"2026-11-05T14:00:00Z\",\"key\":\"machine.ace.seat-list-unread\",\"kind\":\"seat-list-unread\",\"observer\":\"mesh-host\",\"severity\":\"warning\",\"source\":\"node-engine.seat-list\",\"subject\":{\"id\":\"ace\",\"machine\":\"ace\",\"scope\":\"machine\"},\"summary\":\"the seat list has not been read for five minutes\",\"v\":1}", wire: "{\"at\":\"2026-11-05T14:00:00Z\",\"key\":\"machine.ace.seat-list-unread\",\"kind\":\"seat-list-unread\",\"observer\":\"mesh-host\",\"severity\":\"warning\",\"source\":\"node-engine.seat-list\",\"subject\":{\"id\":\"ace\",\"machine\":\"ace\",\"scope\":\"machine\"},\"summary\":\"the seat list has not been read for five minutes\",\"v\":1}",
|
||||
decode: func(b []byte) (any, error) { var v FindingsByKeyValue; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "a node's packages, present and absent (captured from ace, shortened)", subject: "", given: "{\"node\":\"ace\",\"packages\":[{\"absent\":false,\"modules\":[\"avahi\"],\"package\":\"avahi\"},{\"absent\":false,\"modules\":[\"mesh-build-go\",\"mesh-build-node\"],\"package\":\"bubblewrap\"},{\"absent\":true,\"modules\":[\"time-sync\"],\"package\":\"ntp\"}]}", wire: "{\"node\":\"ace\",\"packages\":[{\"absent\":false,\"modules\":[\"avahi\"],\"package\":\"avahi\"},{\"absent\":false,\"modules\":[\"mesh-build-go\",\"mesh-build-node\"],\"package\":\"bubblewrap\"},{\"absent\":true,\"modules\":[\"time-sync\"],\"package\":\"ntp\"}]}",
|
||||
@@ -91,6 +103,12 @@ func TestFixtures(t *testing.T) {
|
||||
decode: func(b []byte) (any, error) { var v SeatListAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "seat-list-again answers the error when the read failed", subject: "", given: "{\"error\":\"seatlist: no answer\",\"health\":\"the seat list is held from the bootstrap\",\"status\":{\"heard\":false,\"held\":[{\"seat\":\"node-engine\",\"source\":\"bootstrap\"}],\"waiting\":[\"node-engine\"]}}", wire: "{\"error\":\"seatlist: no answer\",\"health\":\"the seat list is held from the bootstrap\",\"status\":{\"heard\":false,\"held\":[{\"seat\":\"node-engine\",\"source\":\"bootstrap\"}],\"waiting\":[\"node-engine\"]}}",
|
||||
decode: func(b []byte) (any, error) { var v SeatListAgainAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "process-builds asks one module", subject: "", given: "{\"module\":\"nats\"}", wire: "{\"module\":\"nats\"}",
|
||||
decode: func(b []byte) (any, error) { var v ProcessBuildsInput; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "process-builds answers each process's build", subject: "", given: "{\"node\":\"ace\",\"processes\":[{\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"kind\":\"service\",\"module\":\"nats\",\"process\":\"nats.service\",\"started\":\"2026-11-09T19:00:00Z\"},{\"kind\":\"container\",\"module\":\"route-proxy\",\"process\":\"route-proxy\",\"started\":\"2026-11-01T08:00:00Z\",\"unknown\":\"started before the node-engine handed MESH_FINGERPRINT\"}]}", wire: "{\"node\":\"ace\",\"processes\":[{\"fingerprint\":\"src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"kind\":\"service\",\"module\":\"nats\",\"process\":\"nats.service\",\"started\":\"2026-11-09T19:00:00Z\"},{\"kind\":\"container\",\"module\":\"route-proxy\",\"process\":\"route-proxy\",\"started\":\"2026-11-01T08:00:00Z\",\"unknown\":\"started before the node-engine handed MESH_FINGERPRINT\"}]}",
|
||||
decode: func(b []byte) (any, error) { var v ProcessBuildsAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
{name: "process-builds answers an error", subject: "", given: "{\"error\":\"the service manager did not answer\",\"node\":\"ace\",\"processes\":[]}", wire: "{\"error\":\"the service manager did not answer\",\"node\":\"ace\",\"processes\":[]}",
|
||||
decode: func(b []byte) (any, error) { var v ProcessBuildsAnswer; err := json.Unmarshal(b, &v); return v, err }, subjectIs: nil},
|
||||
}
|
||||
for _, c := range cases {
|
||||
v, err := c.decode([]byte(c.given))
|
||||
|
||||
Reference in New Issue
Block a user