@zxyycom/vibe-check 0.0.1 → 0.0.3

package/types/package-tools/learned-critical-path/selection-layers.d.ts

@@ -0,0 +1,14 @@
+import type { AdmissionPolicyContext, SchedulerGraphSnapshot } from "../../project-definition/project-definition.ts";
+type Candidate = AdmissionPolicyContext["candidates"][number];
+type Task = SchedulerGraphSnapshot["tasks"][number];
+type Scope = SchedulerGraphSnapshot["scopes"][number];
+export interface LearnedSelectionLayers {
+    readonly continuation: readonly Candidate[];
+    readonly scopeById: ReadonlyMap<string, Scope>;
+    readonly taskById: ReadonlyMap<string, Task>;
+    readonly tightening: readonly Candidate[];
+}
+/** Projects the public graph and boundary facts into the Scheduler's two constrained selection layers. */
+export declare function learnedSelectionLayers(context: AdmissionPolicyContext): LearnedSelectionLayers;
+export declare function scopeForCandidate(candidate: Candidate, taskById: ReadonlyMap<string, Task>, scopeById: ReadonlyMap<string, Scope>): Scope | undefined;
+export {};

package/types/package-tools/learned-critical-path/static-decision.d.ts

@@ -0,0 +1,3 @@
+import type { AdmissionPolicyContext, AdmissionProposal } from "../../project-definition/project-definition.ts";
+/** Preserves ordinary static selection when learned preparation cannot form a ranking. */
+export declare function staticDecision(context: AdmissionPolicyContext): AdmissionProposal;

package/types/package-tools/learned-critical-path/strategy.d.ts

@@ -0,0 +1,35 @@
+import type { CustomAdmissionStrategy, SchedulerGraphSnapshot } from "../../project-definition/project-definition.ts";
+/** 公开 learned critical-path prepared strategy 的调用方配置。 */
+export interface LearnedCriticalPathStrategyOptions {
+    /** 调用方拥有的可丢弃 learned duration history 本地目录；必须是绝对路径。 */
+    readonly stateDirectory: string;
+    /** 为每个公开 Task 提供 canonical-JSON-compatible 的调用方 identity projection。 */
+    readonly identityForTask: (task: SchedulerGraphSnapshot["tasks"][number]) => unknown;
+    /** 单个 identity 最多保留的样本数；默认 32。 */
+    readonly sampleWindow?: number;
+    /** 最多保留的 identity 数；默认 4096。 */
+    readonly maxHistorySeries?: number;
+    /** 正的 cold-start duration 权重（毫秒）；默认 1。 */
+    readonly coldStartDurationMs?: number;
+    /** 可选调用方 observation sink；observer fault 不改变 scheduling 或 Run facts。 */
+    readonly observe?: (event: LearnedCriticalPathObservation) => void | Promise<void>;
+}
+/** 调用方可选 observer 收到的有界 learned strategy 事件；selection-proposed 不表示 Scheduler 已接受 admission。 */
+export type LearnedCriticalPathObservation = Readonly<{
+    readonly kind: "history-unavailable";
+    readonly reason: "identity-invalid" | "setup-failed";
+}> | Readonly<{
+    readonly kind: "selection-proposed";
+    readonly taskId: string;
+    readonly estimatedDurationMs: number;
+    readonly criticalPathScore: number;
+    readonly sampleCount: number;
+    readonly source: "learned" | "project-prior" | "cold-start";
+}> | Readonly<{
+    readonly kind: "recording-unavailable";
+}>;
+/**
+ * 构造普通公开 prepared strategy。调用方拥有 history location 与 identity projection；
+ * Product 只按同一 custom strategy lifecycle 调用它，不为该 helper 增加特权。
+ */
+export declare function createLearnedCriticalPathStrategy(options: LearnedCriticalPathStrategyOptions): CustomAdmissionStrategy;

package/types/project-definition/check-tree/authoring.d.ts

@@ -1,28 +1,28 @@
 import type { CheckDescriptor } from "../../check/descriptor.ts";
