CT12: the build seats' ask carries its version, every ask says ask-taken and step-ended (issue 1966)

The builder's reserved version reaches the build in the ask; a holder says when it takes and ends
any ask, a builder's build included, so the watchman times every ask; the toolchains key names its
program's digest; the checker may drop its own asks until its removal. step-progress and ask-taken
name no keep and go on the shared events stream. The delivery SDK's neutral forms follow the part.

Builds: design 47 G §472, §548, §549, §552, §573, §602, §603

Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
2026-11-11 20:27:39 +01:00
parent c7ad2477f0
commit 7ecae5a6dd
34 changed files with 622 additions and 127 deletions
+7 -2
View File
@@ -27,6 +27,7 @@ export declare const events: {
readonly stepEnded: "step-ended";
readonly toolchainReported: "toolchain-reported";
readonly stepProgress: "step-progress";
readonly askTaken: "ask-taken";
};
export declare const family: { readonly name: "node-build-node.events"; readonly maxAgeDays: 7 };
@@ -43,12 +44,14 @@ export declare function toolchainReportedSubject(node: string): string;
export declare const toolchainReportedSubjectAll: "mesh.seat.node-build-node.event.toolchain-reported.*";
export declare const stepProgressStream: "SEAT_node-build-node_step-progress";
export declare function stepProgressSubject(node: string): string;
export declare const stepProgressSubjectAll: "mesh.seat.node-build-node.event.step-progress.*";
export declare function askTakenSubject(node: string): string;
export declare const askTakenSubjectAll: "mesh.seat.node-build-node.event.ask-taken.*";
export declare const deliverySubject: "mesh.seat.node-build-node.accept.delivery";
export declare const checkSubject: "mesh.seat.node-build-node.accept.check";
@@ -109,6 +112,8 @@ export declare function detectedStepsByModuleArtifactKey(module: string, artifac
export declare function parseDetectedStepsByModuleArtifactKey(_key: string): { module: string; artifact: string } | undefined;
export type AskArtifact = buildStep.AskArtifact;
export type AskTaken = buildStep.AskTaken;
export type AskTakenEvent = buildStep.AskTakenEvent;
export type BuildAnswer = buildStep.BuildAnswer;
export type BuiltArtifact = buildStep.BuiltArtifact;
export type BuiltArtifactResolvedItem = buildStep.BuiltArtifactResolvedItem;
+7 -2
View File
@@ -25,6 +25,7 @@ export const events = {
stepEnded: "step-ended",
toolchainReported: "toolchain-reported",
stepProgress: "step-progress",
askTaken: "ask-taken",
};
export const family = { name: "node-build-node.events", maxAgeDays: 7 };
@@ -45,14 +46,18 @@ export function toolchainReportedSubject(node) {
export const toolchainReportedSubjectAll = "mesh.seat.node-build-node.event.toolchain-reported.*";
export const stepProgressStream = "SEAT_node-build-node_step-progress";
export function stepProgressSubject(node) {
return "mesh.seat.node-build-node.event.step-progress." + node;
}
export const stepProgressSubjectAll = "mesh.seat.node-build-node.event.step-progress.*";
export function askTakenSubject(node) {
return "mesh.seat.node-build-node.event.ask-taken." + node;
}
export const askTakenSubjectAll = "mesh.seat.node-build-node.event.ask-taken.*";
export const deliverySubject = "mesh.seat.node-build-node.accept.delivery";
export const checkSubject = "mesh.seat.node-build-node.accept.check";
+31 -7
View File
@@ -15,6 +15,7 @@ export declare const events: {
readonly stepEnded: "step-ended";
readonly toolchainReported: "toolchain-reported";
readonly stepProgress: "step-progress";
readonly askTaken: "ask-taken";
};
/** one artifact of a build ask: built from the fetched tree, or copied from an upstream pin */
@@ -25,6 +26,16 @@ export interface AskArtifact {
"version"?: string;
}
/** an ask a build seat's holder took, said when it takes any ask, whatever its asker (design 47 G section 602) */
export interface AskTaken {
/** the ask's id */
"ask": string;
"asker": string;
"at": string;
/** the node that took it, as in the subject */
"node": string;
}
export interface BuildAnswer {
"artifacts": BuiltArtifact[];
"imports"?: string[];
@@ -392,23 +403,31 @@ export interface StepAsk {
"step"?: StepRun;
/** the layout version */
"v"?: number;
/** the version MAJOR.MINOR.PATCH the builder reserved for the build, passed to it as MESH_VERSION; empty for a build that reserves none, which stamps none (design 47 G section 573) */
"version"?: string;
}
/** a pipeline step's end, said by the build seat's holder on the node that ran it (ADR 0666 sections 7, 21): the runner takes it only from that holder's account, naming the ask, the commit and the fingerprint it was asked at */
/** an ask's end, said by the build seat's holder on the node that ran it, whatever its asker (design 47 G section 602): a pipeline step's end names the pipeline, the commit and the fingerprint it was asked at, which the runner takes only from that holder's account (ADR 0666 sections 7, 21); the end of any other ask names its asker, the ask, the node, the outcome and when, and neither commit nor fingerprint (design 47 G section 548) */
export interface StepEnded {
"artifact": string;
"artifact"?: string;
/** the ask's id, by which a reader takes only its own asks */
"ask": string;
/** who asked it */
"asker": string;
/** when it ended (RFC 3339 time) */
"at": string;
/** for a rerun, the caller the runtime proved */
"by"?: string;
/** the packages not run because the ask's kept results held them */
"carried"?: KeptResult[];
"commit": string;
"commit"?: string;
"ended"?: string;
"fingerprint": string;
"fingerprint"?: string;
/** the ask's id */
"id": string;
/** the packages that passed at their digest, for the runner to keep */
"kept"?: KeptResult[];
"module": string;
"module"?: string;
/** the node that ran it, as in the subject */
"node": string;
/** never passed for a step that ran nothing */
@@ -417,12 +436,12 @@ export interface StepEnded {
"output"?: string;
/** the output's object in the sender's sent store, when over the per-message limit (ADR 0666 section 16) */
"output-object"?: string;
"pipeline": string;
"pipeline"?: string;
"rerun"?: boolean;
/** why it failed or could not run, naming the part not heard */
"said"?: string;
"started"?: string;
"step": "lint" | "unit" | "integration";
"step"?: "lint" | "unit" | "integration";
"tests"?: TestCounts;
/** the layout version */
"v"?: number;
@@ -513,6 +532,8 @@ export interface TestCounts {
export interface Toolchain {
/** when (RFC 3339 time) */
"at"?: string;
/** the sha256: digest of the language's toolchain program as the build module runs it: the program of the module that provides that language's toolchain, never the build module's own (design 47 G section 472) */
"digest"?: string;
/** go or typescript */
"language": string;
"recipe": string;
@@ -643,3 +664,6 @@ export type ToolchainReportedEvent = ToolchainReported;
/** is the body of the event step-progress. */
export type StepProgressEvent = StepProgress;
/** is the body of the event ask-taken. */
export type AskTakenEvent = AskTaken;
@@ -15,6 +15,7 @@ export const events = {
stepEnded: "step-ended",
toolchainReported: "toolchain-reported",
stepProgress: "step-progress",
askTaken: "ask-taken",
};
export {};