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:
+7
-2
@@ -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;
|
||||
|
||||
@@ -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
@@ -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 {};
|
||||
|
||||
Reference in New Issue
Block a user