npm - @zxyycom/vibe-check - Versions diffs - 0.0.2 → 0.0.3 - Mend

@zxyycom/vibe-check 0.0.2 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (670) hide show

package/dist/esm/project-definition/check-tree/check-fields-authoring.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"check-fields-authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/check-fields-authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport {\n type CheckVisibility,\n type CheckFlagEnablement,\n type CheckFlagEnablementMode,\n type CheckExecution,\n type CheckPreflight\n} from \"../../check/check.ts\";\nimport { validateCheckDescriptor } from \"../../check/descriptor-validation.ts\";\nimport { snapshotJsonObject } from \"../../check/options-snapshot.ts\";\nimport { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { parseUniqueIdentifiers } from \"./collection-authoring.ts\";\n\nexport type TrustedDataParser = (this: void, ...parameters: never[]) => unknown;\n\nexport interface CheckAuthoringData extends Readonly<Record<string, unknown>> {\n readonly checkId: string;\n readonly displayName: string;\n}\n\nexport interface ParsedCheckFields {\n readonly definition: CheckDescriptor \| null;\n readonly enabledByFlags: CheckFlagEnablement \| null;\n readonly execution: CheckExecution \| null;\n readonly options: object \| null;\n readonly parseData: TrustedDataParser \| null;\n readonly preflight: CheckPreflight \| null;\n readonly visibility: CheckVisibility \| null;\n}\n\nexport interface ParsedCheckFieldPrelude {\n readonly enabledByFlags: CheckFlagEnablement \| null;\n readonly execution: CheckExecution \| null;\n readonly parseData: TrustedDataParser \| null;\n readonly preflight: CheckPreflight \| null;\n}\n\ninterface ParsedFlagEnablementControl extends Readonly<Record<string, unknown>> {\n readonly flags: unknown;\n readonly mode: CheckFlagEnablementMode;\n readonly propagateDependsOn?: true;\n}\n\nconst CHECK_KEYS = [\n \"admissionPriority\",\n \"checkId\",\n \"checks\",\n \"dependsOn\",\n \"displayName\",\n \"enabledByFlags\",\n \"execution\",\n \"maxParallel\",\n \"mutex\",\n \"options\",\n \"observes\",\n \"parseData\",\n \"preflight\",\n \"resourceClaims\",\n \"visibility\"\n] as const;\nconst FLAG_ENABLEMENT_KEYS = [\"flags\", \"mode\", \"propagateDependsOn\"] as const;\n\nconst CONTAINER_CHECK_FIELDS: ParsedCheckFields = Object.freeze({\n definition: null,\n enabledByFlags: null,\n execution: null,\n options: null,\n parseData: null,\n preflight: null,\n visibility: null\n});\n\nexport function parseCheckAuthoringData(value: unknown): CheckAuthoringData \| undefined {\n const data = snapshotClosedRecord(value);\n return data !== undefined && hasValidCheckIdentity(data) ? data : undefined;\n}\n\nfunction hasValidCheckIdentity(\n data: Readonly<Record<string, unknown>>\n): data is CheckAuthoringData {\n return (\n hasOnlyCheckKeys(data) &&\n typeof data.checkId === \"string\" &&\n data.checkId.length > 0 &&\n typeof data.displayName === \"string\" &&\n data.displayName.length > 0\n );\n}\n\nexport function parseCheckFieldPrelude(\n data: CheckAuthoringData\n): ParsedCheckFieldPrelude \| undefined {\n const execution = parseExecution(data);\n if (execution === undefined) return undefined;\n const parseData = parseDataParser(data);\n if (parseData === undefined) return undefined;\n const preflight = parsePreflight(data);\n if (preflight === undefined) return undefined;\n const enabledByFlags = parseEnabledByFlags(data);\n return enabledByFlags === undefined\n ? undefined\n : Object.freeze({ enabledByFlags, execution, parseData, preflight });\n}\n\nexport function parseCheckFields(\n data: CheckAuthoringData,\n prelude: ParsedCheckFieldPrelude\n): ParsedCheckFields \| undefined {\n if (prelude.execution === null) {\n return Object.hasOwn(data, \"options\") \|\|\n Object.hasOwn(data, \"enabledByFlags\") \|\|\n Object.hasOwn(data, \"visibility\") \|\|\n prelude.parseData !== null \|\|\n prelude.preflight !== null\n ? undefined\n : CONTAINER_CHECK_FIELDS;\n }\n const definition = parseDefinition(data);\n if (definition === undefined) return undefined;\n const options = parseOptions(data);\n if (options === undefined) return undefined;\n const visibility = parseVisibility(data);\n if (visibility === undefined) return undefined;\n return Object.freeze({\n definition,\n enabledByFlags: prelude.enabledByFlags,\n execution: prelude.execution,\n options,\n parseData: prelude.parseData,\n preflight: prelude.preflight,\n visibility\n });\n}\n\nfunction hasOnlyCheckKeys(data: Readonly<Record<string, unknown>>): boolean {\n return Object.keys(data).every((key) => CHECK_KEYS.some((checkKey) => checkKey === key));\n}\n\nfunction parseExecution(data: CheckAuthoringData): CheckExecution \| null \| undefined {\n if (!Object.hasOwn(data, \"execution\")) return null;\n return isTrustedFunction<CheckExecution>(data.execution) ? data.execution : undefined;\n}\n\nfunction parseDataParser(data: CheckAuthoringData): TrustedDataParser \| null \| undefined {\n if (!Object.hasOwn(data, \"parseData\") \|\| data.parseData === undefined) return null;\n return isTrustedFunction<TrustedDataParser>(data.parseData) ? data.parseData : undefined;\n}\n\nfunction parsePreflight(data: CheckAuthoringData): CheckPreflight \| null \| undefined {\n if (!Object.hasOwn(data, \"preflight\")) return null;\n return isTrustedFunction<CheckPreflight>(data.preflight) ? data.preflight : undefined;\n}\n\nfunction isTrustedFunction<FunctionType extends (...parameters: never[]) => unknown>(\n value: unknown\n): value is FunctionType {\n return typeof value === \"function\";\n}\n\nfunction parseDefinition(data: CheckAuthoringData): CheckDescriptor \| undefined {\n const definition = validateCheckDescriptor({\n checkId: data.checkId,\n displayName: data.displayName\n });\n return definition.ok ? definition.value : undefined;\n}\n\nfunction parseOptions(data: CheckAuthoringData): object \| undefined {\n if (!Object.hasOwn(data, \"options\")) return Object.freeze({});\n const options = snapshotClosedRecord(data.options);\n if (options === undefined) return undefined;\n return snapshotJsonObject(options);\n}\n\nfunction parseEnabledByFlags(data: CheckAuthoringData): CheckFlagEnablement \| null \| undefined {\n if (!Object.hasOwn(data, \"enabledByFlags\")) return null;\n const control = parseFlagEnablementControl(data.enabledByFlags);\n if (control === undefined) return undefined;\n const flags = parseUniqueIdentifiers(control.flags);\n return flags === undefined ? undefined : canonicalFlagEnablement(control, flags);\n}\n\nfunction parseFlagEnablementControl(value: unknown): ParsedFlagEnablementControl \| undefined {\n const control = snapshotClosedRecord(value);\n if (control === undefined \|\| !hasOnlyFlagEnablementKeys(control)) return undefined;\n return hasFlagEnablementFields(control) ? control : undefined;\n}\n\nfunction hasFlagEnablementFields(\n control: Readonly<Record<string, unknown>>\n): control is ParsedFlagEnablementControl {\n if (!Object.hasOwn(control, \"flags\") \|\| !Object.hasOwn(control, \"mode\")) return false;\n if (!isCheckFlagEnablementMode(control.mode)) return false;\n return !Object.hasOwn(control, \"propagateDependsOn\") \|\| control.propagateDependsOn === true;\n}\n\nfunction canonicalFlagEnablement(\n control: ParsedFlagEnablementControl,\n flags: readonly string[]\n): CheckFlagEnablement \| undefined {\n const [firstFlag, ...remainingFlags] = [...flags].sort();\n if (firstFlag === undefined) return undefined;\n const canonicalFlags: [string, ...string[]] = [firstFlag, ...remainingFlags];\n return Object.freeze({\n flags: Object.freeze(canonicalFlags),\n mode: control.mode,\n ...(control.propagateDependsOn === true ? { propagateDependsOn: true as const } : {})\n });\n}\n\nfunction hasOnlyFlagEnablementKeys(control: Readonly<Record<string, unknown>>): boolean {\n return Object.keys(control).every((key) =>\n FLAG_ENABLEMENT_KEYS.some((allowed) => allowed === key)\n );\n}\n\nfunction isCheckFlagEnablementMode(value: unknown): value is CheckFlagEnablementMode {\n return value === \"all\" \|\| value === \"any\" \|\| value === \"none\" \|\| value === \"not-all\";\n}\n\nfunction parseVisibility(data: CheckAuthoringData): CheckVisibility \| undefined {\n if (!Object.hasOwn(data, \"visibility\")) return \"always\";\n const visibility = data.visibility;\n return visibility === undefined \|\| visibility === \"always\" \|\| visibility === \"attention\"\n ? (visibility ?? \"always\")\n : undefined;\n}\n"]}
1	+ {"version":3,"file":"check-fields-authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/check-fields-authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport { type Check, type CheckFlagEnablement, type CheckPreparation } from \"../../check/check.ts\";\nimport type { HandoffProviderIdentity } from \"../../check/handoff-provider-identity.ts\";\nimport { validateCheckDescriptor } from \"../../check/descriptor-validation.ts\";\nimport { snapshotJsonObject } from \"../../check/options-snapshot.ts\";\nimport { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { hasOnlyKeys, parseFlagCondition } from \"./flag-conditions.ts\";\n\nexport type TrustedDataParser = (this: void, ...parameters: never[]) => unknown;\n\nexport interface CheckAuthoringData extends Readonly<Record<string, unknown>> {\n readonly checkId: string;\n readonly displayName: string;\n}\n\nexport interface ParsedCheckFields {\n readonly definition: CheckDescriptor \| null;\n readonly enabledByFlags: CheckFlagEnablement \| null;\n readonly execute: NonNullable<Check[\"execute\"]> \| null;\n readonly handoff: HandoffProviderIdentity \| null;\n readonly options: object \| null;\n readonly parseData: TrustedDataParser \| null;\n readonly prepare: CheckPreparation \| null;\n readonly omitQuietPassedRow: boolean \| null;\n}\n\nexport interface ParsedCheckFieldPrelude {\n readonly enabledByFlags: CheckFlagEnablement \| null;\n readonly execute: NonNullable<Check[\"execute\"]> \| null;\n readonly handoff: HandoffProviderIdentity \| null;\n readonly parseData: TrustedDataParser \| null;\n readonly prepare: CheckPreparation \| null;\n}\n\nconst CHECK_KEYS = [\n \"admissionPriority\",\n \"checkId\",\n \"checks\",\n \"dependsOn\",\n \"displayName\",\n \"enabledByFlags\",\n \"execute\",\n \"handoff\",\n \"maxParallel\",\n \"mutex\",\n \"options\",\n \"observes\",\n \"parseData\",\n \"prepare\",\n \"resourceClaims\",\n \"omitQuietPassedRow\"\n] as const;\nconst FLAG_ENABLEMENT_EXPRESSION_KEYS = [\"when\", \"propagateDependsOn\"] as const;\n\nconst CONTAINER_CHECK_FIELDS: ParsedCheckFields = Object.freeze({\n definition: null,\n enabledByFlags: null,\n execute: null,\n handoff: null,\n options: null,\n parseData: null,\n prepare: null,\n omitQuietPassedRow: null\n});\n\nexport function parseCheckAuthoringData(value: unknown): CheckAuthoringData \| undefined {\n const data = snapshotClosedRecord(value);\n return data !== undefined && hasValidCheckIdentity(data) ? data : undefined;\n}\n\nfunction hasValidCheckIdentity(\n data: Readonly<Record<string, unknown>>\n): data is CheckAuthoringData {\n return (\n hasOnlyCheckKeys(data) &&\n typeof data.checkId === \"string\" &&\n data.checkId.length > 0 &&\n typeof data.displayName === \"string\" &&\n data.displayName.length > 0\n );\n}\n\nexport function parseCheckFieldPrelude(\n data: CheckAuthoringData,\n handoffProviderIdentity: HandoffProviderIdentity \| undefined\n): ParsedCheckFieldPrelude \| undefined {\n const execution = parseExecution(data);\n if (execution === undefined) return undefined;\n const handoff = parseHandoff(data, handoffProviderIdentity);\n if (handoff === undefined) return undefined;\n const parseData = parseDataParser(data);\n if (parseData === undefined) return undefined;\n const preparation = parsePreparation(data);\n if (preparation === undefined) return undefined;\n const enabledByFlags = parseEnabledByFlags(data);\n return enabledByFlags === undefined\n ? undefined\n : Object.freeze({\n enabledByFlags,\n execute: execution,\n handoff,\n parseData,\n prepare: preparation\n });\n}\n\nexport function parseCheckFields(\n data: CheckAuthoringData,\n prelude: ParsedCheckFieldPrelude\n): ParsedCheckFields \| undefined {\n if (prelude.execute === null) {\n return containerHasExecutableFields(data, prelude) ? undefined : CONTAINER_CHECK_FIELDS;\n }\n return parseExecutableCheckFields(data, prelude);\n}\n\n/** Container nodes cannot carry values that only an executable callback can consume. /\nfunction containerHasExecutableFields(\n data: CheckAuthoringData,\n prelude: ParsedCheckFieldPrelude\n): boolean {\n return (\n Object.hasOwn(data, \"options\") \|\|\n Object.hasOwn(data, \"enabledByFlags\") \|\|\n prelude.handoff !== null \|\|\n Object.hasOwn(data, \"omitQuietPassedRow\") \|\|\n prelude.parseData !== null \|\|\n prelude.prepare !== null\n );\n}\n\n/* Parses the callback-owned fields that form one executable Check definition. /\nfunction parseExecutableCheckFields(\n data: CheckAuthoringData,\n prelude: ParsedCheckFieldPrelude\n): ParsedCheckFields \| undefined {\n const definition = parseDefinition(data);\n if (definition === undefined) return undefined;\n const options = parseOptions(data);\n if (options === undefined) return undefined;\n const omitQuietPassedRow = parseOmitQuietPassedRow(data);\n if (omitQuietPassedRow === undefined) return undefined;\n return Object.freeze({\n definition,\n enabledByFlags: prelude.enabledByFlags,\n execute: prelude.execute,\n handoff: prelude.handoff,\n options,\n parseData: prelude.parseData,\n prepare: prelude.prepare,\n omitQuietPassedRow\n });\n}\n\nfunction hasOnlyCheckKeys(data: Readonly<Record<string, unknown>>): boolean {\n return Object.keys(data).every((key) => CHECK_KEYS.some((checkKey) => checkKey === key));\n}\n\nfunction parseExecution(\n data: CheckAuthoringData\n): NonNullable<Check[\"execute\"]> \| null \| undefined {\n if (!Object.hasOwn(data, \"execute\")) return null;\n return isTrustedFunction<NonNullable<Check[\"execute\"]>>(data.execute) ? data.execute : undefined;\n}\n\nfunction parseHandoff(\n data: CheckAuthoringData,\n handoffProviderIdentity: HandoffProviderIdentity \| undefined\n): HandoffProviderIdentity \| null \| undefined {\n if (!Object.hasOwn(data, \"handoff\")) return null;\n return data.handoff === true && handoffProviderIdentity !== undefined\n ? handoffProviderIdentity\n : undefined;\n}\n\nfunction parseDataParser(data: CheckAuthoringData): TrustedDataParser \| null \| undefined {\n if (!Object.hasOwn(data, \"parseData\") \|\| data.parseData === undefined) return null;\n return isTrustedFunction<TrustedDataParser>(data.parseData) ? data.parseData : undefined;\n}\n\nfunction parsePreparation(data: CheckAuthoringData): CheckPreparation \| null \| undefined {\n if (!Object.hasOwn(data, \"prepare\")) return null;\n return isTrustedFunction<CheckPreparation>(data.prepare) ? data.prepare : undefined;\n}\n\nfunction isTrustedFunction<FunctionType extends (...parameters: never[]) => unknown>(\n value: unknown\n): value is FunctionType {\n return typeof value === \"function\";\n}\n\nfunction parseDefinition(data: CheckAuthoringData): CheckDescriptor \| undefined {\n const definition = validateCheckDescriptor({\n checkId: data.checkId,\n displayName: data.displayName\n });\n return definition.ok ? definition.value : undefined;\n}\n\nfunction parseOptions(data: CheckAuthoringData): object \| undefined {\n if (!Object.hasOwn(data, \"options\")) return Object.freeze({});\n const options = snapshotClosedRecord(data.options);\n if (options === undefined) return undefined;\n return snapshotJsonObject(options);\n}\n\nfunction parseEnabledByFlags(data: CheckAuthoringData): CheckFlagEnablement \| null \| undefined {\n if (!Object.hasOwn(data, \"enabledByFlags\")) return null;\n return parseFlagEnablementControl(data.enabledByFlags);\n}\n\n/* Parses one closed flag-enablement field without validating its Project flag references. */\nexport function parseFlagEnablementControl(value: unknown): CheckFlagEnablement \| undefined {\n const control = snapshotClosedRecord(value);\n if (\n control === undefined \|\|\n !hasOnlyKeys(control, FLAG_ENABLEMENT_EXPRESSION_KEYS) \|\|\n !Object.hasOwn(control, \"when\")\n ) {\n return undefined;\n }\n const when = parseFlagCondition(control.when);\n const propagateDependsOn = parsePropagation(control);\n return when === undefined \|\| propagateDependsOn === undefined\n ? undefined\n : Object.freeze({\n when,\n ...(propagateDependsOn ? { propagateDependsOn: true as const } : {})\n });\n}\n\nfunction parsePropagation(control: Readonly<Record<string, unknown>>): boolean \| undefined {\n if (!Object.hasOwn(control, \"propagateDependsOn\")) return false;\n return control.propagateDependsOn === true ? true : undefined;\n}\n\nfunction parseOmitQuietPassedRow(data: CheckAuthoringData): boolean \| undefined {\n if (!Object.hasOwn(data, \"omitQuietPassedRow\")) return false;\n return data.omitQuietPassedRow === undefined \|\| data.omitQuietPassedRow === true\n ? (data.omitQuietPassedRow ?? false)\n : undefined;\n}\n"]}

