@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/project-definition/check-tree/scheduling-authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/scheduling-authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isInheritedCheckCollection,\n  snapshotInheritedCheckCollection,\n  type InheritedCheckCollection\n} from \"../../check/check.ts\";\nimport { parseUniqueIdentifiers } from \"./collection-authoring.ts\";\nimport { snapshotResourceUnitMapping, type ResourceUnitMapping } from \"../resource-unit-mapping.ts\";\n\nexport type ParsedCheckCollection = Readonly<\n  | { readonly kind: \"exact\"; readonly values: readonly string[] }\n  | {\n      readonly kind: \"inherit\";\n      readonly add: readonly string[];\n      readonly remove: readonly string[];\n    }\n>;\n\nexport type ParsedCheckScheduling = Readonly<{\n  readonly admissionPriority: number | undefined;\n  readonly dependsOn: ParsedCheckCollection | undefined;\n  readonly maxParallel: number | undefined;\n  readonly mutex: ParsedCheckCollection | undefined;\n  readonly observes: ParsedCheckCollection | undefined;\n  readonly resourceClaims: ResourceUnitMapping | undefined;\n}>;\n\n/** Parses the closed relation, priority, and capacity fields for one authored Check. */\nexport function parseCheckScheduling(\n  data: Readonly<Record<string, unknown>>\n): ParsedCheckScheduling | undefined {\n  const dependsOn = parseCollection(data, \"dependsOn\");\n  const mutex = parseCollection(data, \"mutex\");\n  const observes = parseCollection(data, \"observes\");\n  const admissionPriority = parseAdmissionPriority(data.admissionPriority);\n  const maxParallel = parseMaxParallel(data.maxParallel);\n  const resourceClaims =\n    data.resourceClaims === undefined\n      ? undefined\n      : snapshotResourceUnitMapping(data.resourceClaims);\n  if (dependsOn === null || mutex === null || observes === null) return undefined;\n  if (\n    admissionPriority === null ||\n    maxParallel === null ||\n    (data.resourceClaims !== undefined && resourceClaims === undefined)\n  ) {\n    return undefined;\n  }\n  return resolvedScheduling({\n    admissionPriority,\n    dependsOn,\n    maxParallel,\n    mutex,\n    observes,\n    resourceClaims\n  });\n}\n\nfunction resolvedScheduling(\n  scheduling: Readonly<{\n    readonly admissionPriority: number | undefined;\n    readonly dependsOn: ParsedCheckCollection | undefined;\n    readonly maxParallel: number | undefined;\n    readonly mutex: ParsedCheckCollection | undefined;\n    readonly observes: ParsedCheckCollection | undefined;\n    readonly resourceClaims: ResourceUnitMapping | undefined;\n  }>\n): ParsedCheckScheduling {\n  return Object.freeze({\n    admissionPriority: scheduling.admissionPriority,\n    dependsOn: scheduling.dependsOn ?? undefined,\n    maxParallel: scheduling.maxParallel,\n    mutex: scheduling.mutex ?? undefined,\n    observes: scheduling.observes ?? undefined,\n    resourceClaims: scheduling.resourceClaims\n  });\n}\n\nfunction parseAdmissionPriority(value: unknown): number | null | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === \"number\" && Number.isSafeInteger(value) ? value : null;\n}\n\nfunction parseMaxParallel(value: unknown): number | null | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0 ? value : null;\n}\n\nfunction parseCollection(\n  data: Readonly<Record<string, unknown>>,\n  field: \"dependsOn\" | \"mutex\" | \"observes\"\n): ParsedCheckCollection | null | undefined {\n  if (!Object.hasOwn(data, field)) return undefined;\n  const value = data[field];\n  if (isInheritedCheckCollection(value)) return parseInheritedCollection(value);\n  const values = parseUniqueIdentifiers(value);\n  return values === undefined ? null : Object.freeze({ kind: \"exact\", values });\n}\n\nfunction parseInheritedCollection(\n  value: InheritedCheckCollection<unknown>\n): ParsedCheckCollection | null {\n  const data = snapshotInheritedCheckCollection(value);\n  if (data === undefined || !hasExactInheritedKeys(data)) return null;\n  const add = data.add === undefined ? Object.freeze([]) : parseUniqueIdentifiers(data.add);\n  const remove =\n    data.remove === undefined ? Object.freeze([]) : parseUniqueIdentifiers(data.remove);\n  if (add === undefined || remove === undefined) return null;\n  return Object.freeze({ kind: \"inherit\", add, remove });\n}\n\nfunction hasExactInheritedKeys(data: Readonly<Record<string, unknown>>): boolean {\n  const keys = Object.keys(data);\n  return keys.length > 0 && keys.every((key) => key === \"add\" || key === \"remove\");\n}\n"]}

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

