Generated by seatgen (mesh-catalog, GEN1 and GEN2 on its worktree) from the definitions of CT1 to CT9; module.json names the artifacts of the new seats mesh-builds, mesh-pipeline-runner and git. seatgen -check is clean; every seat package's generated fixture test passes. Builds: design 47 G §341 (a TypeScript contract is emitted as index.js with index.d.ts), §196, §339 (the generator refuses an unknown callers entry), §260, §331. Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
220 lines
5.8 KiB
JSON
220 lines
5.8 KiB
JSON
{
|
|
"format": 1,
|
|
"seat": "mesh-builds",
|
|
"scope": "mesh",
|
|
"grain": "whole",
|
|
"domain": "Delivery",
|
|
"decision": "novox/hq ADR 0666",
|
|
"description": "The builder's seat: it says each artifact it published and each agreed toolchain, and answers a module's reserved version. Held once for the mesh (design 47 G section 52, section 307).",
|
|
"verbs": [
|
|
{
|
|
"name": "reserved",
|
|
"class": "read",
|
|
"callers": [
|
|
"seat:go-package-registry",
|
|
"seat:npm-package-registry",
|
|
"seat:container-image-registry",
|
|
"seat:oci-artifact-registry"
|
|
],
|
|
"description": "A module's reserved version with each artifact's digest, for a registry holder deciding whether to publish (design 47 G section 369; design 51, Publishing).",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"module": {
|
|
"type": "string",
|
|
"description": "the module"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "the version, when asked for a particular one"
|
|
}
|
|
},
|
|
"required": [
|
|
"module"
|
|
]
|
|
},
|
|
"answer": {
|
|
"type": "object",
|
|
"properties": {
|
|
"module": {
|
|
"type": "string",
|
|
"description": "the module"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "the reserved version, MAJOR.MINOR.PATCH"
|
|
},
|
|
"artifacts": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"artifact": {
|
|
"type": "string",
|
|
"description": "the artifact reference, <module>:<artifact>"
|
|
},
|
|
"digest": {
|
|
"type": "string",
|
|
"description": "its digest once built; empty before"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"module",
|
|
"version",
|
|
"artifacts"
|
|
]
|
|
}
|
|
}
|
|
],
|
|
"events": [
|
|
{
|
|
"name": "package-published",
|
|
"keep": {
|
|
"max-age-days": 90,
|
|
"max-mib": 128
|
|
},
|
|
"body": {
|
|
"$ref": "#/defs/PackagePublished"
|
|
}
|
|
},
|
|
{
|
|
"name": "toolchain-agreed",
|
|
"keep": {
|
|
"max-age-days": 90,
|
|
"max-mib": 16
|
|
},
|
|
"body": {
|
|
"$ref": "#/defs/ToolchainAgreed"
|
|
}
|
|
}
|
|
],
|
|
"family": {
|
|
"name": "mesh-builds.events",
|
|
"max-age-days": 7
|
|
},
|
|
"defs": {
|
|
"Dependency": {
|
|
"type": "object",
|
|
"properties": {
|
|
"artifact": {
|
|
"type": "string",
|
|
"description": "the dependency's artifact reference, <module>:<artifact>"
|
|
},
|
|
"kind": {
|
|
"type": "integer",
|
|
"enum": [
|
|
1,
|
|
3
|
|
],
|
|
"description": "1 an imported package, 3 the build toolchain (design 47 G section 374)"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "the version of the dependency the build resolved"
|
|
},
|
|
"digest": {
|
|
"type": "string",
|
|
"description": "the digest of the part, as the build used it"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact",
|
|
"kind",
|
|
"version",
|
|
"digest"
|
|
],
|
|
"description": "a dependency the build resolved, named by the build module in its step key and carried by the builder (design 47 G section 374)"
|
|
},
|
|
"PackagePublished": {
|
|
"type": "object",
|
|
"properties": {
|
|
"v": {
|
|
"type": "integer"
|
|
},
|
|
"artifact": {
|
|
"type": "string",
|
|
"description": "the package's artifact reference, <module>:<artifact>, from the catalog entry"
|
|
},
|
|
"module": {
|
|
"type": "string",
|
|
"description": "the module"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "the version the build reserved, MAJOR.MINOR.PATCH"
|
|
},
|
|
"digest": {
|
|
"type": "string",
|
|
"description": "the published artifact's digest"
|
|
},
|
|
"branch": {
|
|
"type": "string",
|
|
"description": "the watched branch the build was made from"
|
|
},
|
|
"source": {
|
|
"type": "integer",
|
|
"description": "the source revision of that branch the build was made from"
|
|
},
|
|
"dependencies": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/defs/Dependency"
|
|
},
|
|
"description": "each dependency the build resolved, with its version and digest"
|
|
},
|
|
"at": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
}
|
|
},
|
|
"required": [
|
|
"v",
|
|
"artifact",
|
|
"module",
|
|
"version",
|
|
"digest",
|
|
"branch",
|
|
"source"
|
|
],
|
|
"description": "one artifact published at the module's reserved version (design 47 G section 52, section 334)"
|
|
},
|
|
"ToolchainAgreed": {
|
|
"type": "object",
|
|
"properties": {
|
|
"v": {
|
|
"type": "integer"
|
|
},
|
|
"language": {
|
|
"type": "string",
|
|
"description": "the language whose agreed toolchain changed"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "the agreed toolchain's version"
|
|
},
|
|
"digest": {
|
|
"type": "string",
|
|
"description": "the toolchain part's digest"
|
|
},
|
|
"at": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
}
|
|
},
|
|
"required": [
|
|
"v",
|
|
"language",
|
|
"version",
|
|
"digest"
|
|
],
|
|
"description": "the agreed toolchain of a language changed (design 47 G section 376, ADR 0584 section 1)"
|
|
}
|
|
}
|
|
}
|