MV1: move contracts and sdk under modules/, importers follow

The delivery repository's contracts and SDK live under modules/ as
mesh-delivery-contracts and mesh-delivery-sdk, their Go module paths
renamed to match the folders (the TypeScript names already did), and
every importer in mesh-delivery, mesh-catalog, mesh-host, mesh-tools
and mesh-sdk follows in the same group: a design as it should be, one
path per module, checked by the group's check building every importer.

Builds: design 47 G §427, §88

Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
This commit is contained in:
2026-11-12 05:09:56 +01:00
parent 512bb3c75c
commit 71a35a6376
769 changed files with 1277 additions and 1277 deletions
@@ -0,0 +1,112 @@
[
{
"name": "a unit step ended passed on its node, with its counts and what it carried",
"of": "event:step-ended",
"subject": "mesh.seat.node-build-node.event.step-ended.ace",
"given": {
"v": 1,
"id": "m2kx9a1b3c4d5e",
"asker": "mesh-delivery-pipeline",
"ask": "m2kx9a1b3c4d5e",
"pipeline": "main.12.nats",
"step": "unit",
"module": "nats",
"artifact": "nats:program",
"commit": "0123456789abcdef0123456789abcdef01234567",
"fingerprint": "fp-0123",
"node": "ace",
"outcome": "passed",
"tests": {
"unit": 14
},
"carried": [
{
"package": "./modules/nats/a",
"digest": "sha256:bbbb",
"level": "unit"
}
],
"kept": [
{
"package": "./modules/nats/b",
"digest": "sha256:cccc",
"level": "unit"
}
],
"started": "2026-11-10T10:00:00Z",
"ended": "2026-11-10T10:02:00Z",
"at": "2026-11-10T10:02:00Z"
}
},
{
"name": "an integration step that could not run, naming the part not heard",
"of": "event:step-ended",
"subject": "mesh.seat.node-build-node.event.step-ended.g14",
"given": {
"v": 1,
"id": "m2kx9a1b3c4d5f",
"asker": "mesh-delivery-pipeline",
"ask": "m2kx9a1b3c4d5f",
"pipeline": "main.12.nats",
"step": "integration",
"module": "nats",
"artifact": "nats:program",
"commit": "0123456789abcdef0123456789abcdef01234567",
"fingerprint": "fp-0123",
"node": "g14",
"outcome": "could not run",
"said": "the sandbox could not fetch novox/mesh-sdk",
"output-object": "mesh-build-go_sent-objects/m2kx9a1b3c4d5f",
"at": "2026-11-10T10:02:00Z"
}
},
{
"name": "a node's toolchain reported",
"of": "event:toolchain-reported",
"subject": "mesh.seat.node-build-node.event.toolchain-reported.ace",
"given": {
"node": "ace",
"language": "go",
"version": "1.26.0",
"recipe": "1",
"digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
},
{
"name": "a running ask says its progress",
"of": "event:step-progress",
"subject": "mesh.seat.node-build-node.event.step-progress.ace",
"given": {
"asker": "runner",
"ask": "a1b2",
"phase": "fetch",
"at": "2026-11-11T10:01:00Z"
}
},
{
"name": "a builder's build ended, naming its asker and no commit or fingerprint (G 548)",
"of": "event:step-ended",
"subject": "mesh.seat.node-build-node.event.step-ended.ace",
"given": {
"v": 1,
"id": "m2kx9a1b3c4d6a",
"asker": "mesh-delivery-builder",
"ask": "m2kx9a1b3c4d6a",
"node": "ace",
"outcome": "failed",
"said": "the build failed",
"at": "2026-11-11T10:03:00Z"
}
},
{
"name": "an ask taken, whatever its asker (G 602)",
"of": "event:ask-taken",
"subject": "mesh.seat.node-build-node.event.ask-taken.ace",
"given": {
"asker": "mesh-delivery-builder",
"ask": "m2kx9a1b3c4d6a",
"node": "ace",
"at": "2026-11-11T10:00:00Z"
}
}
]
@@ -0,0 +1,295 @@
[
{
"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 tagged package",
"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-delivery",
"commit": "0123456789abcdef0123456789abcdef01234567",
"ref": "refs/pull/7/head",
"base": "89abcdef0123456789abcdef0123456789abcdef",
"package": {
"name": "@novox/mesh-sdk",
"version": "0.1.15-feat-x.1"
}
},
"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"
}
}
]
@@ -0,0 +1,128 @@
[
{
"name": "drop names the ask and why",
"of": "verb:drop.input",
"given": {
"id": "a1b2",
"by": "mesh-delivery-builder",
"why": "a newer fingerprint supersedes it"
}
},
{
"name": "kept-artifact asks",
"of": "verb:kept-artifact.input",
"given": {
"module": "artifact-store",
"fp": "src2:1480985e",
"digest": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
}
},
{
"name": "kept-artifact answers where the bytes are",
"of": "verb:kept-artifact.answer",
"given": {
"module": "artifact-store",
"fp": "src2:1480985e",
"digest": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
"size": 18874368,
"store": "mesh-build-go-kept",
"object": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
}
},
{
"name": "kept-artifact refuses a module that is claims no oci-artifact-registry",
"of": "verb:kept-artifact.answer",
"given": {
"module": "mesh-delivery-gate",
"fp": "src2:aaaaaaaa",
"refused": "claims no oci-artifact-registry",
"words": "mesh-delivery-gate claims no oci-artifact-registry: its build is fetched from the store"
}
},
{
"name": "kept-artifact refuses a build it no longer keeps",
"of": "verb:kept-artifact.answer",
"given": {
"module": "artifact-store",
"fp": "src2:1480985e",
"refused": "not kept",
"words": "this node keeps no build of artifact-store at src2:1480985e"
}
},
{
"name": "kept-artifact refuses a build kept under another digest",
"of": "verb:kept-artifact.answer",
"given": {
"module": "artifact-store",
"fp": "src2:1480985e",
"digest": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"refused": "digest differs",
"words": "artifact-store at src2:1480985e is kept as eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
}
},
{
"name": "kept-artifact answers an error, never none",
"of": "verb:kept-artifact.answer",
"given": {
"module": "artifact-store",
"fp": "src2:1480985e",
"error": "the kept builds could not be read"
}
},
{
"name": "steps asks an artifact's pipeline steps at a commit",
"of": "verb:steps.input",
"given": {
"module": "nats",
"artifact": "nats:program",
"fingerprint": "fp-0123",
"fetch": {
"repository": "novox/mesh-catalog",
"commit": "0123456789abcdef0123456789abcdef01234567"
}
}
},
{
"name": "steps answers lint and unit tests",
"of": "verb:steps.answer",
"given": {
"artifact": "nats:program",
"fingerprint": "fp-0123",
"steps": [
{
"step": "lint"
},
{
"step": "unit",
"packages": [
"./modules/nats"
]
}
]
}
},
{
"name": "steps drops an artifact's kept steps with a reason",
"of": "verb:steps.input",
"given": {
"module": "nats",
"artifact": "nats.program",
"drop": true,
"why": "the detection was wrong"
}
},
{
"name": "steps answers a drop with the artifact",
"of": "verb:steps.answer",
"given": {
"dropped": "nats.program"
}
},
{
"name": "steps answers a drop that the hand-act log refused",
"of": "verb:steps.answer",
"given": {
"error": "the hand-act log refused: nothing was deleted"
}
}
]
@@ -0,0 +1,157 @@
{
"format": 1,
"seat": "node-build-node",
"scope": "node",
"grain": "whole",
"domain": "Delivery",
"decision": "novox/hq ADR 0525, ADR 0536, ADR 0553",
"pulled-by-kind": true,
"yields": true,
"acts": [
{
"step": "build",
"on": "typescript",
"bound": "60m"
}
],
"accepts": [
{
"name": "delivery",
"body": {
"$ref": "#/defs/StepAsk"
},
"callers": [
"seat:mesh-builds"
]
},
{
"name": "check",
"body": {
"$ref": "#/defs/StepAsk"
},
"callers": [
"seat:mesh-delivery-checker"
]
},
{
"name": "step",
"stream": "check",
"body": {
"$ref": "#/defs/StepAsk"
},
"callers": [
"seat:mesh-pipeline-runner"
]
},
{
"name": "step",
"stream": "delivery",
"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.",
"includes": [
"build-step"
],
"states": [
{
"name": "steps",
"template": "state",
"key-forms": [
{
"key": "<asker>.<node>.<id>",
"value": {
"$ref": "#/defs/Step"
},
"description": "a step on a node, keyed by the asker the bus proves (design 47 G section 467, section 481)"
},
{
"key": "<node>.<id>",
"value": {
"$ref": "#/defs/Step"
},
"description": "a step whose ask came on main's subject, with no asker's name (design 47 G section 483)"
}
],
"description": "the steps this module runs",
"history": 5
},
{
"name": "pauses",
"template": "state",
"key-forms": [
{
"key": "paused.<node>",
"value": {
"$ref": "#/defs/Pause"
},
"description": "whether a node is paused"
},
{
"key": "dropped.<id>",
"value": {
"$ref": "#/defs/Drop"
},
"description": "an ask its caller no longer waits for"
},
{
"key": "capacity.<node>",
"value": {
"$ref": "#/defs/Capacity"
},
"description": "a node's capacity"
}
],
"description": "the pause and the capacity of each node",
"history": 1
},
{
"name": "toolchains",
"template": "state",
"key-forms": [
{
"key": "<node>.<language>",
"value": {
"$ref": "#/defs/Toolchain"
},
"description": "the toolchain a node reports"
}
],
"description": "the toolchains the nodes report",
"history": 1
},
{
"name": "detected-steps",
"template": "state",
"history": 1,
"description": "each artifact's detected steps, one key per artifact (design 47 G section 326, section 414)",
"key-forms": [
{
"key": "<module>.<artifact>",
"value": {
"$ref": "#/defs/DetectedSteps"
},
"description": "an artifact's detected steps"
}
]
}
],
"family": {
"name": "node-build-node.events",
"max-age-days": 7
}
}