Files
mesh-delivery/contracts/seats/mesh-builds/seat.json
T
jschoubben 72ac9b09cb CT11: regenerate the Go and TypeScript contracts from CT1 to CT9; each TypeScript contract as index.js with index.d.ts
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
2026-11-11 10:48:56 +01:00

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)"
}
}
}