A step's key keeps its answer only within what the steps state holds per value (kvlimit.ModuleStateValueBytes less the headers' room). Over it, finish keeps the answer with the holder's KeepOutput as the object output.<ask> in its outputs store and the key names it in output-object: a check's whole answer, its result emptied; a run's output, the key keeping the run answer without it. An answer that cannot be kept ends the key failed, saying why. The Puller says step-ended from the end finish wrote, so the key and the event say one outcome: a run whose program exited other than 0 ends its key failed as well, its answer kept; step-ended names the object finish kept instead of putting it twice. Step.Whole reads a key's object back through the seat's verb output on the step's node. The part build-step's Step gains output-object, the verb output says it answers a step's answer; fixtures and the generated contracts follow. Builds: design 47 G A-290, A-254, §467 Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
319 lines
8.0 KiB
JSON
319 lines
8.0 KiB
JSON
[
|
|
{
|
|
"name": "a running step",
|
|
"of": "state:steps/<node>.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "a1b2",
|
|
"tool": "build",
|
|
"node": "ace",
|
|
"state": "running",
|
|
"started": "2026-11-05T10:00:00Z"
|
|
}
|
|
},
|
|
{
|
|
"name": "a paused node",
|
|
"of": "state:pauses/paused.<node>",
|
|
"given": {
|
|
"v": 1,
|
|
"paused": true,
|
|
"by": "operator@shanks",
|
|
"at": "2026-11-05T10:00:00Z"
|
|
}
|
|
},
|
|
{
|
|
"name": "a node's capacity",
|
|
"of": "state:pauses/capacity.<node>",
|
|
"given": {
|
|
"v": 1,
|
|
"effective": 2,
|
|
"configured": 2,
|
|
"why": "the configured steps fit the cores"
|
|
}
|
|
},
|
|
{
|
|
"name": "a node's toolchain",
|
|
"of": "state:toolchains/<node>.<language>",
|
|
"given": {
|
|
"v": 1,
|
|
"language": "go",
|
|
"version": "1.26.0",
|
|
"recipe": "1"
|
|
}
|
|
},
|
|
{
|
|
"name": "a node's toolchain with its program's digest (G 472)",
|
|
"of": "state:toolchains/<node>.<language>",
|
|
"given": {
|
|
"v": 1,
|
|
"language": "go",
|
|
"version": "1.26.0",
|
|
"recipe": "1",
|
|
"digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
|
|
}
|
|
},
|
|
{
|
|
"name": "a build ask",
|
|
"of": "accept:delivery",
|
|
"subject": "mesh.seat.node-build-node.accept.delivery",
|
|
"given": {
|
|
"id": "a1b2",
|
|
"kind": "build",
|
|
"language": "go",
|
|
"asker": "mesh-delivery-builder",
|
|
"build": {
|
|
"module": "nats",
|
|
"artifacts": [
|
|
{
|
|
"artifact": "go"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "a build ask with the version the builder reserved (G 573)",
|
|
"of": "accept:delivery",
|
|
"subject": "mesh.seat.node-build-node.accept.delivery",
|
|
"given": {
|
|
"id": "a1b3",
|
|
"kind": "build",
|
|
"language": "go",
|
|
"asker": "mesh-delivery-builder",
|
|
"version": "1.4.2",
|
|
"build": {
|
|
"module": "nats",
|
|
"artifacts": [
|
|
{
|
|
"artifact": "go"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "a check ask with the group's packages",
|
|
"of": "accept:check",
|
|
"subject": "mesh.seat.node-build-node.accept.check",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "c3d5",
|
|
"kind": "check",
|
|
"language": "typescript",
|
|
"asker": "mesh-delivery-checker",
|
|
"at": "2026-11-05T10:00:00Z",
|
|
"check": {
|
|
"fetch": {
|
|
"repository": "novox/mesh-catalog",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567",
|
|
"ref": "refs/pull/7/head",
|
|
"base": "89abcdef0123456789abcdef0123456789abcdef",
|
|
"group-packages": [
|
|
{
|
|
"repository": "novox/mesh-sdk",
|
|
"commit": "fedcba9876543210fedcba9876543210fedcba98",
|
|
"ref": "refs/pull/12/head"
|
|
},
|
|
{
|
|
"repository": "novox/mesh-delivery",
|
|
"commit": "76543210fedcba9876543210fedcba9876543210",
|
|
"ref": "refs/pull/9/head",
|
|
"path": "modules/mesh-delivery-contracts/ts/seats/git"
|
|
}
|
|
]
|
|
},
|
|
"levels": [
|
|
"unit",
|
|
"integration"
|
|
],
|
|
"kept": true,
|
|
"toolchain": {
|
|
"language": "typescript",
|
|
"version": "26.12.0",
|
|
"recipe": "1"
|
|
},
|
|
"node-names": [
|
|
"ace",
|
|
"g14"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "a finished check step of a TypeScript merge preview",
|
|
"of": "state:steps/<node>.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "c3d6",
|
|
"tool": "check",
|
|
"node": "ace",
|
|
"state": "passed",
|
|
"started": "2026-11-05T10:00:00Z",
|
|
"ended": "2026-11-05T10:01:00Z",
|
|
"result": {
|
|
"fetch": {
|
|
"workspace": "mvii1sxt979f67",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567",
|
|
"modules": [
|
|
"modules/m"
|
|
],
|
|
"base": "abcdef0123456789abcdef0123456789abcdef01",
|
|
"merge": "0123456789abcdef0123456789abcdef01234567",
|
|
"changed": [
|
|
"modules/m/package.json"
|
|
],
|
|
"trees": {
|
|
"modules/m": {
|
|
"tree": "0123456789abcdef0123456789abcdef01234567",
|
|
"manifest": "0581b699d9d05517e69b21f5cedbeb2eee8aba2b205280b561be731594d7feef"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "a step ended on a transport fault, given again by the bus",
|
|
"of": "state:steps/<node>.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "a1b2",
|
|
"tool": "build",
|
|
"node": "ace",
|
|
"state": "again",
|
|
"started": "2026-11-05T10:00:00Z",
|
|
"ended": "2026-11-05T10:00:30Z",
|
|
"reason": "fetching the commit: kex_exchange_identification: read: Connection reset by peer",
|
|
"run": 1,
|
|
"again-at": "2026-11-05T10:01:30Z",
|
|
"passing": true
|
|
}
|
|
},
|
|
{
|
|
"name": "an ask dropped by the caller that no longer waits",
|
|
"of": "state:pauses/dropped.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"by": "mesh-delivery-builder",
|
|
"why": "a newer fingerprint supersedes it",
|
|
"at": "2026-11-05T10:00:00Z"
|
|
}
|
|
},
|
|
{
|
|
"name": "a step ask of the runner with its kept results",
|
|
"of": "accept:check.step",
|
|
"subject": "mesh.seat.node-build-node.accept.check.step",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "m2kx9a1b3c4d5e",
|
|
"kind": "step",
|
|
"language": "typescript",
|
|
"asker": "mesh-delivery-pipeline",
|
|
"at": "2026-11-10T10:00:00Z",
|
|
"step": {
|
|
"pipeline": "main.12.nats",
|
|
"step": "unit",
|
|
"module": "nats",
|
|
"artifact": "nats:program",
|
|
"branch": "main",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567",
|
|
"revision": 12,
|
|
"fingerprint": "fp-0123",
|
|
"fetch": {
|
|
"repository": "novox/mesh-catalog",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567"
|
|
},
|
|
"kept": [
|
|
{
|
|
"package": "./modules/nats/a",
|
|
"digest": "sha256:bbbb",
|
|
"level": "unit",
|
|
"pipeline": "main.11.nats"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "a recovery's step ask of the runner, on the stream delivery",
|
|
"of": "accept:delivery.step",
|
|
"subject": "mesh.seat.node-build-node.accept.delivery.step",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "m2kx9a1b3c4d5e",
|
|
"kind": "step",
|
|
"language": "typescript",
|
|
"asker": "mesh-delivery-pipeline",
|
|
"at": "2026-11-10T10:00:00Z",
|
|
"step": {
|
|
"pipeline": "main.12.nats",
|
|
"step": "unit",
|
|
"module": "nats",
|
|
"artifact": "nats:program",
|
|
"branch": "main",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567",
|
|
"revision": 12,
|
|
"fingerprint": "fp-0123",
|
|
"fetch": {
|
|
"repository": "novox/mesh-catalog",
|
|
"commit": "0123456789abcdef0123456789abcdef01234567"
|
|
},
|
|
"kept": [
|
|
{
|
|
"package": "./modules/nats/a",
|
|
"digest": "sha256:bbbb",
|
|
"level": "unit",
|
|
"pipeline": "main.11.nats"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"name": "an artifact's detected steps",
|
|
"of": "state:detected-steps/<module>.<artifact>",
|
|
"given": {
|
|
"v": 1,
|
|
"fingerprint": "fp-0123",
|
|
"steps": [
|
|
{
|
|
"step": "lint"
|
|
},
|
|
{
|
|
"step": "unit",
|
|
"packages": [
|
|
"./modules/nats/a"
|
|
]
|
|
}
|
|
],
|
|
"at": "2026-11-10T10:00:00Z"
|
|
}
|
|
},
|
|
{
|
|
"name": "a step keyed under its asker",
|
|
"of": "state:steps/<asker>.<node>.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "a1b2",
|
|
"tool": "build",
|
|
"node": "ace",
|
|
"state": "running",
|
|
"started": "2026-11-05T10:00:00Z"
|
|
}
|
|
},
|
|
{
|
|
"name": "a check's step whose answer is kept as an object (G A-290)",
|
|
"of": "state:steps/<node>.<id>",
|
|
"given": {
|
|
"v": 1,
|
|
"id": "c3d4e5f6a7b8c9",
|
|
"tool": "check",
|
|
"node": "ace",
|
|
"state": "passed",
|
|
"started": "2026-11-05T10:00:00Z",
|
|
"ended": "2026-11-05T10:05:00Z",
|
|
"output-object": "output.c3d4e5f6a7b8c9"
|
|
}
|
|
}
|
|
]
|