package/dist/esm/project-definition/check-tree/flag-conditions.mjs ADDED Viewed

@@ -0,0 +1,71 @@
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+const FLAG_CONDITION_MAX_DEPTH = 16;
+const FLAG_CONDITION_MAX_NODES = 256;
+/** Parses and snapshots one bounded recursive flag condition while retaining child order and multiplicity. */
+export function parseFlagCondition(value) {
+    return parseBoundedFlagCondition(value, 1, { nodes: 0 });
+}
+/** Checks that a closed record has no author-supplied keys outside this grammar fragment. */
+export function hasOnlyKeys(value, keys) {
+    return Object.keys(value).every((key) => keys.includes(key));
+}
+function parseBoundedFlagCondition(value, depth, state) {
+    if (exceedsFlagConditionBounds(depth, state))
+        return undefined;
+    if (isNonEmptyIdentifier(value))
+        return value;
+    const condition = snapshotClosedRecord(value);
+    const kind = condition?.kind;
+    if (condition === undefined || typeof kind !== "string")
+        return undefined;
+    return kind === "not"
+        ? parseFlagNegationCondition(condition, depth, state)
+        : parseFlagConditionSet(condition, kind, depth, state);
+}
+function exceedsFlagConditionBounds(depth, state) {
+    state.nodes += 1;
+    return depth > FLAG_CONDITION_MAX_DEPTH || state.nodes > FLAG_CONDITION_MAX_NODES;
+}
+function parseFlagNegationCondition(condition, depth, state) {
+    if (!hasOnlyKeys(condition, ["condition", "kind"]) || !Object.hasOwn(condition, "condition")) {
+        return undefined;
+    }
+    const child = parseBoundedFlagCondition(condition.condition, depth + 1, state);
+    return child === undefined ? undefined : Object.freeze({ condition: child, kind: "not" });
+}
+function parseFlagConditionSet(condition, kind, depth, state) {
+    if (!isFlagConditionSetKind(kind))
+        return undefined;
+    const conditions = parseFlagConditionChildren(condition, depth, state);
+    return conditions === undefined ? undefined : Object.freeze({ kind, conditions });
+}
+function parseFlagConditionChildren(condition, depth, state) {
+    if (!hasOnlyKeys(condition, ["conditions", "kind"]) || !Object.hasOwn(condition, "conditions")) {
+        return undefined;
+    }
+    const children = snapshotClosedArray(condition.conditions);
+    if (children === undefined || children.length === 0)
+        return undefined;
+    const normalized = [];
+    for (const child of children) {
+        const parsed = parseBoundedFlagCondition(child, depth + 1, state);
+        if (parsed === undefined)
+            return undefined;
+        normalized.push(parsed);
+    }
+    const [firstCondition, ...remainingConditions] = normalized;
+    return firstCondition === undefined
+        ? undefined
+        : Object.freeze([firstCondition, ...remainingConditions]);
+}
+function isNonEmptyIdentifier(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isFlagConditionSetKind(value) {
+    return (value === "all" ||
+        value === "any" ||
+        value === "none" ||
+        value === "not-all" ||
+        value === "exactly-one");
+}
+//# sourceMappingURL=flag-conditions.mjs.map

package/dist/esm/project-definition/check-tree/flag-conditions.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flag-conditions.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/flag-conditions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckFlagCondition } from \"../../check/check.ts\";\nimport { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\n\nconst FLAG_CONDITION_MAX_DEPTH = 16;\nconst FLAG_CONDITION_MAX_NODES = 256;\n\n/** Parses and snapshots one bounded recursive flag condition while retaining child order and multiplicity. */\nexport function parseFlagCondition(value: unknown): CheckFlagCondition | undefined {\n return parseBoundedFlagCondition(value, 1, { nodes: 0 });\n}\n\n/** Checks that a closed record has no author-supplied keys outside this grammar fragment. */\nexport function hasOnlyKeys(\n value: Readonly<Record<string, unknown>>,\n keys: readonly string[]\n): boolean {\n return Object.keys(value).every((key) => keys.includes(key));\n}\n\nfunction parseBoundedFlagCondition(\n value: unknown,\n depth: number,\n state: { nodes: number }\n): CheckFlagCondition | undefined {\n if (exceedsFlagConditionBounds(depth, state)) return undefined;\n if (isNonEmptyIdentifier(value)) return value;\n const condition = snapshotClosedRecord(value);\n const kind = condition?.kind;\n if (condition === undefined || typeof kind !== \"string\") return undefined;\n return kind === \"not\"\n ? parseFlagNegationCondition(condition, depth, state)\n : parseFlagConditionSet(condition, kind, depth, state);\n}\n\nfunction exceedsFlagConditionBounds(depth: number, state: { nodes: number }): boolean {\n state.nodes += 1;\n return depth > FLAG_CONDITION_MAX_DEPTH || state.nodes > FLAG_CONDITION_MAX_NODES;\n}\n\nfunction parseFlagNegationCondition(\n condition: Readonly<Record<string, unknown>>,\n depth: number,\n state: { nodes: number }\n): CheckFlagCondition | undefined {\n if (!hasOnlyKeys(condition, [\"condition\", \"kind\"]) || !Object.hasOwn(condition, \"condition\")) {\n return undefined;\n }\n const child = parseBoundedFlagCondition(condition.condition, depth + 1, state);\n return child === undefined ? undefined : Object.freeze({ condition: child, kind: \"not\" });\n}\n\nfunction parseFlagConditionSet(\n condition: Readonly<Record<string, unknown>>,\n kind: string,\n depth: number,\n state: { nodes: number }\n): CheckFlagCondition | undefined {\n if (!isFlagConditionSetKind(kind)) return undefined;\n const conditions = parseFlagConditionChildren(condition, depth, state);\n return conditions === undefined ? undefined : Object.freeze({ kind, conditions });\n}\n\nfunction parseFlagConditionChildren(\n condition: Readonly<Record<string, unknown>>,\n depth: number,\n state: { nodes: number }\n): readonly [CheckFlagCondition, ...CheckFlagCondition[]] | undefined {\n if (!hasOnlyKeys(condition, [\"conditions\", \"kind\"]) || !Object.hasOwn(condition, \"conditions\")) {\n return undefined;\n }\n const children = snapshotClosedArray(condition.conditions);\n if (children === undefined || children.length === 0) return undefined;\n const normalized: CheckFlagCondition[] = [];\n for (const child of children) {\n const parsed = parseBoundedFlagCondition(child, depth + 1, state);\n if (parsed === undefined) return undefined;\n normalized.push(parsed);\n }\n const [firstCondition, ...remainingConditions] = normalized;\n return firstCondition === undefined\n ? undefined\n : Object.freeze([firstCondition, ...remainingConditions]);\n}\n\nfunction isNonEmptyIdentifier(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n}\n\nfunction isFlagConditionSetKind(\n value: string\n): value is \"all\" | \"any\" | \"none\" | \"not-all\" | \"exactly-one\" {\n return (\n value === \"all\" ||\n value === \"any\" ||\n value === \"none\" ||\n value === \"not-all\" ||\n value === \"exactly-one\"\n );\n}\n"]}