-import { type CheckVisibility, type CheckExecution, type CheckPreflight } from "../../check/check.ts";
-type TrustedDataParser = (this: void, ...parameters: never[]) => unknown;
-export type ParsedCheckCollection = Readonly<{
-    readonly kind: "exact";
-    readonly values: readonly string[];
-} | {
-    readonly kind: "inherit";
-    readonly add: readonly string[];
-    readonly remove: readonly string[];
-}>;
+import { type HandoffProviderIdentity } from "../../check/handoff-provider-identity.ts";
+import { type ParsedCheckFields, type ParsedCheckFieldPrelude, type TrustedDataParser } from "./check-fields-authoring.ts";
+import { type ParsedCheckCollection } from "./scheduling-authoring.ts";
+import type { ResourceUnitMapping } from "../resource-unit-mapping.ts";
+export type { ParsedCheckCollection } from "./scheduling-authoring.ts";
 export interface ParsedCheck {
+    readonly admissionPriority: number | undefined;
     readonly checkId: string;
     readonly checks: readonly ParsedCheck[];
     readonly definition: CheckDescriptor | null;
     readonly dependsOn: ParsedCheckCollection | undefined;
     readonly displayName: string;
-    readonly execution: CheckExecution | null;
+    readonly enabledByFlags: ParsedCheckFieldPrelude["enabledByFlags"];
+    readonly execute: ParsedCheckFieldPrelude["execute"];
+    readonly handoff: HandoffProviderIdentity | null;
     readonly maxParallel: number | undefined;
     readonly mutex: ParsedCheckCollection | undefined;
+    readonly observes: ParsedCheckCollection | undefined;
+    readonly resourceClaims: ResourceUnitMapping | undefined;
     readonly options: object | null;
     readonly path: string;
     readonly parseData: TrustedDataParser | null;
-    readonly preflight: CheckPreflight | null;
-    readonly visibility: CheckVisibility | null;
+    readonly prepare: ParsedCheckFieldPrelude["prepare"];
+    readonly omitQuietPassedRow: ParsedCheckFields["omitQuietPassedRow"];
 }
 export interface ParsedCheckTree {
     readonly checks: readonly ParsedCheck[];
@@ -38,4 +38,3 @@ export interface MeaninglessCheckWarning {
  * trusted project code, while every declarative field is copied and validated.
  */
 export declare function parseCheckTreeAuthoring(value: unknown): ParsedCheckTree | undefined;
-export {};

package/types/project-definition/check-tree/check-fields-authoring.d.ts

@@ -0,0 +1,30 @@
+import type { CheckDescriptor } from "../../check/descriptor.ts";
+import { type Check, type CheckFlagEnablement, type CheckPreparation } from "../../check/check.ts";
+import type { HandoffProviderIdentity } from "../../check/handoff-provider-identity.ts";
+export type TrustedDataParser = (this: void, ...parameters: never[]) => unknown;
+export interface CheckAuthoringData extends Readonly<Record<string, unknown>> {
+    readonly checkId: string;
+    readonly displayName: string;
+}
+export interface ParsedCheckFields {
+    readonly definition: CheckDescriptor | null;
+    readonly enabledByFlags: CheckFlagEnablement | null;
+    readonly execute: NonNullable<Check["execute"]> | null;
+    readonly handoff: HandoffProviderIdentity | null;
+    readonly options: object | null;
+    readonly parseData: TrustedDataParser | null;
+    readonly prepare: CheckPreparation | null;
+    readonly omitQuietPassedRow: boolean | null;
+}
+export interface ParsedCheckFieldPrelude {
+    readonly enabledByFlags: CheckFlagEnablement | null;
+    readonly execute: NonNullable<Check["execute"]> | null;
+    readonly handoff: HandoffProviderIdentity | null;
+    readonly parseData: TrustedDataParser | null;
+    readonly prepare: CheckPreparation | null;
+}
+export declare function parseCheckAuthoringData(value: unknown): CheckAuthoringData | undefined;
+export declare function parseCheckFieldPrelude(data: CheckAuthoringData, handoffProviderIdentity: HandoffProviderIdentity | undefined): ParsedCheckFieldPrelude | undefined;
+export declare function parseCheckFields(data: CheckAuthoringData, prelude: ParsedCheckFieldPrelude): ParsedCheckFields | undefined;
+/** Parses one closed flag-enablement field without validating its Project flag references. */
+export declare function parseFlagEnablementControl(value: unknown): CheckFlagEnablement | undefined;

package/types/project-definition/check-tree/collection-authoring.d.ts

@@ -0,0 +1,2 @@
+/** Snapshots one closed array as unique, non-empty authored identifiers. */
+export declare function parseUniqueIdentifiers(value: unknown): readonly string[] | undefined;

package/types/project-definition/check-tree/flag-conditions.d.ts

@@ -0,0 +1,5 @@
+import type { CheckFlagCondition } from "../../check/check.ts";
+/** Parses and snapshots one bounded recursive flag condition while retaining child order and multiplicity. */
+export declare function parseFlagCondition(value: unknown): CheckFlagCondition | undefined;
+/** Checks that a closed record has no author-supplied keys outside this grammar fragment. */
+export declare function hasOnlyKeys(value: Readonly<Record<string, unknown>>, keys: readonly string[]): boolean;

package/types/project-definition/check-tree/resolution.d.ts

@@ -1,16 +1,23 @@
 import type { CheckDescriptor } from "../../check/descriptor.ts";
-import type { CheckExecution, CheckPreflight, CheckVisibility } from "../../check/check.ts";
+import type { Check, CheckPreparation, CheckFlagEnablement } from "../../check/check.ts";
+import type { HandoffProviderIdentity } from "../../check/handoff-provider-identity.ts";
 import { type MeaninglessCheckWarning, type ParsedCheckTree } from "./authoring.ts";
+import { type ResourceUnitMapping } from "../resource-unit-mapping.ts";
 export type { Check, InheritableCheckCollection } from "../../check/check.ts";
 export interface ResolvedCheckTreeLeaf {
+    readonly admissionPriority: number;
     readonly definition: CheckDescriptor;
     readonly dependsOn: readonly string[];
-    readonly execution: CheckExecution;
+    readonly enabledByFlags?: CheckFlagEnablement;
+    readonly execute: NonNullable<Check["execute"]>;
+    readonly handoff?: HandoffProviderIdentity;
     readonly maxParallel: number;
     readonly mutex: readonly string[];
+    readonly observes: readonly string[];
     readonly options: object;
-    readonly preflight?: CheckPreflight;
-    readonly visibility: CheckVisibility;
+    readonly prepare?: CheckPreparation;
+    readonly resourceClaims: ResourceUnitMapping;
+    readonly omitQuietPassedRow: boolean;
 }
 export interface ResolvedCheckTree {
     readonly leaves: readonly ResolvedCheckTreeLeaf[];
@@ -21,5 +28,5 @@ export interface ResolvedCheckTree {
  * values to descendants; it never creates an execution dependency or output
  * hierarchy.
  */
-export declare function resolveCheckTree(value: unknown, rootMaxParallel: number): ResolvedCheckTree | undefined;
-export declare function resolveParsedCheckTree(parsed: ParsedCheckTree, rootMaxParallel: number): ResolvedCheckTree | undefined;
+export declare function resolveCheckTree(value: unknown, rootMaxParallel: number, resourceCapacities?: ResourceUnitMapping): ResolvedCheckTree | undefined;
+export declare function resolveParsedCheckTree(parsed: ParsedCheckTree, rootMaxParallel: number, resourceCapacities?: ResourceUnitMapping): ResolvedCheckTree | undefined;

package/types/project-definition/check-tree/scheduling-authoring.d.ts

@@ -0,0 +1,19 @@
+import { type ResourceUnitMapping } from "../resource-unit-mapping.ts";
+export type ParsedCheckCollection = Readonly<{
+    readonly kind: "exact";
+    readonly values: readonly string[];
+} | {
+    readonly kind: "inherit";
+    readonly add: readonly string[];
+    readonly remove: readonly string[];
+}>;
+export type ParsedCheckScheduling = Readonly<{
+    readonly admissionPriority: number | undefined;
+    readonly dependsOn: ParsedCheckCollection | undefined;
+    readonly maxParallel: number | undefined;
+    readonly mutex: ParsedCheckCollection | undefined;
+    readonly observes: ParsedCheckCollection | undefined;
+    readonly resourceClaims: ResourceUnitMapping | undefined;
+}>;
+/** Parses the closed relation, priority, and capacity fields for one authored Check. */
+export declare function parseCheckScheduling(data: Readonly<Record<string, unknown>>): ParsedCheckScheduling | undefined;

package/types/project-definition/declarative-snapshot.d.ts

@@ -0,0 +1,10 @@
+import type { DeclarativeProjectSnapshot, NormalizedCheck, ProjectDefinition } from "./project-definition.ts";
+import type { NormalizedProjectChangesConfiguration } from "./project-changes.ts";
+/**
+ * Produces the immutable, callback-free Definition identity consumed by fingerprinting.
+ */
+export declare function createDeclarativeProjectSnapshot(definition: Omit<ProjectDefinition, "changes"> & {
+    readonly changes?: NormalizedProjectChangesConfiguration;
+}, checks: readonly NormalizedCheck[]): DeclarativeProjectSnapshot;
+/** Generates the stable SHA-256 fingerprint for one declarative Definition snapshot. */
+export declare function createDeclarativeFingerprint(snapshot: DeclarativeProjectSnapshot): string;

package/types/project-definition/output-defaults.d.ts

@@ -1,3 +1,4 @@
+import type { ProgressRenderingOutput, ResolvedProgressRenderingOutput } from "./progress-rendering-output.ts";
 /** Default Run-owned output values applied when a Project Definition omits an override. */
 export declare const DEFAULT_PROJECT_OUTPUTS: Readonly<{
     readonly machinePublication: Readonly<{
@@ -6,9 +7,15 @@ export declare const DEFAULT_PROJECT_OUTPUTS: Readonly<{
     }>;
     readonly progressRendering: Readonly<{
         enabled: true;
+        formatter: null;
+        messagePreviewLimit: 5;
+        recordPreviewLimit: 5;
+        textPreviewCodePointLimit: 240;
     }>;
     readonly diagnosticLogging: Readonly<{
         directory: ".log/vibe-check";
         enabled: false;
     }>;
 }>;
+/** Materializes compatible progress authoring into the single renderer-ready policy. */
+export declare function resolveProgressRenderingOutput(output: Partial<ProgressRenderingOutput>): ResolvedProgressRenderingOutput;

package/types/project-definition/output-validation.d.ts

@@ -1,3 +1,4 @@
 import type { ProjectOutputs } from "./project-definition.ts";
 export declare function parseOutputs(value: unknown): ProjectOutputs | undefined;
-export declare function isContainedRelativeDirectory(directory: string): boolean;
+/** Accepts trusted output targets without claiming filesystem containment. */
+export declare function isOutputDirectory(directory: string): boolean;

package/types/project-definition/progress-rendering-output.d.ts

@@ -0,0 +1,41 @@
+/** Progress formatter 只接收当前 selected preview 的默认正文，不接收 Check 或事实对象。 */
+export type ProgressPreviewFormatter = (this: void, context: Readonly<{
+    readonly kind: "record" | "message";
+    readonly text: string;
+    readonly maxCodePoints: number;
+}>) => string;
+/** 人读 progress rendering 的作者配置；省略 preview 字段时使用 Product 默认值。 */
+export interface ProgressRenderingOutput {
+    /** `false` 时不构造或写入 progress writer。 */
+    readonly enabled: boolean;
+    /** 每个 settled block 预览的 Record 数量；非负 safe integer，默认 `5`，`0` 只隐藏 detail。 */
+    readonly recordPreviewLimit?: number;
+    /** 每个 settled block 预览的 message 数量；非负 safe integer，默认 `5`，`0` 只隐藏 detail。 */
+    readonly messagePreviewLimit?: number;
+    /** 每条 preview 正文的 Unicode code point 上限；正 safe integer，默认 `240`。 */
+    readonly textPreviewCodePointLimit?: number;
+    /** `null` 或省略保持默认正文；函数返回文本仍由 Product escape 并限制长度。 */
+    readonly formatter?: ProgressPreviewFormatter | null;
+}
+/** 已补齐 defaults、可直接交给 progress renderer 的配置。 */
+export interface ResolvedProgressRenderingOutput {
+    readonly enabled: boolean;
+    readonly formatter: ProgressPreviewFormatter | null;
+    readonly messagePreviewLimit: number;
+    readonly recordPreviewLimit: number;
+    readonly textPreviewCodePointLimit: number;
+}
+/** Closed expectations shared with invocation diagnostics; never contains authored values. */
+export type ProgressRenderingFieldExpectation = "plain-data-object" | "boolean" | "function-or-null" | "non-negative-safe-integer" | "positive-safe-integer";
+type ProgressRenderingFieldsResult = Readonly<{
+    readonly ok: true;
+    readonly value: Partial<ProgressRenderingOutput>;
+} | {
+    readonly ok: false;
+    readonly key: string | null;
+    readonly reason: "unknown-key" | "invalid-value";
+    readonly expected?: ProgressRenderingFieldExpectation;
+}>;
+/** Parses the fields shared by Definition output and RunControls override grammar. */
+export declare function parseProgressRenderingFields(value: unknown): ProgressRenderingFieldsResult;
+export {};

package/types/project-definition/project-changes.d.ts

@@ -0,0 +1,30 @@
+/** Project 自有的 Git comparison，用于为一次 Run 推导 change flags。 */
+export interface ProjectChangeSource {
+    /** 作为 comparison base 的 Git revision。 */
+    readonly compareWith: string;
+}
+/** 一个 change flag 的 project-root-relative、exclude-first glob region。 */
+export interface ProjectChangeFlagRegion {
+    /** 可省略的排除 glob；省略等同空数组，显式 undefined 不是合法数组。 */
+    readonly exclude?: readonly string[];
+    readonly include: readonly string[];
+}
+/** 由 Project Definition 拥有的静态 change preparation 配置。 */
+export interface ProjectChangesConfiguration {
+    readonly source: ProjectChangeSource;
+    /** 至少一个非空 author ID 到其匹配 region 的映射。 */
+    readonly flags: Readonly<Record<string, ProjectChangeFlagRegion>>;
+}
+/** Definition 已验证、补齐并冻结的 region；Run 不再解释 authoring defaults。 */
+export interface NormalizedProjectChangeFlagRegion extends ProjectChangeFlagRegion {
+    readonly exclude: readonly string[];
+}
+/** 仅供 Definition snapshot 与 Run 消费的完整 change 配置。 */
+export interface NormalizedProjectChangesConfiguration extends ProjectChangesConfiguration {
+    readonly flags: Readonly<Record<string, NormalizedProjectChangeFlagRegion>>;
+}
+/**
+ * 解析并冻结 change preparation 的 closed Definition grammar。
+ * Runtime Git acquisition 与 region matching 有各自的 Run owner，不在此边界执行。
+ */
+export declare function parseProjectChangesConfiguration(value: unknown): NormalizedProjectChangesConfiguration | undefined;

package/types/project-definition/project-definition.d.ts

@@ -1,42 +1,64 @@
 import type { MeaninglessCheckWarning } from "./check-tree/authoring.ts";
 import type { CheckDescriptor } from "../check/descriptor.ts";
-import type { Check, CheckExecution, CheckPreflight, CheckVisibility } from "../check/check.ts";
+import type { Check, CheckPreparation, CheckResourceClaims, CheckFlagEnablement } from "../check/check.ts";
+import type { HandoffProviderIdentity } from "../check/handoff-provider-identity.ts";
+import type { ProgressRenderingOutput, ResolvedProgressRenderingOutput } from "./progress-rendering-output.ts";
+import { type NormalizedProjectChangesConfiguration, type ProjectChangesConfiguration } from "./project-changes.ts";
+export { createDeclarativeFingerprint } from "./declarative-snapshot.ts";
 /** 一次 Project Run 的明确输出配置。 */
 export interface ProjectOutputs {
     /** `run.json` 与 `records.ndjson` publication。 */
     readonly machinePublication: Readonly<{
-        /** 相对目录以 project root 解析，默认 `artifacts/vibe-check`。 */
+        /** 相对目录从 project root 解析；绝对目录直接作为 target，默认 `artifacts/vibe-check`。 */
         readonly directory: string;
         /** `false` 时本次 Run 不发布 machine output。 */
         readonly enabled: boolean;
     }>;
-    /** 人读 progress rendering。 */
-    readonly progressRendering: Readonly<{
-        /** `false` 时不构造或写入 progress writer。 */
-        readonly enabled: boolean;
-    }>;
+    /** 人读 progress lifecycle 与 preview 配置。 */
+    readonly progressRendering: ProgressRenderingOutput;
     /** 仅供维护者读取的一次 invocation diagnostic log。 */
     readonly diagnosticLogging: Readonly<{
-        /** 相对目录以 project root 解析，默认 `.log/vibe-check`。 */
+        /** 相对目录从 project root 解析；绝对目录直接作为 target，默认 `.log/vibe-check`。 */
         readonly directory: string;
         /** `false` 时不创建 diagnostic writer 或 file。 */
         readonly enabled: boolean;
     }>;
 }
-/** 定义级的 Check 调度预算。 */
-export interface SchedulerPolicy {
-    readonly maxParallel: number;
+export type { ProgressPreviewFormatter, ProgressRenderingOutput, ResolvedProgressRenderingOutput } from "./progress-rendering-output.ts";
+/** 已解析的 Run outputs；只在 Product invocation 内部使用。 */
+export interface ResolvedProjectOutputs extends Omit<ProjectOutputs, "progressRendering"> {
+    readonly progressRendering: ResolvedProgressRenderingOutput;
 }
-/** 已补齐默认 outputs、可交给 run 执行的项目定义。 */
+/** callback-free Definition output 投影；仅供 declarative fingerprint 使用。 */
+export interface DeclarativeProjectOutputs extends Omit<ProjectOutputs, "progressRendering"> {
+    readonly progressRendering: Readonly<{
+        readonly enabled: boolean;
+        readonly formatter: "custom" | "default";
+        readonly messagePreviewLimit: number;
+        readonly recordPreviewLimit: number;
+        readonly textPreviewCodePointLimit: number;
+    }>;
+}
+export type { AdmissionPolicy, AdmissionPolicyContext, AdmissionPolicyMeasurement, AdmissionProposal, AdmissionCatalog, AdmissionGraph, AdmissionGraphInput, AdmissionInspection, AdmissionNonSelectableTask, AdmissionRejectionReason, AdmissionScopeLifecycle, AdmissionSelectionRejectionReason, AdmissionSelectionValidation, AdmissionSelectionValidationRejectionReason, AdmissionSettlementOutcome, AdmissionSettledTask, AdmissionState, AdmissionTransitionResult, CustomAdmissionPreparationContext, CustomAdmissionStrategy, PreparedCustomAdmissionStrategy, SchedulerDecisionMeasurementCumulative, SchedulerGraphSnapshot, SchedulerMeasurementActionObservation, SchedulerMeasurementActionObservationInterval, SchedulerMeasurementAdmission, SchedulerMeasurementContext, SchedulerMeasurementEffect, SchedulerTerminalEffect, SchedulerMeasurementIntervalContribution, SchedulerMeasurementPeakCounts, SchedulerMeasurementTiming, SchedulerMeasurementTimingFacts, SchedulerMeasurementTimingUnavailableReason, SchedulerPolicy, SchedulerRawMeasurement } from "./scheduler-policy.ts";
+import type { DeclarativeSchedulerPolicy, SchedulerPolicy } from "./scheduler-policy.ts";
+/**
+ * `defineConfig(...)` 形成的可重复运行项目定义：声明检查内容、调度方式与默认输出。
+ *
+ * 本次 root、flags、signal、Check 产物与日志目标以及显式 aggregation 交给 `run` 的第二个参数；
+ * 其中的 output overrides 只改变当前调用，不修改这里的默认值。
+ */
 export interface ProjectDefinition {
     readonly apiVersion: "1";
     readonly checks: readonly Check[];
+    /** 可选的静态 Git comparison 与本次 Run 的 change-flag regions。 */
+    readonly changes?: ProjectChangesConfiguration;
     readonly outputs: ProjectOutputs;
     readonly scheduler: SchedulerPolicy;
 }
 type ProjectDefinitionInput = Readonly<{
     apiVersion?: "1";
     checks?: readonly Check[];
+    changes?: ProjectChangesConfiguration;
     outputs?: Partial<{
         machinePublication: Partial<ProjectOutputs["machinePublication"]>;
         progressRendering: Partial<ProjectOutputs["progressRendering"]>;
@@ -59,30 +81,38 @@ export type ProjectDefinitionValidationResult = Readonly<{
     readonly error: ProjectDefinitionDiagnostic;
 }>;
 export interface NormalizedCheckDeclaration {
+    readonly admissionPriority: number;
     readonly definition: CheckDescriptor;
     readonly dependsOn: readonly string[];
+    /** Definition 已验证、snapshot 并冻结的单一 recursive flag-condition control。 */
+    readonly enabledByFlags?: CheckFlagEnablement;
     readonly maxParallel: number;
     readonly mutex: readonly string[];
+    readonly observes: readonly string[];
     readonly options: object;
-    readonly visibility: CheckVisibility;
+    readonly resourceClaims: CheckResourceClaims;
+    readonly omitQuietPassedRow: boolean;
 }
 export interface NormalizedCheck extends NormalizedCheckDeclaration {
-    readonly execution: CheckExecution;
-    readonly preflight?: CheckPreflight;
+    readonly execute: NonNullable<Check["execute"]>;
+    readonly handoff?: HandoffProviderIdentity;
+    readonly prepare?: CheckPreparation;
 }
 export interface DeclarativeProjectSnapshot {
     readonly apiVersion: "1";
     readonly checks: readonly NormalizedCheckDeclaration[];
-    readonly outputs: ProjectOutputs;
-    readonly scheduler: SchedulerPolicy;
+    readonly changes?: NormalizedProjectChangesConfiguration;
+    readonly outputs: DeclarativeProjectOutputs;
+    readonly scheduler: DeclarativeSchedulerPolicy;
 }
 export interface NormalizedProjectDefinition {
     readonly checks: readonly NormalizedCheck[];
+    readonly changes?: NormalizedProjectChangesConfiguration;
     readonly declarative: DeclarativeProjectSnapshot;
     readonly definitionWarnings: readonly DefinitionWarning[];
+    /** Runtime scheduler policy；custom callback 保留在此处。 */
+    readonly scheduler: SchedulerPolicy;
 }
 /** 使用 Product 默认输出创建普通 Project Definition。 */
 export declare function defineConfig<const T extends ProjectDefinitionInput>(value: T & Record<Exclude<keyof T, keyof ProjectDefinitionInput>, never>): ProjectDefinition;
 export declare function normalizeProjectDefinition(definition: ProjectDefinition): NormalizedProjectDefinition;
-export declare function createDeclarativeFingerprint(snapshot: DeclarativeProjectSnapshot): string;
-export {};

package/types/project-definition/resource-unit-mapping.d.ts

@@ -0,0 +1,4 @@
+export type ResourceUnitMapping = Readonly<Record<string, number>>;
+export declare const EMPTY_RESOURCE_UNIT_MAPPING: ResourceUnitMapping;
+/** Snapshots a canonical closed resource-to-positive-units mapping. */
+export declare function snapshotResourceUnitMapping(value: unknown): ResourceUnitMapping | undefined;