@@ -0,0 +1,74 @@
+import { createHash } from "node:crypto";
+import { resolveProgressRenderingOutput } from "./output-defaults.mjs";
+import { isNonArrayRecord } from "../data-boundary/value-shapes.mjs";
+/**
+ * Produces the immutable, callback-free Definition identity consumed by fingerprinting.
+ */
+export function createDeclarativeProjectSnapshot(definition, checks) {
+    const declarations = checks
+        .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),
+            maxParallel: definition.scheduler.maxParallel,
+            resourceCapacities: definition.scheduler.resourceCapacities
+        })
+    });
+}
+function declarativeOutputs(definition) {
+    const progressRendering = resolveProgressRenderingOutput(definition.outputs.progressRendering);
+    return Object.freeze({
+        diagnosticLogging: definition.outputs.diagnosticLogging,
+        machinePublication: definition.outputs.machinePublication,
+        progressRendering: Object.freeze({
+            enabled: progressRendering.enabled,
+            formatter: progressRendering.formatter === null ? "default" : "custom",
+            messagePreviewLimit: progressRendering.messagePreviewLimit,
+            recordPreviewLimit: progressRendering.recordPreviewLimit,
+            textPreviewCodePointLimit: progressRendering.textPreviewCodePointLimit
+        })
+    });
+}
+/** Generates the stable SHA-256 fingerprint for one declarative Definition snapshot. */
+export function createDeclarativeFingerprint(snapshot) {
+    return createHash("sha256").update(stableJson(snapshot)).digest("hex");
+}
+function declarativeAdmissionPolicy(policy) {
+    if (policy.kind === "custom") {
+        return Object.freeze({
+            kind: "custom",
+            strategy: Object.freeze({ kind: policy.strategy.kind })
+        });
+    }
+    return Object.freeze({ kind: "static" });
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const item of Object.values(value))
+        deepFreeze(item);
+    return Object.freeze(value);
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (isNonArrayRecord(value))
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)
+            .join(",")}}`;
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=declarative-snapshot.mjs.map

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

@@ -0,0 +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/output-defaults.mjs

@@ -1,7 +1,24 @@
 /** Default Run-owned output values applied when a Project Definition omits an override. */
 export const DEFAULT_PROJECT_OUTPUTS = Object.freeze({
     machinePublication: Object.freeze({ directory: "artifacts/vibe-check", enabled: true }),
-    progressRendering: Object.freeze({ enabled: true }),
+    progressRendering: Object.freeze({
+        enabled: true,
+        formatter: null,
+        messagePreviewLimit: 5,
+        recordPreviewLimit: 5,
+        textPreviewCodePointLimit: 240
+    }),
     diagnosticLogging: Object.freeze({ directory: ".log/vibe-check", enabled: false })
 });
+/** Materializes compatible progress authoring into the single renderer-ready policy. */
+export function resolveProgressRenderingOutput(output) {
+    const { enabled = DEFAULT_PROJECT_OUTPUTS.progressRendering.enabled, formatter = DEFAULT_PROJECT_OUTPUTS.progressRendering.formatter, messagePreviewLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.messagePreviewLimit, recordPreviewLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.recordPreviewLimit, textPreviewCodePointLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.textPreviewCodePointLimit } = output;
+    return Object.freeze({
+        enabled,
+        formatter,
+        messagePreviewLimit,
+        recordPreviewLimit,
+        textPreviewCodePointLimit
+    });
+}
 //# sourceMappingURL=output-defaults.mjs.map

package/dist/esm/project-definition/output-defaults.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-defaults.mjs","sourceRoot":"","sources":["../../../src/project-definition/output-defaults.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACvF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnD,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;CAC1E,CAAC,CAAC","sourcesContent":["/** Default Run-owned output values applied when a Project Definition omits an override. */\nexport const DEFAULT_PROJECT_OUTPUTS = Object.freeze({\n  machinePublication: Object.freeze({ directory: \"artifacts/vibe-check\", enabled: true }),\n  progressRendering: Object.freeze({ enabled: true }),\n  diagnosticLogging: Object.freeze({ directory: \".log/vibe-check\", enabled: false })\n} as const);\n"]}
+{"version":3,"file":"output-defaults.mjs","sourceRoot":"","sources":["../../../src/project-definition/output-defaults.ts"],"names":[],"mappings":"AAKA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACvF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;QACf,mBAAmB,EAAE,CAAC;QACtB,kBAAkB,EAAE,CAAC;QACrB,yBAAyB,EAAE,GAAG;KAC/B,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;CAC1E,CAAC,CAAC;AAEZ,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC5C,MAAwC;IAExC,MAAM,EACJ,OAAO,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,OAAO,EAC3D,SAAS,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,SAAS,EAC/D,mBAAmB,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,mBAAmB,EACnF,kBAAkB,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,kBAAkB,EACjF,yBAAyB,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,yBAAyB,EAChG,GAAG,MAAM,CAAC;IACX,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,SAAS;QACT,mBAAmB;QACnB,kBAAkB;QAClB,yBAAyB;KAC1B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  ProgressRenderingOutput,\n  ResolvedProgressRenderingOutput\n} from \"./progress-rendering-output.ts\";\n\n/** Default Run-owned output values applied when a Project Definition omits an override. */\nexport const DEFAULT_PROJECT_OUTPUTS = Object.freeze({\n  machinePublication: Object.freeze({ directory: \"artifacts/vibe-check\", enabled: true }),\n  progressRendering: Object.freeze({\n    enabled: true,\n    formatter: null,\n    messagePreviewLimit: 5,\n    recordPreviewLimit: 5,\n    textPreviewCodePointLimit: 240\n  }),\n  diagnosticLogging: Object.freeze({ directory: \".log/vibe-check\", enabled: false })\n} as const);\n\n/** Materializes compatible progress authoring into the single renderer-ready policy. */\nexport function resolveProgressRenderingOutput(\n  output: Partial<ProgressRenderingOutput>\n): ResolvedProgressRenderingOutput {\n  const {\n    enabled = DEFAULT_PROJECT_OUTPUTS.progressRendering.enabled,\n    formatter = DEFAULT_PROJECT_OUTPUTS.progressRendering.formatter,\n    messagePreviewLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.messagePreviewLimit,\n    recordPreviewLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.recordPreviewLimit,\n    textPreviewCodePointLimit = DEFAULT_PROJECT_OUTPUTS.progressRendering.textPreviewCodePointLimit\n  } = output;\n  return Object.freeze({\n    enabled,\n    formatter,\n    messagePreviewLimit,\n    recordPreviewLimit,\n    textPreviewCodePointLimit\n  });\n}\n"]}

package/dist/esm/project-definition/output-validation.mjs

@@ -1,37 +1,37 @@
-import { isAbsolute, relative, resolve, sep } from "node:path";
+import { parseProgressRenderingFields } from "./progress-rendering-output.mjs";
 import { snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
+import { resolveProgressRenderingOutput } from "./output-defaults.mjs";
 const OUTPUT_NAMES = ["machinePublication", "progressRendering", "diagnosticLogging"];
-const DIRECTORY_VALIDATION_ROOT = "/vibe-check-validation-root";
 export function parseOutputs(value) {
     const data = exactKeys(value, OUTPUT_NAMES);
     if (data === undefined)
         return undefined;
     const machinePublication = parseDirectoryOutput(data.machinePublication);
-    const progressRendering = parseSwitchOutput(data.progressRendering);
+    const progressRendering = parseProgressRenderingOutput(data.progressRendering);
     const diagnosticLogging = parseDirectoryOutput(data.diagnosticLogging);
     return machinePublication === undefined ||
         progressRendering === undefined ||
-        diagnosticLogging === undefined ||
-        !isContainedRelativeDirectory(diagnosticLogging.directory)
+        diagnosticLogging === undefined
         ? undefined
         : Object.freeze({ machinePublication, progressRendering, diagnosticLogging });
 }
-export function isContainedRelativeDirectory(directory) {
-    if (directory.length === 0 || isAbsolute(directory))
-        return false;
-    const root = resolve(DIRECTORY_VALIDATION_ROOT);
-    const relativeDirectory = relative(root, resolve(root, directory));
-    return relativeDirectory !== ".." && !relativeDirectory.startsWith(`..${sep}`);
+/** Accepts trusted output targets without claiming filesystem containment. */
+export function isOutputDirectory(directory) {
+    return directory.length > 0 && !directory.includes("\0");
 }
 function parseDirectoryOutput(value) {
     const data = exactKeys(value, ["directory", "enabled"]);
-    return typeof data?.directory === "string" && typeof data.enabled === "boolean"
+    return typeof data?.directory === "string" &&
+        isOutputDirectory(data.directory) &&
+        typeof data.enabled === "boolean"
         ? Object.freeze({ directory: data.directory, enabled: data.enabled })
         : undefined;
 }
-function parseSwitchOutput(value) {
-    const data = exactKeys(value, ["enabled"]);
-    return typeof data?.enabled === "boolean" ? Object.freeze({ enabled: data.enabled }) : undefined;
+function parseProgressRenderingOutput(value) {
+    const fields = parseProgressRenderingFields(value);
+    if (!fields.ok || fields.value.enabled === undefined)
+        return undefined;
+    return resolveProgressRenderingOutput(fields.value);
 }
 function exactKeys(value, keys) {
     const data = snapshotClosedRecord(value);

package/dist/esm/project-definition/output-validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-validation.mjs","sourceRoot":"","sources":["../../../src/project-definition/output-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, relative, resolve, sep } from \"node:path\";\n\nimport type { ProjectOutputs } from \"./project-definition.ts\";\nimport { snapshotClosedRecord } from \"../data-boundary/closed-values.ts\";\n\nconst OUTPUT_NAMES = [\"machinePublication\", \"progressRendering\", \"diagnosticLogging\"] as const;\nconst DIRECTORY_VALIDATION_ROOT = \"/vibe-check-validation-root\";\n\nexport function parseOutputs(value: unknown): ProjectOutputs | undefined {\n  const data = exactKeys(value, OUTPUT_NAMES);\n  if (data === undefined) return undefined;\n  const machinePublication = parseDirectoryOutput(data.machinePublication);\n  const progressRendering = parseSwitchOutput(data.progressRendering);\n  const diagnosticLogging = parseDirectoryOutput(data.diagnosticLogging);\n  return machinePublication === undefined ||\n    progressRendering === undefined ||\n    diagnosticLogging === undefined ||\n    !isContainedRelativeDirectory(diagnosticLogging.directory)\n    ? undefined\n    : Object.freeze({ machinePublication, progressRendering, diagnosticLogging });\n}\n\nexport function isContainedRelativeDirectory(directory: string): boolean {\n  if (directory.length === 0 || isAbsolute(directory)) return false;\n  const root = resolve(DIRECTORY_VALIDATION_ROOT);\n  const relativeDirectory = relative(root, resolve(root, directory));\n  return relativeDirectory !== \"..\" && !relativeDirectory.startsWith(`..${sep}`);\n}\n\nfunction parseDirectoryOutput(\n  value: unknown\n): Readonly<{ readonly directory: string; readonly enabled: boolean }> | undefined {\n  const data = exactKeys(value, [\"directory\", \"enabled\"]);\n  return typeof data?.directory === \"string\" && typeof data.enabled === \"boolean\"\n    ? Object.freeze({ directory: data.directory, enabled: data.enabled })\n    : undefined;\n}\n\nfunction parseSwitchOutput(value: unknown): Readonly<{ readonly enabled: boolean }> | undefined {\n  const data = exactKeys(value, [\"enabled\"]);\n  return typeof data?.enabled === \"boolean\" ? Object.freeze({ enabled: data.enabled }) : undefined;\n}\n\nfunction exactKeys(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const data = snapshotClosedRecord(value);\n  return data !== undefined &&\n    Object.keys(data).length === keys.length &&\n    keys.every((key) => Object.hasOwn(data, key))\n    ? data\n    : undefined;\n}\n"]}
+{"version":3,"file":"output-validation.mjs","sourceRoot":"","sources":["../../../src/project-definition/output-validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,YAAY,GAAG,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,CAAU,CAAC;AAE/F,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzE,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/E,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACvE,OAAO,kBAAkB,KAAK,SAAS;QACrC,iBAAiB,KAAK,SAAS;QAC/B,iBAAiB,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAc;IAEd,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ;QACxC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS;QACjC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc;IAClD,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,8BAA8B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAChB,KAAc,EACd,IAAuB;IAEvB,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,IAAI,KAAK,SAAS;QACvB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QACxC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC","sourcesContent":["import type { ProjectOutputs } from \"./project-definition.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"./progress-rendering-output.ts\";\nimport { parseProgressRenderingFields } from \"./progress-rendering-output.ts\";\nimport { snapshotClosedRecord } from \"../data-boundary/closed-values.ts\";\nimport { resolveProgressRenderingOutput } from \"./output-defaults.ts\";\n\nconst OUTPUT_NAMES = [\"machinePublication\", \"progressRendering\", \"diagnosticLogging\"] as const;\n\nexport function parseOutputs(value: unknown): ProjectOutputs | undefined {\n  const data = exactKeys(value, OUTPUT_NAMES);\n  if (data === undefined) return undefined;\n  const machinePublication = parseDirectoryOutput(data.machinePublication);\n  const progressRendering = parseProgressRenderingOutput(data.progressRendering);\n  const diagnosticLogging = parseDirectoryOutput(data.diagnosticLogging);\n  return machinePublication === undefined ||\n    progressRendering === undefined ||\n    diagnosticLogging === undefined\n    ? undefined\n    : Object.freeze({ machinePublication, progressRendering, diagnosticLogging });\n}\n\n/** Accepts trusted output targets without claiming filesystem containment. */\nexport function isOutputDirectory(directory: string): boolean {\n  return directory.length > 0 && !directory.includes(\"\\0\");\n}\n\nfunction parseDirectoryOutput(\n  value: unknown\n): Readonly<{ readonly directory: string; readonly enabled: boolean }> | undefined {\n  const data = exactKeys(value, [\"directory\", \"enabled\"]);\n  return typeof data?.directory === \"string\" &&\n    isOutputDirectory(data.directory) &&\n    typeof data.enabled === \"boolean\"\n    ? Object.freeze({ directory: data.directory, enabled: data.enabled })\n    : undefined;\n}\n\nfunction parseProgressRenderingOutput(value: unknown): ResolvedProgressRenderingOutput | undefined {\n  const fields = parseProgressRenderingFields(value);\n  if (!fields.ok || fields.value.enabled === undefined) return undefined;\n  return resolveProgressRenderingOutput(fields.value);\n}\n\nfunction exactKeys(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const data = snapshotClosedRecord(value);\n  return data !== undefined &&\n    Object.keys(data).length === keys.length &&\n    keys.every((key) => Object.hasOwn(data, key))\n    ? data\n    : undefined;\n}\n"]}

package/dist/esm/project-definition/progress-rendering-output.mjs

@@ -0,0 +1,52 @@
+import { snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
+const PROGRESS_RENDERING_FIELD_SPECS = Object.freeze([
+    { key: "enabled", accepts: isBoolean, expected: "boolean" },
+    { key: "formatter", accepts: isProgressPreviewFormatterOrNull, expected: "function-or-null" },
+    {
+        key: "messagePreviewLimit",
+        accepts: isNonNegativeSafeInteger,
+        expected: "non-negative-safe-integer"
+    },
+    {
+        key: "recordPreviewLimit",
+        accepts: isNonNegativeSafeInteger,
+        expected: "non-negative-safe-integer"
+    },
+    {
+        key: "textPreviewCodePointLimit",
+        accepts: isPositiveSafeInteger,
+        expected: "positive-safe-integer"
+    }
+]);
+/** Parses the fields shared by Definition output and RunControls override grammar. */
+export function parseProgressRenderingFields(value) {
+    const data = snapshotClosedRecord(value);
+    if (data === undefined) {
+        return { ok: false, key: null, reason: "invalid-value", expected: "plain-data-object" };
+    }
+    const unknownKey = Object.keys(data).find((key) => !PROGRESS_RENDERING_FIELD_SPECS.some((field) => field.key === key));
+    if (unknownKey !== undefined)
+        return { ok: false, key: unknownKey, reason: "unknown-key" };
+    for (const { key, accepts, expected } of PROGRESS_RENDERING_FIELD_SPECS) {
+        if (data[key] !== undefined && !accepts(data[key])) {
+            return { ok: false, key, reason: "invalid-value", expected };
+        }
+    }
+    return {
+        ok: true,
+        value: Object.freeze(Object.fromEntries(PROGRESS_RENDERING_FIELD_SPECS.flatMap(({ key }) => data[key] === undefined ? [] : [[key, data[key]]])))
+    };
+}
+function isBoolean(value) {
+    return typeof value === "boolean";
+}
+function isNonNegativeSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isPositiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isProgressPreviewFormatterOrNull(value) {
+    return value === null || typeof value === "function";
+}
+//# sourceMappingURL=progress-rendering-output.mjs.map

package/dist/esm/project-definition/progress-rendering-output.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-rendering-output.mjs","sourceRoot":"","sources":["../../../src/project-definition/progress-rendering-output.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../data-boundary/closed-values.ts\";\n\n/** Progress formatter 只接收当前 selected preview 的默认正文，不接收 Check 或事实对象。 */\nexport type ProgressPreviewFormatter = (\n  this: void,\n  context: Readonly<{\n    readonly kind: \"record\" | \"message\";\n    readonly text: string;\n    readonly maxCodePoints: number;\n  }>\n) => string;\n\n/** 人读 progress rendering 的作者配置；省略 preview 字段时使用 Product 默认值。 */\nexport interface ProgressRenderingOutput {\n  /** `false` 时不构造或写入 progress writer。 */\n  readonly enabled: boolean;\n  /** 每个 settled block 预览的 Record 数量；非负 safe integer，默认 `5`，`0` 只隐藏 detail。 */\n  readonly recordPreviewLimit?: number;\n  /** 每个 settled block 预览的 message 数量；非负 safe integer，默认 `5`，`0` 只隐藏 detail。 */\n  readonly messagePreviewLimit?: number;\n  /** 每条 preview 正文的 Unicode code point 上限；正 safe integer，默认 `240`。 */\n  readonly textPreviewCodePointLimit?: number;\n  /** `null` 或省略保持默认正文；函数返回文本仍由 Product escape 并限制长度。 */\n  readonly formatter?: ProgressPreviewFormatter | null;\n}\n\n/** 已补齐 defaults、可直接交给 progress renderer 的配置。 */\nexport interface ResolvedProgressRenderingOutput {\n  readonly enabled: boolean;\n  readonly formatter: ProgressPreviewFormatter | null;\n  readonly messagePreviewLimit: number;\n  readonly recordPreviewLimit: number;\n  readonly textPreviewCodePointLimit: number;\n}\n\ntype ProgressRenderingFieldSpec = Readonly<{\n  readonly key: keyof ProgressRenderingOutput;\n  readonly accepts: (value: unknown) => boolean;\n  readonly expected: ProgressRenderingFieldExpectation;\n}>;\n\n/** Closed expectations shared with invocation diagnostics; never contains authored values. */\nexport type ProgressRenderingFieldExpectation =\n  | \"plain-data-object\"\n  | \"boolean\"\n  | \"function-or-null\"\n  | \"non-negative-safe-integer\"\n  | \"positive-safe-integer\";\n\ntype ProgressRenderingFieldsResult = Readonly<\n  | { readonly ok: true; readonly value: Partial<ProgressRenderingOutput> }\n  | {\n      readonly ok: false;\n      readonly key: string | null;\n      readonly reason: \"unknown-key\" | \"invalid-value\";\n      readonly expected?: ProgressRenderingFieldExpectation;\n    }\n>;\n\nconst PROGRESS_RENDERING_FIELD_SPECS = Object.freeze([\n  { key: \"enabled\", accepts: isBoolean, expected: \"boolean\" },\n  { key: \"formatter\", accepts: isProgressPreviewFormatterOrNull, expected: \"function-or-null\" },\n  {\n    key: \"messagePreviewLimit\",\n    accepts: isNonNegativeSafeInteger,\n    expected: \"non-negative-safe-integer\"\n  },\n  {\n    key: \"recordPreviewLimit\",\n    accepts: isNonNegativeSafeInteger,\n    expected: \"non-negative-safe-integer\"\n  },\n  {\n    key: \"textPreviewCodePointLimit\",\n    accepts: isPositiveSafeInteger,\n    expected: \"positive-safe-integer\"\n  }\n] satisfies readonly ProgressRenderingFieldSpec[]);\n\n/** Parses the fields shared by Definition output and RunControls override grammar. */\nexport function parseProgressRenderingFields(value: unknown): ProgressRenderingFieldsResult {\n  const data = snapshotClosedRecord(value);\n  if (data === undefined) {\n    return { ok: false, key: null, reason: \"invalid-value\", expected: \"plain-data-object\" };\n  }\n  const unknownKey = Object.keys(data).find(\n    (key) => !PROGRESS_RENDERING_FIELD_SPECS.some((field) => field.key === key)\n  );\n  if (unknownKey !== undefined) return { ok: false, key: unknownKey, reason: \"unknown-key\" };\n  for (const { key, accepts, expected } of PROGRESS_RENDERING_FIELD_SPECS) {\n    if (data[key] !== undefined && !accepts(data[key])) {\n      return { ok: false, key, reason: \"invalid-value\", expected };\n    }\n  }\n  return {\n    ok: true,\n    value: Object.freeze(\n      Object.fromEntries(\n        PROGRESS_RENDERING_FIELD_SPECS.flatMap(({ key }) =>\n          data[key] === undefined ? [] : [[key, data[key]]]\n        )\n      ) as Partial<ProgressRenderingOutput>\n    )\n  };\n}\n\nfunction isBoolean(value: unknown): boolean {\n  return typeof value === \"boolean\";\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isPositiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction isProgressPreviewFormatterOrNull(value: unknown): boolean {\n  return value === null || typeof value === \"function\";\n}\n"]}

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

@@ -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

@@ -0,0 +1 @@
+{"version":3,"file":"project-changes.mjs","sourceRoot":"","sources":["../../../src/project-definition/project-changes.ts"],"names":[],"mappings":"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","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

@@ -3,8 +3,16 @@ import { parseCheckTreeAuthoring } from "./check-tree/authoring.mjs";
 import { materializeCheckTreeAuthoring } from "./check-tree/materialization.mjs";
 import { parseOutputs } from "./output-validation.mjs";
 import {} from "./project-definition.mjs";
-import { snapshotClosedArray, snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
-const PROJECT_DEFINITION_KEYS = ["apiVersion", "checks", "outputs", "scheduler"];
+import { snapshotClosedArray, snapshotClosedPolicyRecord, snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
+import { snapshotResourceUnitMapping } from "./resource-unit-mapping.mjs";
+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.
@@ -27,15 +35,24 @@ 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");
     const parsedChecks = parseCheckTreeAuthoring(checks);
     if (parsedChecks === undefined)
         return invalidDefinition("definition.checks");
-    const tree = resolveParsedCheckTree(parsedChecks, scheduler.maxParallel);
+    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");
@@ -44,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)
@@ -68,28 +101,111 @@ function exactRecord(value, allowedKeys, kind, path) {
     return Object.freeze({ ok: true, value: data });
 }
 function parseScheduler(value) {
-    const data = exactKeys(value, ["maxParallel"]);
-    return typeof data?.maxParallel === "number" &&
-        Number.isSafeInteger(data.maxParallel) &&
-        data.maxParallel > 0
-        ? Object.freeze({ maxParallel: data.maxParallel })
-        : undefined;
+    const data = snapshotClosedPolicyRecord(value, {
+        optional: ["admissionPolicy", "terminalEffects", "resourceCapacities"],
+        required: ["maxParallel"]
+    });
+    if (data === undefined)
+        return undefined;
+    const admissionPolicy = Object.hasOwn(data, "admissionPolicy")
+        ? parseAdmissionPolicy(data.admissionPolicy)
+        : Object.freeze({ kind: "static" });
+    if (admissionPolicy === undefined)
+        return undefined;
+    const terminalEffects = parseTerminalEffects(data.terminalEffects);
+    if (terminalEffects === undefined)
+        return undefined;
+    const resourceCapacities = snapshotResourceUnitMapping(Object.hasOwn(data, "resourceCapacities") ? data.resourceCapacities : {});
+    if (resourceCapacities === undefined)
+        return undefined;
+    const maxParallel = positiveSafeInteger(data.maxParallel);
+    if (maxParallel === undefined)
+        return undefined;
+    return Object.freeze({ admissionPolicy, maxParallel, terminalEffects, resourceCapacities });
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : undefined;
+}
+function parseTerminalEffects(value) {
+    if (value === undefined)
+        return Object.freeze([]);
+    if (!Array.isArray(value))
+        return undefined;
+    const hooks = [];
+    for (const hook of value) {
+        if (!isTerminalEffect(hook))
+            return undefined;
+        hooks.push(hook);
+    }
+    return Object.freeze(hooks);
+}
+function isTerminalEffect(value) {
+    return typeof value === "function";
 }
-function exactKeys(value, keys) {
+function parseAdmissionPolicy(value) {
     const data = snapshotClosedRecord(value);
-    if (data === undefined)
+    if (data === undefined || typeof data.kind !== "string")
         return undefined;
-    return Object.keys(data).length === keys.length && keys.every((key) => Object.hasOwn(data, key))
-        ? data
-        : undefined;
+    switch (data.kind) {
+        case "static":
+            return parseStaticAdmissionPolicy(data);
+        case "custom":
+            return parseCustomAdmissionPolicy(data);
+    }
+    return undefined;
+}
+function parseStaticAdmissionPolicy(policy) {
+    return hasExactKeys(policy, ["kind"]) ? Object.freeze({ kind: "static" }) : undefined;
+}
+function parseCustomAdmissionPolicy(policy) {
+    if (!hasExactKeys(policy, ["kind", "strategy"]))
+        return undefined;
+    const strategy = parseCustomAdmissionStrategy(policy.strategy);
+    return strategy === undefined ? undefined : Object.freeze({ kind: "custom", strategy });
+}
+function parseCustomAdmissionStrategy(value) {
+    const strategy = snapshotClosedRecord(value);
+    if (strategy === undefined || typeof strategy.kind !== "string")
+        return undefined;
+    if (strategy.kind === "simple") {
+        if (!hasExactKeys(strategy, ["kind", "decide"]))
+            return undefined;
+        if (!isSimpleCustomDecision(strategy.decide))
+            return undefined;
+        return Object.freeze({ kind: "simple", decide: strategy.decide });
+    }
+    if (strategy.kind === "prepared") {
+        if (!hasExactKeys(strategy, ["kind", "prepare"]))
+            return undefined;
+        if (!isPreparedCustomPreparation(strategy.prepare))
+            return undefined;
+        return Object.freeze({ kind: "prepared", prepare: strategy.prepare });
+    }
+    return undefined;
+}
+function isSimpleCustomDecision(value) {
+    return typeof value === "function";
+}
+function isPreparedCustomPreparation(value) {
+    return typeof value === "function";
+}
+function hasExactKeys(value, keys) {
+    return (Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key)));
 }
 function invalidDefinition(path) {
     return Object.freeze({
         ok: false,
-        error: Object.freeze({ kind: "invalid-project-definition", path, reason: "invalid-value" })
+        error: Object.freeze({
+            kind: "invalid-project-definition",
+            path,
+            reason: "invalid-value"
+        })
     });
 }
 function invalid(kind, path, reason) {
-    return Object.freeze({ ok: false, error: Object.freeze({ kind, path, reason }) });
+    return Object.freeze({
+        ok: false,
+        error: Object.freeze({ kind, path, reason })
+    });
 }
 //# sourceMappingURL=project-definition-validation.mjs.map