package/dist/esm/project-definition/check-tree/materialization.mjs CHANGED Viewed

@@ -1,4 +1,5 @@
 import { inherit } from "../../check/check.mjs";
+import { bindHandoffProviderIdentity } from "../../check/handoff-provider-identity.mjs";
 /** Rebuilds the validated public authoring shape without retaining untyped input. */
 export function materializeCheckTreeAuthoring(parsed) {
     return materializeChecks(parsed.checks);
@@ -12,8 +13,8 @@ function materializeCheck(check) {
     const enabledByFlags = check.enabledByFlags;
     const mutex = materializeCollection(check.mutex);
     const observes = materializeCollection(check.observes);
-    const visibility = check.visibility;
-    const preflight = check.preflight;
+    const omitQuietPassedRow = check.omitQuietPassedRow;
+    const preparation = check.prepare;
     const scheduling = {
         ...(check.admissionPriority === undefined
             ? {}
@@ -25,9 +26,9 @@ function materializeCheck(check) {
         ...(check.resourceClaims === undefined ? {} : { resourceClaims: check.resourceClaims })
     };
     if (check.definition === null ||
-        check.execution === null ||
+        check.execute === null ||
         check.options === null ||
-        visibility === null) {
+        omitQuietPassedRow === null) {
         return Object.freeze({
             checkId: check.checkId,
             checks,
@@ -35,18 +36,22 @@ function materializeCheck(check) {
             ...scheduling
         });
     }
-    return Object.freeze({
+    const materialized = Object.freeze({
         checkId: check.checkId,
         checks,
         displayName: check.displayName,
         ...(enabledByFlags === null ? {} : { enabledByFlags }),
-        execution: check.execution,
+        execute: check.execute,
+        ...(check.handoff === null ? {} : { handoff: true }),
         ...(check.parseData === null ? {} : { parseData: check.parseData }),
         options: check.options,
-        ...(preflight === null ? {} : { preflight }),
+        ...(preparation === null ? {} : { prepare: preparation }),
         ...scheduling,
-        visibility
+        ...(omitQuietPassedRow ? { omitQuietPassedRow: true } : {})
     });
+    if (check.handoff !== null)
+        bindHandoffProviderIdentity(materialized, check.handoff);
+    return materialized;
 }
 function materializeCollection(collection) {
     if (collection === undefined)

package/dist/esm/project-definition/check-tree/materialization.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"materialization.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/materialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+C,MAAM,sBAAsB,CAAC;~~AAG5F~~,qFAAqF;AACrF,MAAM,UAAU,6BAA6B,CAAC,MAAuB;IACnE,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA8B;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,~~UAAU~~,GAAG,KAAK,CAAC,~~UAAU~~,CAAC;~~IACpC~~,MAAM,~~SAAS~~,GAAG,KAAK,CAAC,~~SAAS~~,CAAC;IAClC,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC;KACxF,CAAC;IACF,IACE,KAAK,CAAC,UAAU,KAAK,IAAI;QACzB,KAAK,CAAC,~~SAAS~~,KAAK,IAAI;~~QACxB~~,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,~~UAAU~~,KAAK,IAAI,~~EACnB~~,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM;YACN,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,UAAU;SACd,CAAC,CAAC;IACL,CAAC;IACD,~~OAAO~~,MAAM,CAAC,MAAM,CAAC;~~QACnB~~,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM;QACN,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QACtD,~~SAAS~~,EAAE,KAAK,CAAC,~~SAAS~~;~~QAC1B~~,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACnE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,~~SAAS~~,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,~~SAAS~~,EAAE,CAAC;~~QAC5C~~,GAAG,UAAU;QACb,~~UAAU~~;~~KACX~~,CAAC,CAAC;~~AACL~~,CAAC;AAED,SAAS,qBAAqB,CAC5B,UAA6C;IAE7C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC;IAC1D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import { inherit, type Check, type InheritableCheckCollection } from \"../../check/check.ts\";\nimport type { ParsedCheck, ParsedCheckCollection, ParsedCheckTree } from \"./authoring.ts\";\n\n/** Rebuilds the validated public authoring shape without retaining untyped input. */\nexport function materializeCheckTreeAuthoring(parsed: ParsedCheckTree): readonly Check[] {\n return materializeChecks(parsed.checks);\n}\n\nfunction materializeChecks(checks: readonly ParsedCheck[]): readonly Check[] {\n return Object.freeze(checks.map((check) => materializeCheck(check)));\n}\n\nfunction materializeCheck(check: ParsedCheck): Check {\n const checks = materializeChecks(check.checks);\n const dependsOn = materializeCollection(check.dependsOn);\n const enabledByFlags = check.enabledByFlags;\n const mutex = materializeCollection(check.mutex);\n const observes = materializeCollection(check.observes);\n const ~~visibility~~ = check.~~visibility~~;\n const ~~preflight~~ = check.~~preflight~~;\n const scheduling = {\n ...(check.admissionPriority === undefined\n ? {}\n : { admissionPriority: check.admissionPriority }),\n ...(dependsOn === undefined ? {} : { dependsOn }),\n ...(check.maxParallel === undefined ? {} : { maxParallel: check.maxParallel }),\n ...(mutex === undefined ? {} : { mutex }),\n ...(observes === undefined ? {} : { observes }),\n ...(check.resourceClaims === undefined ? {} : { resourceClaims: check.resourceClaims })\n };\n if (\n check.definition === null \|\|\n check.~~execution~~ === null \|\|\n check.options === null \|\|\n ~~visibility~~ === null\n ) {\n return Object.freeze({\n checkId: check.checkId,\n checks,\n displayName: check.displayName,\n ...scheduling\n });\n }\n ~~return~~ Object.freeze({\n checkId: check.checkId,\n checks,\n displayName: check.displayName,\n ...(enabledByFlags === null ? {} : { enabledByFlags }),\n ~~execution~~: check.~~execution~~,\n ...(check.parseData === null ? {} : { parseData: check.parseData }),\n options: check.options,\n ...(~~preflight~~ === null ? {} : { ~~preflight~~ }),\n ...scheduling,\n ~~visibility~~\n });\n}\n\nfunction materializeCollection(\n collection: ParsedCheckCollection \| undefined\n): InheritableCheckCollection<string> \| undefined {\n if (collection === undefined) return undefined;\n if (collection.kind === \"exact\") return collection.values;\n return inherit({ add: collection.add, remove: collection.remove });\n}\n"]}
1	+ {"version":3,"file":"materialization.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/materialization.ts"],"names":[],"mappings":"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","sourcesContent":["import { inherit, type Check, type InheritableCheckCollection } from \"../../check/check.ts\";\nimport { bindHandoffProviderIdentity } from \"../../check/handoff-provider-identity.ts\";\nimport type { ParsedCheck, ParsedCheckCollection, ParsedCheckTree } from \"./authoring.ts\";\n\n/** Rebuilds the validated public authoring shape without retaining untyped input. */\nexport function materializeCheckTreeAuthoring(parsed: ParsedCheckTree): readonly Check[] {\n return materializeChecks(parsed.checks);\n}\n\nfunction materializeChecks(checks: readonly ParsedCheck[]): readonly Check[] {\n return Object.freeze(checks.map((check) => materializeCheck(check)));\n}\n\nfunction materializeCheck(check: ParsedCheck): Check {\n const checks = materializeChecks(check.checks);\n const dependsOn = materializeCollection(check.dependsOn);\n const enabledByFlags = check.enabledByFlags;\n const mutex = materializeCollection(check.mutex);\n const observes = materializeCollection(check.observes);\n const omitQuietPassedRow = check.omitQuietPassedRow;\n const preparation = check.prepare;\n const scheduling = {\n ...(check.admissionPriority === undefined\n ? {}\n : { admissionPriority: check.admissionPriority }),\n ...(dependsOn === undefined ? {} : { dependsOn }),\n ...(check.maxParallel === undefined ? {} : { maxParallel: check.maxParallel }),\n ...(mutex === undefined ? {} : { mutex }),\n ...(observes === undefined ? {} : { observes }),\n ...(check.resourceClaims === undefined ? {} : { resourceClaims: check.resourceClaims })\n };\n if (\n check.definition === null \|\|\n check.execute === null \|\|\n check.options === null \|\|\n omitQuietPassedRow === null\n ) {\n return Object.freeze({\n checkId: check.checkId,\n checks,\n displayName: check.displayName,\n ...scheduling\n });\n }\n const materialized = Object.freeze({\n checkId: check.checkId,\n checks,\n displayName: check.displayName,\n ...(enabledByFlags === null ? {} : { enabledByFlags }),\n execute: check.execute,\n ...(check.handoff === null ? {} : { handoff: true }),\n ...(check.parseData === null ? {} : { parseData: check.parseData }),\n options: check.options,\n ...(preparation === null ? {} : { prepare: preparation }),\n ...scheduling,\n ...(omitQuietPassedRow ? { omitQuietPassedRow: true as const } : {})\n });\n if (check.handoff !== null) bindHandoffProviderIdentity(materialized, check.handoff);\n return materialized;\n}\n\nfunction materializeCollection(\n collection: ParsedCheckCollection \| undefined\n): InheritableCheckCollection<string> \| undefined {\n if (collection === undefined) return undefined;\n if (collection.kind === \"exact\") return collection.values;\n return inherit({ add: collection.add, remove: collection.remove });\n}\n"]}

package/dist/esm/project-definition/check-tree/resolution.mjs CHANGED Viewed

@@ -53,24 +53,25 @@ function resolveScheduling(check, inherited) {
     });
 }
 function resolvedLeafFor(check, scheduling) {
-    const visibility = check.visibility;
-    if (check.execution !== null &&
+    const omitQuietPassedRow = check.omitQuietPassedRow;
+    if (check.execute !== null &&
         check.definition !== null &&
         check.options !== null &&
-        visibility !== null) {
+        omitQuietPassedRow !== null) {
         return Object.freeze({
             admissionPriority: scheduling.admissionPriority,
             definition: check.definition,
             dependsOn: scheduling.dependsOn,
             ...(check.enabledByFlags === null ? {} : { enabledByFlags: check.enabledByFlags }),
-            execution: check.execution,
+            execute: check.execute,
+            ...(check.handoff === null ? {} : { handoff: check.handoff }),
             maxParallel: scheduling.maxParallel,
             mutex: scheduling.mutex,
             observes: scheduling.observes,
             options: check.options,
-            ...(check.preflight === null ? {} : { preflight: check.preflight }),
+            ...(check.prepare === null ? {} : { prepare: check.prepare }),
             resourceClaims: scheduling.resourceClaims,
-            visibility
+            omitQuietPassedRow
         });
     }
     return undefined;

package/dist/esm/project-definition/check-tree/resolution.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolution.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/resolution.ts"],"names":[],"mappings":"~~AAOA~~,OAAO,EACL,uBAAuB,EAKxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAA4B,MAAM,6BAA6B,CAAC;~~AAiCpG~~;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,eAAuB,EACvB,kBAAkB,GAAwB,2BAA2B;IAErE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAuB,EACvB,eAAuB,EACvB,kBAAkB,GAAwB,2BAA2B;IAErE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,eAAe,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAwB,MAAM,CAAC,MAAM,CAAC;QAC9C,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,WAAW,EAAE,eAAe;QAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,cAAc,EAAE,2BAA2B;KAC5C,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,YAAY,CACnB,KAAkB,EAClB,SAA8B,EAC9B,kBAAuC,EACvC,MAA+B;IAE/B,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,cAAc,EAAE,kBAAkB,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAkB,EAClB,SAA8B;IAE9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,SAAS,CAAC,iBAAiB;QACzE,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;QAClE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW;QACvD,KAAK,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;QACtD,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;QAC/D,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,SAAS,CAAC,cAAc;KACjE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAAkB,EAClB,UAA+B;IAE/B,MAAM,~~UAAU~~,GAAG,KAAK,CAAC,~~UAAU~~,CAAC;~~IACpC~~,IACE,KAAK,CAAC,~~SAAS~~,KAAK,IAAI;~~QACxB~~,KAAK,CAAC,UAAU,KAAK,IAAI;QACzB,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,~~UAAU~~,KAAK,IAAI,~~EACnB~~,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YAClF,~~SAAS~~,EAAE,KAAK,CAAC,~~SAAS~~;~~YAC1B~~,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,~~SAAS~~,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,~~SAAS~~,EAAE,KAAK,CAAC,~~SAAS~~,EAAE,CAAC;~~YACnE~~,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,~~UAAU~~;~~SACX~~,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAA2B,EAC3B,UAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CACjC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CACtB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,SAA4B,EAC5B,QAA2C;IAE3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,YAAY,CAAC,MAAyB;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport type {~~\n CheckExecution,\n~~ CheckFlagEnablement~~,\n CheckPreflight,\n CheckVisibility\n~~} from \"../../check/check.ts\";\nimport {\n parseCheckTreeAuthoring,\n type MeaninglessCheckWarning,\n type ParsedCheck,\n type ParsedCheckCollection,\n type ParsedCheckTree\n} from \"./authoring.ts\";\nimport { EMPTY_RESOURCE_UNIT_MAPPING, type ResourceUnitMapping } from \"../resource-unit-mapping.ts\";\n\nexport type { Check, InheritableCheckCollection } from \"../../check/check.ts\";\n\nexport interface ResolvedCheckTreeLeaf {\n readonly admissionPriority: number;\n readonly definition: CheckDescriptor;\n readonly dependsOn: readonly string[];\n readonly enabledByFlags?: CheckFlagEnablement;\n readonly ~~execution~~: ~~CheckExecution~~;\n readonly maxParallel: number;\n readonly mutex: readonly string[];\n readonly observes: readonly string[];\n readonly options: object;\n readonly ~~preflight~~?: ~~CheckPreflight~~;\n readonly resourceClaims: ResourceUnitMapping;\n readonly ~~visibility~~: ~~CheckVisibility~~;\n}\n\nexport interface ResolvedCheckTree {\n readonly leaves: readonly ResolvedCheckTreeLeaf[];\n readonly warnings: readonly MeaninglessCheckWarning[];\n}\n\ninterface InheritedScheduling {\n readonly admissionPriority: number;\n readonly dependsOn: readonly string[];\n readonly maxParallel: number;\n readonly mutex: readonly string[];\n readonly observes: readonly string[];\n readonly resourceClaims: ResourceUnitMapping;\n}\n\n/*\n Traverses the recursive authoring tree. Containment only passes scheduling\n * values to descendants; it never creates an execution dependency or output\n * hierarchy.\n */\nexport function resolveCheckTree(\n value: unknown,\n rootMaxParallel: number,\n resourceCapacities: ResourceUnitMapping = EMPTY_RESOURCE_UNIT_MAPPING\n): ResolvedCheckTree \| undefined {\n const parsed = parseCheckTreeAuthoring(value);\n return parsed === undefined\n ? undefined\n : resolveParsedCheckTree(parsed, rootMaxParallel, resourceCapacities);\n}\n\nexport function resolveParsedCheckTree(\n parsed: ParsedCheckTree,\n rootMaxParallel: number,\n resourceCapacities: ResourceUnitMapping = EMPTY_RESOURCE_UNIT_MAPPING\n): ResolvedCheckTree \| undefined {\n if (!Number.isSafeInteger(rootMaxParallel) \|\| rootMaxParallel <= 0) return undefined;\n const leaves: ResolvedCheckTreeLeaf[] = [];\n const root: InheritedScheduling = Object.freeze({\n admissionPriority: 0,\n dependsOn: Object.freeze([]),\n maxParallel: rootMaxParallel,\n mutex: Object.freeze([]),\n observes: Object.freeze([]),\n resourceClaims: EMPTY_RESOURCE_UNIT_MAPPING\n });\n for (const check of parsed.checks) {\n if (!flattenCheck(check, root, resourceCapacities, leaves)) return undefined;\n }\n return Object.freeze({ leaves: Object.freeze(leaves), warnings: parsed.warnings });\n}\n\nfunction flattenCheck(\n check: ParsedCheck,\n inherited: InheritedScheduling,\n resourceCapacities: ResourceUnitMapping,\n leaves: ResolvedCheckTreeLeaf[]\n): boolean {\n const scheduling = resolveScheduling(check, inherited);\n if (!claimsFitCapacities(scheduling.resourceClaims, resourceCapacities)) return false;\n const leaf = resolvedLeafFor(check, scheduling);\n if (leaf !== undefined) leaves.push(leaf);\n for (const child of check.checks) {\n if (!flattenCheck(child, scheduling, resourceCapacities, leaves)) return false;\n }\n return true;\n}\n\nfunction resolveScheduling(\n check: ParsedCheck,\n inherited: InheritedScheduling\n): InheritedScheduling {\n return Object.freeze({\n admissionPriority: check.admissionPriority ?? inherited.admissionPriority,\n dependsOn: resolveCollection(inherited.dependsOn, check.dependsOn),\n maxParallel: check.maxParallel ?? inherited.maxParallel,\n mutex: resolveCollection(inherited.mutex, check.mutex),\n observes: resolveCollection(inherited.observes, check.observes),\n resourceClaims: check.resourceClaims ?? inherited.resourceClaims\n });\n}\n\nfunction resolvedLeafFor(\n check: ParsedCheck,\n scheduling: InheritedScheduling\n): ResolvedCheckTreeLeaf \| undefined {\n const ~~visibility~~ = check.~~visibility~~;\n if (\n check.~~execution~~ !== null &&\n check.definition !== null &&\n check.options !== null &&\n ~~visibility~~ !== null\n ) {\n return Object.freeze({\n admissionPriority: scheduling.admissionPriority,\n definition: check.definition,\n dependsOn: scheduling.dependsOn,\n ...(check.enabledByFlags === null ? {} : { enabledByFlags: check.enabledByFlags }),\n ~~execution~~: check.~~execution~~,\n maxParallel: scheduling.maxParallel,\n mutex: scheduling.mutex,\n observes: scheduling.observes,\n options: check.options,\n ...(check.~~preflight~~ === null ? {} : { ~~preflight~~: check.~~preflight~~ }),\n resourceClaims: scheduling.resourceClaims,\n ~~visibility~~\n });\n }\n return undefined;\n}\n\nfunction claimsFitCapacities(\n claims: ResourceUnitMapping,\n capacities: ResourceUnitMapping\n): boolean {\n return Object.entries(claims).every(\n ([resourceId, units]) =>\n Object.hasOwn(capacities, resourceId) && units <= (capacities[resourceId] ?? 0)\n );\n}\n\nfunction resolveCollection(\n inherited: readonly string[],\n authored: ParsedCheckCollection \| undefined\n): readonly string[] {\n if (authored === undefined) return inherited;\n if (authored.kind === \"exact\") return canonicalize(authored.values);\n const removed = new Set(authored.remove);\n return canonicalize([...inherited.filter((value) => !removed.has(value)), ...authored.add]);\n}\n\nfunction canonicalize(values: readonly string[]): readonly string[] {\n return Object.freeze([...new Set(values)].sort());\n}\n"]}
1	+ {"version":3,"file":"resolution.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/resolution.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EAKxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAA4B,MAAM,6BAA6B,CAAC;AAkCpG;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,eAAuB,EACvB,kBAAkB,GAAwB,2BAA2B;IAErE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAuB,EACvB,eAAuB,EACvB,kBAAkB,GAAwB,2BAA2B;IAErE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,eAAe,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAwB,MAAM,CAAC,MAAM,CAAC;QAC9C,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,WAAW,EAAE,eAAe;QAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,cAAc,EAAE,2BAA2B;KAC5C,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,YAAY,CACnB,KAAkB,EAClB,SAA8B,EAC9B,kBAAuC,EACvC,MAA+B;IAE/B,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,cAAc,EAAE,kBAAkB,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAkB,EAClB,SAA8B;IAE9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,SAAS,CAAC,iBAAiB;QACzE,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;QAClE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW;QACvD,KAAK,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;QACtD,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;QAC/D,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,SAAS,CAAC,cAAc;KACjE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAAkB,EAClB,UAA+B;IAE/B,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACpD,IACE,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,KAAK,CAAC,UAAU,KAAK,IAAI;QACzB,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,kBAAkB,KAAK,IAAI,EAC3B,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YAClF,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7D,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7D,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAA2B,EAC3B,UAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CACjC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CACtB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,SAA4B,EAC5B,QAA2C;IAE3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,YAAY,CAAC,MAAyB;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport type { Check, CheckPreparation, CheckFlagEnablement } from \"../../check/check.ts\";\nimport type { HandoffProviderIdentity } from \"../../check/handoff-provider-identity.ts\";\nimport {\n parseCheckTreeAuthoring,\n type MeaninglessCheckWarning,\n type ParsedCheck,\n type ParsedCheckCollection,\n type ParsedCheckTree\n} from \"./authoring.ts\";\nimport { EMPTY_RESOURCE_UNIT_MAPPING, type ResourceUnitMapping } from \"../resource-unit-mapping.ts\";\n\nexport type { Check, InheritableCheckCollection } from \"../../check/check.ts\";\n\nexport interface ResolvedCheckTreeLeaf {\n readonly admissionPriority: number;\n readonly definition: CheckDescriptor;\n readonly dependsOn: readonly string[];\n readonly enabledByFlags?: CheckFlagEnablement;\n readonly execute: NonNullable<Check[\"execute\"]>;\n readonly handoff?: HandoffProviderIdentity;\n readonly maxParallel: number;\n readonly mutex: readonly string[];\n readonly observes: readonly string[];\n readonly options: object;\n readonly prepare?: CheckPreparation;\n readonly resourceClaims: ResourceUnitMapping;\n readonly omitQuietPassedRow: boolean;\n}\n\nexport interface ResolvedCheckTree {\n readonly leaves: readonly ResolvedCheckTreeLeaf[];\n readonly warnings: readonly MeaninglessCheckWarning[];\n}\n\ninterface InheritedScheduling {\n readonly admissionPriority: number;\n readonly dependsOn: readonly string[];\n readonly maxParallel: number;\n readonly mutex: readonly string[];\n readonly observes: readonly string[];\n readonly resourceClaims: ResourceUnitMapping;\n}\n\n/*\n Traverses the recursive authoring tree. Containment only passes scheduling\n * values to descendants; it never creates an execution dependency or output\n * hierarchy.\n */\nexport function resolveCheckTree(\n value: unknown,\n rootMaxParallel: number,\n resourceCapacities: ResourceUnitMapping = EMPTY_RESOURCE_UNIT_MAPPING\n): ResolvedCheckTree \| undefined {\n const parsed = parseCheckTreeAuthoring(value);\n return parsed === undefined\n ? undefined\n : resolveParsedCheckTree(parsed, rootMaxParallel, resourceCapacities);\n}\n\nexport function resolveParsedCheckTree(\n parsed: ParsedCheckTree,\n rootMaxParallel: number,\n resourceCapacities: ResourceUnitMapping = EMPTY_RESOURCE_UNIT_MAPPING\n): ResolvedCheckTree \| undefined {\n if (!Number.isSafeInteger(rootMaxParallel) \|\| rootMaxParallel <= 0) return undefined;\n const leaves: ResolvedCheckTreeLeaf[] = [];\n const root: InheritedScheduling = Object.freeze({\n admissionPriority: 0,\n dependsOn: Object.freeze([]),\n maxParallel: rootMaxParallel,\n mutex: Object.freeze([]),\n observes: Object.freeze([]),\n resourceClaims: EMPTY_RESOURCE_UNIT_MAPPING\n });\n for (const check of parsed.checks) {\n if (!flattenCheck(check, root, resourceCapacities, leaves)) return undefined;\n }\n return Object.freeze({ leaves: Object.freeze(leaves), warnings: parsed.warnings });\n}\n\nfunction flattenCheck(\n check: ParsedCheck,\n inherited: InheritedScheduling,\n resourceCapacities: ResourceUnitMapping,\n leaves: ResolvedCheckTreeLeaf[]\n): boolean {\n const scheduling = resolveScheduling(check, inherited);\n if (!claimsFitCapacities(scheduling.resourceClaims, resourceCapacities)) return false;\n const leaf = resolvedLeafFor(check, scheduling);\n if (leaf !== undefined) leaves.push(leaf);\n for (const child of check.checks) {\n if (!flattenCheck(child, scheduling, resourceCapacities, leaves)) return false;\n }\n return true;\n}\n\nfunction resolveScheduling(\n check: ParsedCheck,\n inherited: InheritedScheduling\n): InheritedScheduling {\n return Object.freeze({\n admissionPriority: check.admissionPriority ?? inherited.admissionPriority,\n dependsOn: resolveCollection(inherited.dependsOn, check.dependsOn),\n maxParallel: check.maxParallel ?? inherited.maxParallel,\n mutex: resolveCollection(inherited.mutex, check.mutex),\n observes: resolveCollection(inherited.observes, check.observes),\n resourceClaims: check.resourceClaims ?? inherited.resourceClaims\n });\n}\n\nfunction resolvedLeafFor(\n check: ParsedCheck,\n scheduling: InheritedScheduling\n): ResolvedCheckTreeLeaf \| undefined {\n const omitQuietPassedRow = check.omitQuietPassedRow;\n if (\n check.execute !== null &&\n check.definition !== null &&\n check.options !== null &&\n omitQuietPassedRow !== null\n ) {\n return Object.freeze({\n admissionPriority: scheduling.admissionPriority,\n definition: check.definition,\n dependsOn: scheduling.dependsOn,\n ...(check.enabledByFlags === null ? {} : { enabledByFlags: check.enabledByFlags }),\n execute: check.execute,\n ...(check.handoff === null ? {} : { handoff: check.handoff }),\n maxParallel: scheduling.maxParallel,\n mutex: scheduling.mutex,\n observes: scheduling.observes,\n options: check.options,\n ...(check.prepare === null ? {} : { prepare: check.prepare }),\n resourceClaims: scheduling.resourceClaims,\n omitQuietPassedRow\n });\n }\n return undefined;\n}\n\nfunction claimsFitCapacities(\n claims: ResourceUnitMapping,\n capacities: ResourceUnitMapping\n): boolean {\n return Object.entries(claims).every(\n ([resourceId, units]) =>\n Object.hasOwn(capacities, resourceId) && units <= (capacities[resourceId] ?? 0)\n );\n}\n\nfunction resolveCollection(\n inherited: readonly string[],\n authored: ParsedCheckCollection \| undefined\n): readonly string[] {\n if (authored === undefined) return inherited;\n if (authored.kind === \"exact\") return canonicalize(authored.values);\n const removed = new Set(authored.remove);\n return canonicalize([...inherited.filter((value) => !removed.has(value)), ...authored.add]);\n}\n\nfunction canonicalize(values: readonly string[]): readonly string[] {\n return Object.freeze([...new Set(values)].sort());\n}\n"]}

package/dist/esm/project-definition/declarative-snapshot.mjs CHANGED Viewed

@@ -6,11 +6,12 @@ import { isNonArrayRecord } from "../data-boundary/value-shapes.mjs";
  */
 export function createDeclarativeProjectSnapshot(definition, checks) {
     const declarations = checks
-        .map(({ execution: _execution, preflight: _preflight, ...declaration }) => declaration)
+        .map(({ execute: _execution, handoff: _handoff, prepare: _preparation, ...declaration }) => declaration)
         .sort((left, right) => compareText(left.definition.checkId, right.definition.checkId));
     return deepFreeze({
         apiVersion: definition.apiVersion,
         checks: declarations,
+        ...(definition.changes === undefined ? {} : { changes: definition.changes }),
         outputs: declarativeOutputs(definition),
         scheduler: Object.freeze({
             admissionPolicy: declarativeAdmissionPolicy(definition.scheduler.admissionPolicy),

package/dist/esm/project-definition/declarative-snapshot.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"declarative-snapshot.mjs","sourceRoot":"","sources":["../../../src/project-definition/declarative-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;~~AAEpE~~;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,~~UAA6B~~,~~EAC7B~~,MAAkC;IAElC,MAAM,YAAY,GAAG,MAAM;SACxB,GAAG,~~CAAC~~,CAAC,EAAE,~~SAAS~~,EAAE,UAAU,EAAE,~~SAAS~~,EAAE,~~UAAU~~,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,~~CAAC~~,WAAW,~~CAAC~~;~~SACtF~~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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { AdmissionPolicy, DeclarativeSchedulerPolicy } from \"./scheduler-policy.ts\";\nimport type {\n DeclarativeProjectOutputs,\n DeclarativeProjectSnapshot,\n NormalizedCheck,\n ProjectDefinition\n} from \"./project-definition.ts\";\nimport { resolveProgressRenderingOutput } from \"./output-defaults.ts\";\nimport { isNonArrayRecord } from \"../data-boundary/value-shapes.ts\";\n\n/*\n Produces the immutable, callback-free Definition identity consumed by fingerprinting.\n /\nexport function createDeclarativeProjectSnapshot(\n definition: ProjectDefinition,\n checks: readonly NormalizedCheck[]\n): DeclarativeProjectSnapshot {\n const declarations = checks\n .map(({ ~~execution~~: _execution, ~~preflight~~: ~~_preflight~~, ...declaration }) => declaration)\n .sort((left, right) => compareText(left.definition.checkId, right.definition.checkId));\n return deepFreeze({\n apiVersion: definition.apiVersion,\n checks: declarations,\n outputs: declarativeOutputs(definition),\n scheduler: Object.freeze({\n admissionPolicy: declarativeAdmissionPolicy(definition.scheduler.admissionPolicy),\n maxParallel: definition.scheduler.maxParallel,\n resourceCapacities: definition.scheduler.resourceCapacities\n })\n });\n}\n\nfunction declarativeOutputs(definition: ProjectDefinition): DeclarativeProjectOutputs {\n const progressRendering = resolveProgressRenderingOutput(definition.outputs.progressRendering);\n return Object.freeze({\n diagnosticLogging: definition.outputs.diagnosticLogging,\n machinePublication: definition.outputs.machinePublication,\n progressRendering: Object.freeze({\n enabled: progressRendering.enabled,\n formatter: progressRendering.formatter === null ? \"default\" : \"custom\",\n messagePreviewLimit: progressRendering.messagePreviewLimit,\n recordPreviewLimit: progressRendering.recordPreviewLimit,\n textPreviewCodePointLimit: progressRendering.textPreviewCodePointLimit\n })\n });\n}\n\n/* Generates the stable SHA-256 fingerprint for one declarative Definition snapshot. */\nexport function createDeclarativeFingerprint(snapshot: DeclarativeProjectSnapshot): string {\n return createHash(\"sha256\").update(stableJson(snapshot)).digest(\"hex\");\n}\n\nfunction declarativeAdmissionPolicy(\n policy: AdmissionPolicy\n): DeclarativeSchedulerPolicy[\"admissionPolicy\"] {\n if (policy.kind === \"custom\") {\n return Object.freeze({\n kind: \"custom\" as const,\n strategy: Object.freeze({ kind: policy.strategy.kind })\n });\n }\n return Object.freeze({ kind: \"static\" as const });\n}\n\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n if (left > right) return 1;\n return 0;\n}\n\nfunction deepFreeze<T>(value: T): T {\n if (typeof value !== \"object\" \|\| value === null \|\| Object.isFrozen(value)) return value;\n for (const item of Object.values(value)) deepFreeze(item);\n return Object.freeze(value);\n}\n\nfunction stableJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(stableJson).join(\",\")}]`;\n if (isNonArrayRecord(value))\n return `{${Object.keys(value)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)\n .join(\",\")}}`;\n return JSON.stringify(value);\n}\n"]}
1	+ {"version":3,"file":"declarative-snapshot.mjs","sourceRoot":"","sources":["../../../src/project-definition/declarative-snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { AdmissionPolicy, DeclarativeSchedulerPolicy } from \"./scheduler-policy.ts\";\nimport type {\n DeclarativeProjectOutputs,\n DeclarativeProjectSnapshot,\n NormalizedCheck,\n ProjectDefinition\n} from \"./project-definition.ts\";\nimport { resolveProgressRenderingOutput } from \"./output-defaults.ts\";\nimport { isNonArrayRecord } from \"../data-boundary/value-shapes.ts\";\nimport type { NormalizedProjectChangesConfiguration } from \"./project-changes.ts\";\n\n/*\n Produces the immutable, callback-free Definition identity consumed by fingerprinting.\n /\nexport function createDeclarativeProjectSnapshot(\n definition: Omit<ProjectDefinition, \"changes\"> & {\n readonly changes?: NormalizedProjectChangesConfiguration;\n },\n checks: readonly NormalizedCheck[]\n): DeclarativeProjectSnapshot {\n const declarations = checks\n .map(\n ({ execute: _execution, handoff: _handoff, prepare: _preparation, ...declaration }) =>\n declaration\n )\n .sort((left, right) => compareText(left.definition.checkId, right.definition.checkId));\n return deepFreeze({\n apiVersion: definition.apiVersion,\n checks: declarations,\n ...(definition.changes === undefined ? {} : { changes: definition.changes }),\n outputs: declarativeOutputs(definition),\n scheduler: Object.freeze({\n admissionPolicy: declarativeAdmissionPolicy(definition.scheduler.admissionPolicy),\n maxParallel: definition.scheduler.maxParallel,\n resourceCapacities: definition.scheduler.resourceCapacities\n })\n });\n}\n\nfunction declarativeOutputs(definition: ProjectDefinition): DeclarativeProjectOutputs {\n const progressRendering = resolveProgressRenderingOutput(definition.outputs.progressRendering);\n return Object.freeze({\n diagnosticLogging: definition.outputs.diagnosticLogging,\n machinePublication: definition.outputs.machinePublication,\n progressRendering: Object.freeze({\n enabled: progressRendering.enabled,\n formatter: progressRendering.formatter === null ? \"default\" : \"custom\",\n messagePreviewLimit: progressRendering.messagePreviewLimit,\n recordPreviewLimit: progressRendering.recordPreviewLimit,\n textPreviewCodePointLimit: progressRendering.textPreviewCodePointLimit\n })\n });\n}\n\n/* Generates the stable SHA-256 fingerprint for one declarative Definition snapshot. */\nexport function createDeclarativeFingerprint(snapshot: DeclarativeProjectSnapshot): string {\n return createHash(\"sha256\").update(stableJson(snapshot)).digest(\"hex\");\n}\n\nfunction declarativeAdmissionPolicy(\n policy: AdmissionPolicy\n): DeclarativeSchedulerPolicy[\"admissionPolicy\"] {\n if (policy.kind === \"custom\") {\n return Object.freeze({\n kind: \"custom\" as const,\n strategy: Object.freeze({ kind: policy.strategy.kind })\n });\n }\n return Object.freeze({ kind: \"static\" as const });\n}\n\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n if (left > right) return 1;\n return 0;\n}\n\nfunction deepFreeze<T>(value: T): T {\n if (typeof value !== \"object\" \|\| value === null \|\| Object.isFrozen(value)) return value;\n for (const item of Object.values(value)) deepFreeze(item);\n return Object.freeze(value);\n}\n\nfunction stableJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(stableJson).join(\",\")}]`;\n if (isNonArrayRecord(value))\n return `{${Object.keys(value)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)\n .join(\",\")}}`;\n return JSON.stringify(value);\n}\n"]}

package/dist/esm/project-definition/project-changes.mjs ADDED Viewed

@@ -0,0 +1,70 @@
+import { hasExactPlainRecordKeys, snapshotClosedArray, snapshotClosedPolicyRecord, snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
+/**
+ * 解析并冻结 change preparation 的 closed Definition grammar。
+ * Runtime Git acquisition 与 region matching 有各自的 Run owner，不在此边界执行。
+ */
+export function parseProjectChangesConfiguration(value) {
+    const data = snapshotClosedRecord(value);
+    if (data === undefined || !hasExactPlainRecordKeys(data, ["flags", "source"]))
+        return undefined;
+    const source = parseSource(data.source);
+    const flags = parseFlags(data.flags);
+    return source === undefined || flags === undefined ? undefined : Object.freeze({ flags, source });
+}
+function parseSource(value) {
+    const source = snapshotClosedRecord(value);
+    if (source === undefined ||
+        !hasExactPlainRecordKeys(source, ["compareWith"]) ||
+        !isGitComparisonRevision(source.compareWith)) {
+        return undefined;
+    }
+    return Object.freeze({ compareWith: source.compareWith });
+}
+function parseFlags(value) {
+    const flags = snapshotClosedRecord(value);
+    if (flags === undefined || Object.keys(flags).length === 0)
+        return undefined;
+    const parsed = {};
+    for (const [flagId, region] of Object.entries(flags)) {
+        if (!isNonEmptyString(flagId))
+            return undefined;
+        const normalizedRegion = parseRegion(region);
+        if (normalizedRegion === undefined)
+            return undefined;
+        Object.defineProperty(parsed, flagId, {
+            configurable: false,
+            enumerable: true,
+            value: normalizedRegion,
+            writable: false
+        });
+    }
+    return Object.freeze(parsed);
+}
+function parseRegion(value) {
+    const region = snapshotClosedPolicyRecord(value, {
+        optional: ["exclude"],
+        required: ["include"]
+    });
+    if (region === undefined)
+        return undefined;
+    const exclude = Object.hasOwn(region, "exclude")
+        ? parseStringArray(region.exclude)
+        : Object.freeze([]);
+    const include = parseStringArray(region.include);
+    return exclude === undefined || include === undefined
+        ? undefined
+        : Object.freeze({ exclude, include });
+}
+function parseStringArray(value) {
+    const values = snapshotClosedArray(value);
+    return values === undefined || !values.every(isNonEmptyString)
+        ? undefined
+        : Object.freeze([...values]);
+}
+function isGitComparisonRevision(value) {
+    return isNonEmptyString(value) && !value.startsWith("-") && !value.includes("\0");
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=project-changes.mjs.map

package/dist/esm/project-definition/project-changes.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"project-changes.mjs","sourceRoot":"","sources":["../../../src/project-definition/project-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAgC3C;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAc;IAEd,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAChG,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,CAAC;QACjD,CAAC,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,EAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,UAAU,CACjB,KAAc;IAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAsD,EAAE,CAAC;IACrE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAChD,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,gBAAgB,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACrD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE;YACpC,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,gBAAgB;YACvB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAC/C,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;QAC9C,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QACnD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC5D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import {\n hasExactPlainRecordKeys,\n snapshotClosedArray,\n snapshotClosedPolicyRecord,\n snapshotClosedRecord\n} from \"../data-boundary/closed-values.ts\";\n\n/** Project 自有的 Git comparison，用于为一次 Run 推导 change flags。 */\nexport interface ProjectChangeSource {\n /** 作为 comparison base 的 Git revision。 */\n readonly compareWith: string;\n}\n\n/** 一个 change flag 的 project-root-relative、exclude-first glob region。 */\nexport interface ProjectChangeFlagRegion {\n /** 可省略的排除 glob；省略等同空数组，显式 undefined 不是合法数组。 */\n readonly exclude?: readonly string[];\n readonly include: readonly string[];\n}\n\n/** 由 Project Definition 拥有的静态 change preparation 配置。 */\nexport interface ProjectChangesConfiguration {\n readonly source: ProjectChangeSource;\n /** 至少一个非空 author ID 到其匹配 region 的映射。 */\n readonly flags: Readonly<Record<string, ProjectChangeFlagRegion>>;\n}\n\n/** Definition 已验证、补齐并冻结的 region；Run 不再解释 authoring defaults。 */\nexport interface NormalizedProjectChangeFlagRegion extends ProjectChangeFlagRegion {\n readonly exclude: readonly string[];\n}\n\n/** 仅供 Definition snapshot 与 Run 消费的完整 change 配置。 */\nexport interface NormalizedProjectChangesConfiguration extends ProjectChangesConfiguration {\n readonly flags: Readonly<Record<string, NormalizedProjectChangeFlagRegion>>;\n}\n\n/**\n * 解析并冻结 change preparation 的 closed Definition grammar。\n * Runtime Git acquisition 与 region matching 有各自的 Run owner，不在此边界执行。\n */\nexport function parseProjectChangesConfiguration(\n value: unknown\n): NormalizedProjectChangesConfiguration | undefined {\n const data = snapshotClosedRecord(value);\n if (data === undefined || !hasExactPlainRecordKeys(data, [\"flags\", \"source\"])) return undefined;\n const source = parseSource(data.source);\n const flags = parseFlags(data.flags);\n return source === undefined || flags === undefined ? undefined : Object.freeze({ flags, source });\n}\n\nfunction parseSource(value: unknown): ProjectChangeSource | undefined {\n const source = snapshotClosedRecord(value);\n if (\n source === undefined ||\n !hasExactPlainRecordKeys(source, [\"compareWith\"]) ||\n !isGitComparisonRevision(source.compareWith)\n ) {\n return undefined;\n }\n return Object.freeze({ compareWith: source.compareWith });\n}\n\nfunction parseFlags(\n value: unknown\n): Readonly<Record<string, NormalizedProjectChangeFlagRegion>> | undefined {\n const flags = snapshotClosedRecord(value);\n if (flags === undefined || Object.keys(flags).length === 0) return undefined;\n const parsed: Record<string, NormalizedProjectChangeFlagRegion> = {};\n for (const [flagId, region] of Object.entries(flags)) {\n if (!isNonEmptyString(flagId)) return undefined;\n const normalizedRegion = parseRegion(region);\n if (normalizedRegion === undefined) return undefined;\n Object.defineProperty(parsed, flagId, {\n configurable: false,\n enumerable: true,\n value: normalizedRegion,\n writable: false\n });\n }\n return Object.freeze(parsed);\n}\n\nfunction parseRegion(value: unknown): NormalizedProjectChangeFlagRegion | undefined {\n const region = snapshotClosedPolicyRecord(value, {\n optional: [\"exclude\"],\n required: [\"include\"]\n });\n if (region === undefined) return undefined;\n const exclude = Object.hasOwn(region, \"exclude\")\n ? parseStringArray(region.exclude)\n : Object.freeze([]);\n const include = parseStringArray(region.include);\n return exclude === undefined || include === undefined\n ? undefined\n : Object.freeze({ exclude, include });\n}\n\nfunction parseStringArray(value: unknown): readonly string[] | undefined {\n const values = snapshotClosedArray(value);\n return values === undefined || !values.every(isNonEmptyString)\n ? undefined\n : Object.freeze([...values]);\n}\n\nfunction isGitComparisonRevision(value: unknown): value is string {\n return isNonEmptyString(value) && !value.startsWith(\"-\") && !value.includes(\"\\0\");\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n}\n"]}

package/dist/esm/project-definition/project-definition-validation.mjs CHANGED Viewed

@@ -5,7 +5,14 @@ import { parseOutputs } from "./output-validation.mjs";
 import {} from "./project-definition.mjs";
 import { snapshotClosedArray, snapshotClosedPolicyRecord, snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
 import { snapshotResourceUnitMapping } from "./resource-unit-mapping.mjs";
-const PROJECT_DEFINITION_KEYS = ["apiVersion", "checks", "outputs", "scheduler"];
+import { parseProjectChangesConfiguration } from "./project-changes.mjs";
+const PROJECT_DEFINITION_KEYS = [
+    "apiVersion",
+    "changes",
+    "checks",
+    "outputs",
+    "scheduler"
+];
 /**
  * Validates one closed Definition before Run can invoke any project callback.
  * Successful validation carries information-only Check warnings separately.
@@ -28,6 +35,12 @@ function parseProjectDefinitionFields(data) {
     const scheduler = parseScheduler(data.scheduler);
     if (scheduler === undefined)
         return invalidDefinition("definition.scheduler");
+    const changes = Object.hasOwn(data, "changes")
+        ? parseProjectChangesConfiguration(data.changes)
+        : undefined;
+    if (Object.hasOwn(data, "changes") && changes === undefined) {
+        return invalidDefinition("definition.changes");
+    }
     const checks = snapshotClosedArray(data.checks);
     if (checks === undefined)
         return invalidDefinition("definition.checks");
@@ -37,6 +50,9 @@ function parseProjectDefinitionFields(data) {
     const tree = resolveParsedCheckTree(parsedChecks, scheduler.maxParallel, scheduler.resourceCapacities);
     if (tree === undefined)
         return invalidDefinition("definition.checks");
+    if (!hasOnlyKnownChangeFlagReferences(tree.leaves, changes)) {
+        return invalidDefinition("definition.checks");
+    }
     const outputs = parseOutputs(data.outputs);
     if (outputs === undefined)
         return invalidDefinition("definition.outputs");
@@ -45,12 +61,28 @@ function parseProjectDefinitionFields(data) {
         value: {
             apiVersion: "1",
             checks: materializeCheckTreeAuthoring(parsedChecks),
+            ...(changes === undefined ? {} : { changes }),
             outputs,
             scheduler
         },
         warnings: tree.warnings
     });
 }
+function hasOnlyKnownChangeFlagReferences(checks, changes) {
+    return checks.every((check) => check.enabledByFlags === undefined ||
+        hasOnlyKnownChangeFlagConditionReferences(check.enabledByFlags.when, changes));
+}
+function hasOnlyKnownChangeFlagConditionReferences(condition, changes) {
+    if (typeof condition === "string") {
+        const prefix = "vibe-check:change:";
+        return (!condition.startsWith(prefix) ||
+            (changes !== undefined && Object.hasOwn(changes.flags, condition.slice(prefix.length))));
+    }
+    if (condition.kind === "not") {
+        return hasOnlyKnownChangeFlagConditionReferences(condition.condition, changes);
+    }
+    return condition.conditions.every((child) => hasOnlyKnownChangeFlagConditionReferences(child, changes));
+}
 function exactProjectDefinition(value) {
     const data = exactRecord(value, PROJECT_DEFINITION_KEYS, "invalid-project-definition", "definition");
     if (!data.ok)
@@ -70,7 +102,7 @@ function exactRecord(value, allowedKeys, kind, path) {
 }
 function parseScheduler(value) {
     const data = snapshotClosedPolicyRecord(value, {
-        optional: ["admissionPolicy", "measurementHooks", "resourceCapacities"],
+        optional: ["admissionPolicy", "terminalEffects", "resourceCapacities"],
         required: ["maxParallel"]
     });
     if (data === undefined)
@@ -80,8 +112,8 @@ function parseScheduler(value) {
         : Object.freeze({ kind: "static" });
     if (admissionPolicy === undefined)
         return undefined;
-    const measurementHooks = parseMeasurementHooks(data.measurementHooks);
-    if (measurementHooks === undefined)
+    const terminalEffects = parseTerminalEffects(data.terminalEffects);
+    if (terminalEffects === undefined)
         return undefined;
     const resourceCapacities = snapshotResourceUnitMapping(Object.hasOwn(data, "resourceCapacities") ? data.resourceCapacities : {});
     if (resourceCapacities === undefined)
@@ -89,25 +121,25 @@ function parseScheduler(value) {
     const maxParallel = positiveSafeInteger(data.maxParallel);
     if (maxParallel === undefined)
         return undefined;
-    return Object.freeze({ admissionPolicy, maxParallel, measurementHooks, resourceCapacities });
+    return Object.freeze({ admissionPolicy, maxParallel, terminalEffects, resourceCapacities });
 }
 function positiveSafeInteger(value) {
     return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : undefined;
 }
-function parseMeasurementHooks(value) {
+function parseTerminalEffects(value) {
     if (value === undefined)
         return Object.freeze([]);
     if (!Array.isArray(value))
         return undefined;
     const hooks = [];
     for (const hook of value) {
-        if (!isMeasurementHook(hook))
+        if (!isTerminalEffect(hook))
             return undefined;
         hooks.push(hook);
     }
     return Object.freeze(hooks);
 }
-function isMeasurementHook(value) {
+function isTerminalEffect(value) {
     return typeof value === "function";
 }
 function parseAdmissionPolicy(value) {