@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/data-boundary/value-shapes.mjs

@@ -10,4 +10,13 @@ export function isUnknownArray(value) {
 export function isStringArray(value) {
     return isUnknownArray(value) && value.every((item) => typeof item === "string");
 }
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+export function isPositiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+export function isNonNegativeSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
 //# sourceMappingURL=value-shapes.mjs.map

package/dist/esm/data-boundary/value-shapes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"value-shapes.mjs","sourceRoot":"","sources":["../../../src/data-boundary/value-shapes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAClF,CAAC","sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport function isNonArrayRecord(value: unknown): value is Record<string, unknown> {\n  return isRecord(value) && !Array.isArray(value);\n}\n\nexport function isUnknownArray(value: unknown): value is unknown[] {\n  return Array.isArray(value);\n}\n\nexport function isStringArray(value: unknown): value is string[] {\n  return isUnknownArray(value) && value.every((item) => typeof item === \"string\");\n}\n"]}
+{"version":3,"file":"value-shapes.mjs","sourceRoot":"","sources":["../../../src/data-boundary/value-shapes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC","sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport function isNonArrayRecord(value: unknown): value is Record<string, unknown> {\n  return isRecord(value) && !Array.isArray(value);\n}\n\nexport function isUnknownArray(value: unknown): value is unknown[] {\n  return Array.isArray(value);\n}\n\nexport function isStringArray(value: unknown): value is string[] {\n  return isUnknownArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nexport function isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nexport function isPositiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nexport function isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n"]}

package/dist/esm/index.mjs

@@ -1,15 +1,18 @@
 /**
- * Vibe Check 是由项目在 Bun runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。
+ * Vibe Check 是由项目在 Node runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。
  * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。
  *
  * @packageDocumentation
  */
+export { cacheJsonByKey } from "./cache/cache-json-by-key.mjs";
 export { duplicateDetection } from "./package-checks/duplicate-detection/default-check.mjs";
 export { parseDuplicateDetectionData } from "./package-checks/duplicate-detection/final-data.mjs";
 export { fileMetrics } from "./package-checks/file-metrics/constructor.mjs";
 export { parseFileMetricsData } from "./package-checks/file-metrics/final-data.mjs";
 export { functionMetrics } from "./package-checks/function-metrics/constructor.mjs";
 export { parseFunctionMetricsData } from "./package-checks/function-metrics/final-data.mjs";
+export { secretDetection } from "./package-checks/secret-detection/default-check.mjs";
+export { parseSecretDetectionData } from "./package-checks/secret-detection/final-data.mjs";
 export { jsonSchemaValidation } from "./package-checks/json-schema-validation/default-check.mjs";
 export { parseJsonSchemaValidationData } from "./package-checks/json-schema-validation/final-data.mjs";
 export { jsonValidation } from "./package-checks/json-validation/default-check.mjs";
@@ -19,8 +22,12 @@ export { parseMaintenanceRemindersData } from "./package-checks/maintenance-remi
 export { markdownLinkValidation } from "./package-checks/markdown-link-validation/default-check.mjs";
 export { parseMarkdownLinkValidationData } from "./package-checks/markdown-link-validation/final-data.mjs";
 export { reconcileFindingWaivers } from "./finding-waivers/reconciliation.mjs";
+export { presentCheckFindings } from "./check/finding-presentation.mjs";
 export { defaultProjectFileSelection } from "./package-checks/project-files/configuration.mjs";
+export { collectProjectFiles } from "./package-checks/project-files/public-collection.mjs";
 export { defineCheck, inherit } from "./check/check.mjs";
-export { defineConfig } from "./project-definition/project-definition.mjs";
+export { defineAdmissionPolicy, defineConfig } from "./project-definition/project-definition.mjs";
+export { createLearnedCriticalPathStrategy } from "./learned-critical-path/strategy.mjs";
+export { createAdmissionGraph } from "./project-run/task-scheduler/admission-core/core.mjs";
 export { run } from "./project-run/run.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAQjG,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAUnF,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAQ3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAYtG,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAWzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAMvG,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAMrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAU1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAS9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAM9F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAYxD,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAW1E,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Vibe Check 是由项目在 Bun runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。\n * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。\n *\n * @packageDocumentation\n */\nexport { duplicateDetection } from \"./package-checks/duplicate-detection/default-check.ts\";\nexport { parseDuplicateDetectionData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type { DuplicateDetectionFinalData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type {\n  DuplicateDetectionOptions,\n  ResolvedDuplicateDetectionOptions\n} from \"./package-checks/duplicate-detection/options.ts\";\nexport type { DuplicateDetectionUnavailableReasonCode } from \"./package-checks/duplicate-detection/execution.ts\";\nexport type { DuplicateDetectionRecordData } from \"./package-checks/duplicate-detection/records.ts\";\nexport { fileMetrics } from \"./package-checks/file-metrics/constructor.ts\";\nexport { parseFileMetricsData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type { FileMetricsFinalData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  FileMetricsOptions,\n  ResolvedFileMetricsOptions\n} from \"./package-checks/file-metrics/options.ts\";\nexport type { FileMetricsUnavailableReasonCode } from \"./package-checks/file-metrics/execution.ts\";\nexport type { FileMetricsRecordData } from \"./package-checks/file-metrics/records.ts\";\nexport { functionMetrics } from \"./package-checks/function-metrics/constructor.ts\";\nexport { parseFunctionMetricsData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type { FunctionMetricsFinalData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type {\n  FunctionMetricsOptions,\n  ResolvedFunctionMetricsOptions\n} from \"./package-checks/function-metrics/options.ts\";\nexport type { FunctionMetricsUnavailableReasonCode } from \"./package-checks/function-metrics/execution.ts\";\nexport type { FunctionMetricsRecordData } from \"./package-checks/function-metrics/records.ts\";\nexport { jsonSchemaValidation } from \"./package-checks/json-schema-validation/default-check.ts\";\nexport { parseJsonSchemaValidationData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type { JsonSchemaValidationFinalData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type {\n  JsonSchemaValidationOptions,\n  ResolvedJsonSchemaValidationOptions\n} from \"./package-checks/json-schema-validation/options.ts\";\nexport type {\n  JsonSchemaDocumentReason,\n  JsonSchemaValidationRecordData,\n  JsonSchemaValidationRecordReason,\n  JsonSchemaValidationUnavailableCode\n} from \"./package-checks/json-schema-validation/json-schema-validation.ts\";\nexport { jsonValidation } from \"./package-checks/json-validation/default-check.ts\";\nexport { parseJsonValidationData } from \"./package-checks/json-validation/final-data.ts\";\nexport type { JsonValidationFinalData } from \"./package-checks/json-validation/final-data.ts\";\nexport type {\n  JsonValidationOptions,\n  ResolvedJsonValidationOptions\n} from \"./package-checks/json-validation/options.ts\";\nexport type {\n  JsonValidationRecordData,\n  JsonValidationRecordReason,\n  JsonValidationUnavailableCode\n} from \"./package-checks/json-validation/json-validation.ts\";\nexport { maintenanceReminders } from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport type {\n  MaintenanceReminder,\n  MaintenanceReminderOptions,\n  MaintenanceRemindersUnavailableCode\n} from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport { parseMaintenanceRemindersData } from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport type {\n  MaintenanceReminderAssessment,\n  MaintenanceReminderUnavailableReason,\n  MaintenanceRemindersFinalData\n} from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport { markdownLinkValidation } from \"./package-checks/markdown-link-validation/default-check.ts\";\nexport { parseMarkdownLinkValidationData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type { MarkdownLinkValidationFinalData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./package-checks/markdown-link-validation/options.ts\";\nexport type { MarkdownLinkValidationUnavailableReason } from \"./package-checks/markdown-link-validation/execution.ts\";\nexport type { MarkdownLinkValidationRecordData } from \"./package-checks/markdown-link-validation/records.ts\";\nexport type { MarkdownLinkFindingReason } from \"./package-checks/markdown-link-validation/local-resolver.ts\";\nexport type { FindingPolicy } from \"./package-checks/code-quality-findings/policy.ts\";\nexport { reconcileFindingWaivers } from \"./finding-waivers/reconciliation.ts\";\nexport type {\n  FindingWaiver,\n  FindingWaiverAudit,\n  FindingWaiverReconciliation,\n  MaterializedFindingWaiver,\n  ReconciledFinding,\n  ReconcileFindingWaiversOptions\n} from \"./finding-waivers/reconciliation.ts\";\nexport { defaultProjectFileSelection } from \"./package-checks/project-files/configuration.ts\";\nexport type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions,\n  ProjectFileSource\n} from \"./package-checks/project-files/configuration.ts\";\nexport { defineCheck, inherit } from \"./check/check.ts\";\nexport type {\n  Check,\n  CheckExecution,\n  CheckExecutionContext,\n  CheckPreflight,\n  CheckPreflightResult,\n  CheckOutcome,\n  CheckResult,\n  CheckUnavailableReason,\n  InheritableCheckCollection\n} from \"./check/check.ts\";\nexport { defineConfig } from \"./project-definition/project-definition.ts\";\nexport type {\n  ProjectOutputs,\n  ProjectDefinition,\n  SchedulerPolicy\n} from \"./project-definition/project-definition.ts\";\nexport type {\n  CheckAggregate,\n  CheckAggregation,\n  RunControls\n} from \"./project-run/controls/contract.ts\";\nexport { run } from \"./project-run/run.ts\";\nexport type { RunResult } from \"./project-run/result.ts\";\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAWjG,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAUnF,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAW3F,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAU3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAkBtG,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAWzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAMvG,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAMrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAU1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AASvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAO1F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAcxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAKxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AA0C3F,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Vibe Check 是由项目在 Node runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。\n * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。\n *\n * @packageDocumentation\n */\nexport { cacheJsonByKey } from \"./cache/cache-json-by-key.ts\";\nexport type { CacheJsonByKeyOptions, CacheJsonByKeyResult } from \"./cache/cache-json-by-key.ts\";\nexport { duplicateDetection } from \"./package-checks/duplicate-detection/default-check.ts\";\nexport { parseDuplicateDetectionData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type { DuplicateDetectionFinalData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type {\n  DuplicateDetectionFindingIdentity,\n  DuplicateDetectionFindingLocation,\n  DuplicateDetectionFindingWaiver,\n  DuplicateDetectionOptions,\n  ResolvedDuplicateDetectionOptions\n} from \"./package-checks/duplicate-detection/options.ts\";\nexport type { DuplicateDetectionUnavailableReasonCode } from \"./package-checks/duplicate-detection/execution.ts\";\nexport type { DuplicateDetectionRecordData } from \"./package-checks/duplicate-detection/records.ts\";\nexport { fileMetrics } from \"./package-checks/file-metrics/constructor.ts\";\nexport { parseFileMetricsData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type { FileMetricsFinalData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  FileMetricsOptions,\n  ResolvedFileMetricsOptions\n} from \"./package-checks/file-metrics/options.ts\";\nexport type { FileMetricsUnavailableReasonCode } from \"./package-checks/file-metrics/execution.ts\";\nexport type { FileMetricsRecordData } from \"./package-checks/file-metrics/records.ts\";\nexport { functionMetrics } from \"./package-checks/function-metrics/constructor.ts\";\nexport { parseFunctionMetricsData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type { FunctionMetricsFinalData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type {\n  FunctionMetricsFindingIdentity,\n  FunctionMetricsFindingMetric,\n  FunctionMetricsFindingWaiver,\n  FunctionMetricsOptions,\n  ResolvedFunctionMetricsOptions\n} from \"./package-checks/function-metrics/options.ts\";\nexport type { FunctionMetricsUnavailableReasonCode } from \"./package-checks/function-metrics/execution.ts\";\nexport type { FunctionMetricsRecordData } from \"./package-checks/function-metrics/records.ts\";\nexport { secretDetection } from \"./package-checks/secret-detection/default-check.ts\";\nexport { parseSecretDetectionData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type { SecretDetectionFinalData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type {\n  ResolvedSecretDetectionOptions,\n  SecretDetectionFindingIdentity,\n  SecretDetectionFindingWaiver,\n  SecretDetectionOptions\n} from \"./package-checks/secret-detection/options.ts\";\nexport type { SecretDetectionUnavailableReasonCode } from \"./package-checks/secret-detection/execution.ts\";\nexport type { SecretDetectionRecordData } from \"./package-checks/secret-detection/records.ts\";\nexport { jsonSchemaValidation } from \"./package-checks/json-schema-validation/default-check.ts\";\nexport { parseJsonSchemaValidationData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type { JsonSchemaValidationFinalData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type {\n  JsonSchemaIdentity,\n  JsonSchemaIdentityMode,\n  JsonSchemaInstanceBinding,\n  JsonSchemaReferenceResolution,\n  JsonSchemaReferenceSource,\n  JsonSchemaValidationOptions,\n  RegisteredJsonSchema,\n  ResolvedJsonSchemaValidationOptions\n} from \"./package-checks/json-schema-validation/options.ts\";\nexport type {\n  JsonSchemaDocumentReason,\n  JsonSchemaValidationRecordData,\n  JsonSchemaValidationRecordReason,\n  JsonSchemaValidationUnavailableCode\n} from \"./package-checks/json-schema-validation/json-schema-validation.ts\";\nexport { jsonValidation } from \"./package-checks/json-validation/default-check.ts\";\nexport { parseJsonValidationData } from \"./package-checks/json-validation/final-data.ts\";\nexport type { JsonValidationFinalData } from \"./package-checks/json-validation/final-data.ts\";\nexport type {\n  JsonValidationOptions,\n  ResolvedJsonValidationOptions\n} from \"./package-checks/json-validation/options.ts\";\nexport type {\n  JsonValidationRecordData,\n  JsonValidationRecordReason,\n  JsonValidationUnavailableCode\n} from \"./package-checks/json-validation/json-validation.ts\";\nexport { maintenanceReminders } from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport type {\n  MaintenanceReminder,\n  MaintenanceReminderOptions,\n  MaintenanceRemindersUnavailableCode\n} from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport { parseMaintenanceRemindersData } from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport type {\n  MaintenanceReminderAssessment,\n  MaintenanceReminderUnavailableReason,\n  MaintenanceRemindersFinalData\n} from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport { markdownLinkValidation } from \"./package-checks/markdown-link-validation/default-check.ts\";\nexport { parseMarkdownLinkValidationData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type { MarkdownLinkValidationFinalData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./package-checks/markdown-link-validation/options.ts\";\nexport type { MarkdownLinkValidationUnavailableReason } from \"./package-checks/markdown-link-validation/execution.ts\";\nexport type { MarkdownLinkValidationRecordData } from \"./package-checks/markdown-link-validation/records.ts\";\nexport type { MarkdownLinkFindingReason } from \"./package-checks/markdown-link-validation/local-resolver.ts\";\nexport type { FindingPolicy } from \"./package-checks/code-quality-findings/policy.ts\";\nexport { reconcileFindingWaivers } from \"./finding-waivers/reconciliation.ts\";\nexport { presentCheckFindings } from \"./check/finding-presentation.ts\";\nexport type {\n  FindingWaiver,\n  FindingWaiverAudit,\n  FindingWaiverReconciliation,\n  MaterializedFindingWaiver,\n  ReconciledFinding,\n  ReconcileFindingWaiversOptions\n} from \"./finding-waivers/reconciliation.ts\";\nexport { defaultProjectFileSelection } from \"./package-checks/project-files/configuration.ts\";\nexport { collectProjectFiles } from \"./package-checks/project-files/public-collection.ts\";\nexport type { CollectProjectFilesOptions } from \"./package-checks/project-files/public-collection.ts\";\nexport type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions,\n  ProjectFileSource\n} from \"./package-checks/project-files/configuration.ts\";\nexport { defineCheck, inherit } from \"./check/check.ts\";\nexport type {\n  Check,\n  CheckDependencies,\n  CheckExecution,\n  CheckExecutionContext,\n  CheckPreflight,\n  CheckPreflightResult,\n  CheckResourceClaims,\n  CheckOutcome,\n  CheckResult,\n  CheckUnavailableReason,\n  InheritableCheckCollection\n} from \"./check/check.ts\";\nexport { defineAdmissionPolicy, defineConfig } from \"./project-definition/project-definition.ts\";\nexport { createLearnedCriticalPathStrategy } from \"./learned-critical-path/strategy.ts\";\nexport type {\n  LearnedCriticalPathObservation,\n  LearnedCriticalPathStrategyOptions\n} from \"./learned-critical-path/strategy.ts\";\nexport { createAdmissionGraph } from \"./project-run/task-scheduler/admission-core/core.ts\";\nexport type {\n  AdmissionPolicy,\n  AdmissionPolicyContext,\n  AdmissionPolicyMeasurement,\n  AdmissionProposal,\n  AdmissionCatalog,\n  AdmissionGraph,\n  AdmissionGraphInput,\n  AdmissionInspection,\n  AdmissionNonSelectableTask,\n  AdmissionRejectionReason,\n  AdmissionScopeLifecycle,\n  AdmissionSelectionRejectionReason,\n  AdmissionSelectionValidation,\n  AdmissionSelectionValidationRejectionReason,\n  AdmissionSettlementOutcome,\n  AdmissionSettledTask,\n  AdmissionState,\n  AdmissionTransitionResult,\n  CustomAdmissionPreparationContext,\n  CustomAdmissionStrategy,\n  PreparedCustomAdmissionStrategy,\n  ProgressPreviewFormatter,\n  ProjectOutputs,\n  ProjectDefinition,\n  SchedulerDecisionMeasurementCumulative,\n  SchedulerGraphSnapshot,\n  SchedulerMeasurementContext,\n  SchedulerMeasurementHook,\n  SchedulerMeasurementIntervalContribution,\n  SchedulerMeasurementActionObservationInterval,\n  SchedulerMeasurementActionObservation,\n  SchedulerMeasurementEffect,\n  SchedulerRawMeasurement,\n  SchedulerPolicy\n} from \"./project-definition/project-definition.ts\";\nexport type {\n  CheckAggregate,\n  CheckAggregation,\n  RunControls\n} from \"./project-run/controls/contract.ts\";\nexport { run } from \"./project-run/run.ts\";\nexport type { RunOutputStatus, RunOutputStatuses } from \"./project-run/outputs/status.ts\";\nexport type { RunResult } from \"./project-run/result.ts\";\n"]}

package/dist/esm/learned-critical-path/duration-model/bounded-history.mjs

@@ -0,0 +1,56 @@
+export const SCHEDULER_HISTORY_ENVELOPE_VERSION = "scheduler-history-envelope-v1";
+export const SCHEDULER_HISTORY_FILE_NAME = "scheduler-history.json";
+export const SCHEDULER_HISTORY_MODEL_VERSION = "scheduler-duration-model-v1";
+export const MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES = 32;
+export const MAX_SCHEDULER_HISTORY_SERIES = 4_096;
+/** Bound persisted task-active durations so aggregates remain exact safe integers. */
+export const MAX_SCHEDULER_HISTORY_DURATION_MS = 2_147_483_647;
+export function emptySchedulerHistory() {
+    return Object.freeze({ latestObservationSequence: 0, series: Object.freeze([]) });
+}
+export function schedulerHistorySeries(history, identityDigest) {
+    return history.series.find((series) => series.identityDigest === identityDigest);
+}
+export function freezeSchedulerHistoryModel(input) {
+    return Object.freeze({
+        latestObservationSequence: input.latestObservationSequence,
+        series: Object.freeze([...input.series]
+            .sort((left, right) => compareText(left.identityDigest, right.identityDigest))
+            .map((series) => Object.freeze({
+            identityDigest: series.identityDigest,
+            latestObservationSequence: series.latestObservationSequence,
+            samples: Object.freeze(series.samples.map((sample) => Object.freeze({
+                durationMs: sample.durationMs,
+                observationSequence: sample.observationSequence,
+                settlementKind: sample.settlementKind
+            })))
+        })))
+    });
+}
+export function isSchedulerHistoryIdentityDigest(value) {
+    return typeof value === "string" && /^sha256:[0-9a-f]{64}$/.test(value);
+}
+export function isSchedulerSettlementKind(value) {
+    return (value === "completed" ||
+        value === "prerequisite-unsatisfied" ||
+        value === "failed" ||
+        value === "blocked" ||
+        value === "cancelled-before-start");
+}
+export function isBoundedDurationMs(value) {
+    return (typeof value === "number" &&
+        Number.isFinite(value) &&
+        value >= 0 &&
+        value <= MAX_SCHEDULER_HISTORY_DURATION_MS);
+}
+export function isObservationSequence(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=bounded-history.mjs.map

package/dist/esm/learned-critical-path/duration-model/bounded-history.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-history.mjs","sourceRoot":"","sources":["../../../../src/learned-critical-path/duration-model/bounded-history.ts"],"names":[],"mappings":"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","sourcesContent":["export const SCHEDULER_HISTORY_ENVELOPE_VERSION = \"scheduler-history-envelope-v1\";\nexport const SCHEDULER_HISTORY_FILE_NAME = \"scheduler-history.json\";\nexport const SCHEDULER_HISTORY_MODEL_VERSION = \"scheduler-duration-model-v1\";\nexport const MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES = 32;\nexport const MAX_SCHEDULER_HISTORY_SERIES = 4_096;\n\n/** Bound persisted task-active durations so aggregates remain exact safe integers. */\nexport const MAX_SCHEDULER_HISTORY_DURATION_MS = 2_147_483_647;\n\n/** Persisted terminal kind vocabulary; duration storage does not depend on Scheduler ownership. */\nexport type SchedulerDurationSettlementKind =\n  | \"completed\"\n  | \"prerequisite-unsatisfied\"\n  | \"failed\"\n  | \"blocked\"\n  | \"cancelled-before-start\";\n\nexport interface SchedulerHistorySample {\n  readonly durationMs: number;\n  readonly observationSequence: number;\n  readonly settlementKind: SchedulerDurationSettlementKind;\n}\n\nexport interface SchedulerHistorySeries {\n  readonly identityDigest: string;\n  readonly latestObservationSequence: number;\n  readonly samples: readonly SchedulerHistorySample[];\n}\n\n/** Immutable, Product-private local model; the only persisted state is its closed envelope. */\nexport interface SchedulerHistoryModel {\n  readonly latestObservationSequence: number;\n  readonly series: readonly SchedulerHistorySeries[];\n}\n\nexport function emptySchedulerHistory(): SchedulerHistoryModel {\n  return Object.freeze({ latestObservationSequence: 0, series: Object.freeze([]) });\n}\n\nexport function schedulerHistorySeries(\n  history: SchedulerHistoryModel,\n  identityDigest: string\n): SchedulerHistorySeries | undefined {\n  return history.series.find((series) => series.identityDigest === identityDigest);\n}\n\nexport function freezeSchedulerHistoryModel(input: {\n  readonly latestObservationSequence: number;\n  readonly series: readonly SchedulerHistorySeries[];\n}): SchedulerHistoryModel {\n  return Object.freeze({\n    latestObservationSequence: input.latestObservationSequence,\n    series: Object.freeze(\n      [...input.series]\n        .sort((left, right) => compareText(left.identityDigest, right.identityDigest))\n        .map((series) =>\n          Object.freeze({\n            identityDigest: series.identityDigest,\n            latestObservationSequence: series.latestObservationSequence,\n            samples: Object.freeze(\n              series.samples.map((sample) =>\n                Object.freeze({\n                  durationMs: sample.durationMs,\n                  observationSequence: sample.observationSequence,\n                  settlementKind: sample.settlementKind\n                })\n              )\n            )\n          })\n        )\n    )\n  });\n}\n\nexport function isSchedulerHistoryIdentityDigest(value: unknown): value is string {\n  return typeof value === \"string\" && /^sha256:[0-9a-f]{64}$/.test(value);\n}\n\nexport function isSchedulerSettlementKind(\n  value: unknown\n): value is SchedulerDurationSettlementKind {\n  return (\n    value === \"completed\" ||\n    value === \"prerequisite-unsatisfied\" ||\n    value === \"failed\" ||\n    value === \"blocked\" ||\n    value === \"cancelled-before-start\"\n  );\n}\n\nexport function isBoundedDurationMs(value: unknown): value is number {\n  return (\n    typeof value === \"number\" &&\n    Number.isFinite(value) &&\n    value >= 0 &&\n    value <= MAX_SCHEDULER_HISTORY_DURATION_MS\n  );\n}\n\nexport function isObservationSequence(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\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"]}

package/dist/esm/learned-critical-path/duration-model/prediction.mjs

@@ -0,0 +1,122 @@
+import { createHash } from "node:crypto";
+import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+import { SCHEDULER_HISTORY_MODEL_VERSION, schedulerHistorySeries } from "./bounded-history.mjs";
+export function createSchedulerHistoryIdentity(input) {
+    const authoredOptionsDigest = digestCanonicalValue(input.authoredOptions);
+    const flagsDigest = digestCanonicalValue(input.flags);
+    return digestCanonicalValue({
+        authoredOptionsDigest,
+        checkId: input.checkId,
+        flagsDigest,
+        modelVersion: SCHEDULER_HISTORY_MODEL_VERSION
+    });
+}
+/** Forms learned means first, then one project median prior, without invoking preflight. */
+export function createSchedulerPredictionSnapshot(history, inputs, coldStartDurationMs = 1) {
+    const learned = inputs.map((input) => learnedPrediction(history, input));
+    const projectPrior = median(learned.flatMap((prediction) => prediction.source === "learned" ? [prediction.estimatedDurationMs] : []));
+    const predictions = learned.map((prediction) => {
+        if (prediction.source === "learned")
+            return prediction;
+        if (projectPrior === undefined)
+            return coldStartPrediction(prediction, coldStartDurationMs);
+        return projectPriorPrediction(prediction, projectPrior);
+    });
+    const digest = digestCanonicalValue({
+        modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,
+        predictions: [...predictions]
+            .sort((left, right) => compareText(left.taskId, right.taskId))
+            .map((prediction) => ({
+            estimatedDurationMs: prediction.estimatedDurationMs,
+            identityDigest: prediction.identityDigest,
+            meanDurationMs: prediction.meanDurationMs,
+            p90DurationMs: prediction.p90DurationMs,
+            sampleCount: prediction.sampleCount,
+            source: prediction.source,
+            taskId: prediction.taskId
+        }))
+    });
+    return Object.freeze({
+        digest,
+        modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,
+        predictions: Object.freeze(predictions.map(freezePrediction))
+    });
+}
+export function predictionForTask(snapshot, taskId) {
+    return snapshot.predictions.find((prediction) => prediction.taskId === taskId);
+}
+function learnedPrediction(history, input) {
+    const identityDigest = createSchedulerHistoryIdentity(input);
+    const samples = schedulerHistorySeries(history, identityDigest)?.samples ?? [];
+    if (samples.length === 0) {
+        return Object.freeze({
+            estimatedDurationMs: 0,
+            identityDigest,
+            meanDurationMs: null,
+            p90DurationMs: null,
+            sampleCount: 0,
+            source: "cold-start",
+            taskId: input.taskId
+        });
+    }
+    const meanDurationMs = arithmeticMean(samples.map((sample) => sample.durationMs));
+    return Object.freeze({
+        estimatedDurationMs: meanDurationMs,
+        identityDigest,
+        meanDurationMs,
+        p90DurationMs: p90(samples.map((sample) => sample.durationMs)),
+        sampleCount: samples.length,
+        source: "learned",
+        taskId: input.taskId
+    });
+}
+function projectPriorPrediction(prediction, projectPrior) {
+    return Object.freeze({
+        ...prediction,
+        estimatedDurationMs: projectPrior,
+        source: "project-prior"
+    });
+}
+function coldStartPrediction(prediction, coldStartDurationMs) {
+    return Object.freeze({
+        ...prediction,
+        estimatedDurationMs: coldStartDurationMs,
+        source: "cold-start"
+    });
+}
+function freezePrediction(prediction) {
+    return Object.freeze({ ...prediction });
+}
+function digestCanonicalValue(value) {
+    return `sha256:${createHash("sha256").update(canonicalJsonBytes(value)).digest("hex")}`;
+}
+function arithmeticMean(values) {
+    return values.reduce((total, value) => total + value, 0) / values.length;
+}
+/** The p90 is the nearest-rank element from an ascending finite duration window. */
+function p90(values) {
+    const ordered = [...values].sort((left, right) => left - right);
+    const index = Math.ceil(ordered.length * 0.9) - 1;
+    return ordered[index] ?? 0;
+}
+function median(values) {
+    if (values.length === 0)
+        return undefined;
+    const ordered = [...values].sort((left, right) => left - right);
+    const middle = Math.floor(ordered.length / 2);
+    const upper = ordered[middle];
+    if (upper === undefined)
+        return undefined;
+    if (ordered.length % 2 === 1)
+        return upper;
+    const lower = ordered[middle - 1];
+    return lower === undefined ? undefined : (lower + upper) / 2;
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=prediction.mjs.map

package/dist/esm/learned-critical-path/duration-model/prediction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction.mjs","sourceRoot":"","sources":["../../../../src/learned-critical-path/duration-model/prediction.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { canonicalJsonBytes, type CanonicalJsonValue } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  SCHEDULER_HISTORY_MODEL_VERSION,\n  schedulerHistorySeries,\n  type SchedulerHistoryModel\n} from \"./bounded-history.ts\";\n\nexport type SchedulerPredictionSource = \"learned\" | \"project-prior\" | \"cold-start\";\n\nexport interface SchedulerPredictionInput {\n  readonly authoredOptions: CanonicalJsonValue;\n  readonly checkId: string;\n  readonly flags: CanonicalJsonValue;\n  readonly taskId: string;\n}\n\nexport interface SchedulerTaskPrediction {\n  readonly estimatedDurationMs: number;\n  readonly identityDigest: string;\n  readonly meanDurationMs: number | null;\n  readonly p90DurationMs: number | null;\n  readonly sampleCount: number;\n  readonly source: SchedulerPredictionSource;\n  readonly taskId: string;\n}\n\n/** Frozen before Scheduler admission; it does not retain authored options or flag values. */\nexport interface SchedulerPredictionSnapshot {\n  readonly digest: string;\n  readonly modelVersion: string;\n  readonly predictions: readonly SchedulerTaskPrediction[];\n}\n\nexport function createSchedulerHistoryIdentity(input: {\n  readonly authoredOptions: CanonicalJsonValue;\n  readonly checkId: string;\n  readonly flags: CanonicalJsonValue;\n}): string {\n  const authoredOptionsDigest = digestCanonicalValue(input.authoredOptions);\n  const flagsDigest = digestCanonicalValue(input.flags);\n  return digestCanonicalValue({\n    authoredOptionsDigest,\n    checkId: input.checkId,\n    flagsDigest,\n    modelVersion: SCHEDULER_HISTORY_MODEL_VERSION\n  });\n}\n\n/** Forms learned means first, then one project median prior, without invoking preflight. */\nexport function createSchedulerPredictionSnapshot(\n  history: SchedulerHistoryModel,\n  inputs: readonly SchedulerPredictionInput[],\n  coldStartDurationMs = 1\n): SchedulerPredictionSnapshot {\n  const learned = inputs.map((input) => learnedPrediction(history, input));\n  const projectPrior = median(\n    learned.flatMap((prediction) =>\n      prediction.source === \"learned\" ? [prediction.estimatedDurationMs] : []\n    )\n  );\n  const predictions = learned.map((prediction) => {\n    if (prediction.source === \"learned\") return prediction;\n    if (projectPrior === undefined) return coldStartPrediction(prediction, coldStartDurationMs);\n    return projectPriorPrediction(prediction, projectPrior);\n  });\n  const digest = digestCanonicalValue({\n    modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,\n    predictions: [...predictions]\n      .sort((left, right) => compareText(left.taskId, right.taskId))\n      .map((prediction) => ({\n        estimatedDurationMs: prediction.estimatedDurationMs,\n        identityDigest: prediction.identityDigest,\n        meanDurationMs: prediction.meanDurationMs,\n        p90DurationMs: prediction.p90DurationMs,\n        sampleCount: prediction.sampleCount,\n        source: prediction.source,\n        taskId: prediction.taskId\n      }))\n  });\n  return Object.freeze({\n    digest,\n    modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,\n    predictions: Object.freeze(predictions.map(freezePrediction))\n  });\n}\n\nexport function predictionForTask(\n  snapshot: SchedulerPredictionSnapshot,\n  taskId: string\n): SchedulerTaskPrediction | undefined {\n  return snapshot.predictions.find((prediction) => prediction.taskId === taskId);\n}\n\nfunction learnedPrediction(\n  history: SchedulerHistoryModel,\n  input: SchedulerPredictionInput\n): SchedulerTaskPrediction {\n  const identityDigest = createSchedulerHistoryIdentity(input);\n  const samples = schedulerHistorySeries(history, identityDigest)?.samples ?? [];\n  if (samples.length === 0) {\n    return Object.freeze({\n      estimatedDurationMs: 0,\n      identityDigest,\n      meanDurationMs: null,\n      p90DurationMs: null,\n      sampleCount: 0,\n      source: \"cold-start\",\n      taskId: input.taskId\n    });\n  }\n  const meanDurationMs = arithmeticMean(samples.map((sample) => sample.durationMs));\n  return Object.freeze({\n    estimatedDurationMs: meanDurationMs,\n    identityDigest,\n    meanDurationMs,\n    p90DurationMs: p90(samples.map((sample) => sample.durationMs)),\n    sampleCount: samples.length,\n    source: \"learned\",\n    taskId: input.taskId\n  });\n}\n\nfunction projectPriorPrediction(\n  prediction: SchedulerTaskPrediction,\n  projectPrior: number\n): SchedulerTaskPrediction {\n  return Object.freeze({\n    ...prediction,\n    estimatedDurationMs: projectPrior,\n    source: \"project-prior\"\n  });\n}\n\nfunction coldStartPrediction(\n  prediction: SchedulerTaskPrediction,\n  coldStartDurationMs: number\n): SchedulerTaskPrediction {\n  return Object.freeze({\n    ...prediction,\n    estimatedDurationMs: coldStartDurationMs,\n    source: \"cold-start\"\n  });\n}\n\nfunction freezePrediction(prediction: SchedulerTaskPrediction): SchedulerTaskPrediction {\n  return Object.freeze({ ...prediction });\n}\n\nfunction digestCanonicalValue(value: CanonicalJsonValue): string {\n  return `sha256:${createHash(\"sha256\").update(canonicalJsonBytes(value)).digest(\"hex\")}`;\n}\n\nfunction arithmeticMean(values: readonly number[]): number {\n  return values.reduce((total, value) => total + value, 0) / values.length;\n}\n\n/** The p90 is the nearest-rank element from an ascending finite duration window. */\nfunction p90(values: readonly number[]): number {\n  const ordered = [...values].sort((left, right) => left - right);\n  const index = Math.ceil(ordered.length * 0.9) - 1;\n  return ordered[index] ?? 0;\n}\n\nfunction median(values: readonly number[]): number | undefined {\n  if (values.length === 0) return undefined;\n  const ordered = [...values].sort((left, right) => left - right);\n  const middle = Math.floor(ordered.length / 2);\n  const upper = ordered[middle];\n  if (upper === undefined) return undefined;\n  if (ordered.length % 2 === 1) return upper;\n  const lower = ordered[middle - 1];\n  return lower === undefined ? undefined : (lower + upper) / 2;\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"]}

package/dist/esm/learned-critical-path/duration-model/preparation.mjs

@@ -0,0 +1,41 @@
+import { recordSchedulerHistory } from "./recording.mjs";
+import { createSchedulerPredictionSnapshot } from "./prediction.mjs";
+import { loadSchedulerHistory, writeSchedulerHistory } from "./storage.mjs";
+/** Prepares one immutable duration prediction and its terminal record capability outside Scheduler. */
+export async function prepareSchedulerDurationModel(input) {
+    try {
+        const loaded = await loadSchedulerHistory(input.stateDirectory);
+        const prediction = createSchedulerPredictionSnapshot(loaded.history, input.predictionInputs, input.coldStartDurationMs);
+        return Object.freeze({
+            kind: "ready",
+            prediction,
+            readObservation: loaded.observation,
+            retainedSeriesCount: loaded.history.series.length,
+            record: async (terminalMeasurement) => {
+                try {
+                    const recorded = recordSchedulerHistory({
+                        history: loaded.history,
+                        prediction,
+                        rawMeasurement: terminalMeasurement.rawMeasurement,
+                        settledTasks: terminalMeasurement.execution.settledTasks,
+                        maxSamplesPerSeries: input.maxSamplesPerSeries,
+                        maxSeries: input.maxSeries
+                    });
+                    const writeObservation = await writeSchedulerHistory(input.stateDirectory, recorded.history);
+                    return Object.freeze({
+                        kind: "recorded",
+                        recording: recorded.observation,
+                        writeObservation
+                    });
+                }
+                catch {
+                    return Object.freeze({ kind: "failed" });
+                }
+            }
+        });
+    }
+    catch {
+        return Object.freeze({ kind: "static-fallback" });
+    }
+}
+//# sourceMappingURL=preparation.mjs.map

package/dist/esm/learned-critical-path/duration-model/preparation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.mjs","sourceRoot":"","sources":["../../../../src/learned-critical-path/duration-model/preparation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAA6C,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACL,iCAAiC,EAGlC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAsB3E,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,KAMnD;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,iCAAiC,CAClD,MAAM,CAAC,OAAO,EACd,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,mBAAmB,CAC1B,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,UAAU;YACV,eAAe,EAAE,MAAM,CAAC,WAAW;YACnC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM;YACjD,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE;gBACpC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,sBAAsB,CAAC;wBACtC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,UAAU;wBACV,cAAc,EAAE,mBAAmB,CAAC,cAAc;wBAClD,YAAY,EAAE,mBAAmB,CAAC,SAAS,CAAC,YAAY;wBACxD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;wBAC9C,SAAS,EAAE,KAAK,CAAC,SAAS;qBAC3B,CAAC,CAAC;oBACH,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAClD,KAAK,CAAC,cAAc,EACpB,QAAQ,CAAC,OAAO,CACjB,CAAC;oBACF,OAAO,MAAM,CAAC,MAAM,CAAC;wBACnB,IAAI,EAAE,UAAU;wBAChB,SAAS,EAAE,QAAQ,CAAC,WAAW;wBAC/B,gBAAgB;qBACjB,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC","sourcesContent":["import type { SchedulerMeasurementContext } from \"../../project-definition/project-definition.ts\";\nimport { recordSchedulerHistory, type SchedulerHistoryRecordingObservation } from \"./recording.ts\";\nimport {\n  createSchedulerPredictionSnapshot,\n  type SchedulerPredictionInput,\n  type SchedulerPredictionSnapshot\n} from \"./prediction.ts\";\nimport { loadSchedulerHistory, writeSchedulerHistory } from \"./storage.ts\";\n\nexport type SchedulerDurationModelPreparation =\n  | Readonly<{\n      readonly kind: \"ready\";\n      readonly prediction: SchedulerPredictionSnapshot;\n      readonly readObservation: Awaited<ReturnType<typeof loadSchedulerHistory>>[\"observation\"];\n      readonly retainedSeriesCount: number;\n      readonly record: (\n        terminalMeasurement: SchedulerMeasurementContext\n      ) => Promise<SchedulerDurationModelRecordObservation>;\n    }>\n  | Readonly<{ readonly kind: \"static-fallback\" }>;\n\nexport type SchedulerDurationModelRecordObservation =\n  | Readonly<{\n      readonly kind: \"recorded\";\n      readonly recording: SchedulerHistoryRecordingObservation;\n      readonly writeObservation: Awaited<ReturnType<typeof writeSchedulerHistory>>;\n    }>\n  | Readonly<{ readonly kind: \"failed\" }>;\n\n/** Prepares one immutable duration prediction and its terminal record capability outside Scheduler. */\nexport async function prepareSchedulerDurationModel(input: {\n  readonly predictionInputs: readonly SchedulerPredictionInput[];\n  readonly stateDirectory: string;\n  readonly coldStartDurationMs?: number;\n  readonly maxSamplesPerSeries?: number;\n  readonly maxSeries?: number;\n}): Promise<SchedulerDurationModelPreparation> {\n  try {\n    const loaded = await loadSchedulerHistory(input.stateDirectory);\n    const prediction = createSchedulerPredictionSnapshot(\n      loaded.history,\n      input.predictionInputs,\n      input.coldStartDurationMs\n    );\n    return Object.freeze({\n      kind: \"ready\",\n      prediction,\n      readObservation: loaded.observation,\n      retainedSeriesCount: loaded.history.series.length,\n      record: async (terminalMeasurement) => {\n        try {\n          const recorded = recordSchedulerHistory({\n            history: loaded.history,\n            prediction,\n            rawMeasurement: terminalMeasurement.rawMeasurement,\n            settledTasks: terminalMeasurement.execution.settledTasks,\n            maxSamplesPerSeries: input.maxSamplesPerSeries,\n            maxSeries: input.maxSeries\n          });\n          const writeObservation = await writeSchedulerHistory(\n            input.stateDirectory,\n            recorded.history\n          );\n          return Object.freeze({\n            kind: \"recorded\",\n            recording: recorded.observation,\n            writeObservation\n          });\n        } catch {\n          return Object.freeze({ kind: \"failed\" });\n        }\n      }\n    });\n  } catch {\n    return Object.freeze({ kind: \"static-fallback\" });\n  }\n}\n"]}

package/dist/esm/learned-critical-path/duration-model/recording.mjs

@@ -0,0 +1,109 @@
+import { freezeSchedulerHistoryModel, isBoundedDurationMs, MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES, MAX_SCHEDULER_HISTORY_SERIES } from "./bounded-history.mjs";
+import { predictionForTask } from "./prediction.mjs";
+/** Merges only trusted terminal Scheduler occupancy intervals; unavailable timing creates no samples. */
+export function recordSchedulerHistory(input) {
+    const rawMeasurement = input.rawMeasurement;
+    const timingFacts = rawMeasurement.timingFacts;
+    if (rawMeasurement.timing.availability !== "available" || timingFacts === undefined) {
+        return Object.freeze({
+            history: input.history,
+            observation: Object.freeze({
+                acceptedSampleCount: 0,
+                retainedSeriesCount: input.history.series.length,
+                status: "timing-unavailable"
+            })
+        });
+    }
+    return recordedHistory(input, timingFacts.admissions);
+}
+function recordedHistory(input, admissions) {
+    const merged = mergeVerifiedAdmissionSamples({
+        admissions,
+        history: input.history,
+        prediction: input.prediction,
+        settledByTaskId: new Map(input.settledTasks.map((settled) => [settled.taskId, settled.kind])),
+        maxSamplesPerSeries: input.maxSamplesPerSeries ?? MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES
+    });
+    const retained = retainRecentSeries(merged.seriesByIdentity.values(), input.maxSeries ?? MAX_SCHEDULER_HISTORY_SERIES);
+    const history = freezeSchedulerHistoryModel({
+        latestObservationSequence: merged.latestObservationSequence,
+        series: retained
+    });
+    return Object.freeze({
+        history,
+        observation: Object.freeze({
+            acceptedSampleCount: merged.acceptedSampleCount,
+            retainedSeriesCount: history.series.length,
+            status: "recorded"
+        })
+    });
+}
+/** Applies valid admissions in Scheduler order and returns the updated identity histories. */
+function mergeVerifiedAdmissionSamples(input) {
+    const seriesByIdentity = new Map(input.history.series.map((series) => [series.identityDigest, series]));
+    let latestObservationSequence = input.history.latestObservationSequence;
+    let acceptedSampleCount = 0;
+    for (const admission of input.admissions) {
+        const sample = sampleForAdmission(admission, input.prediction, input.settledByTaskId);
+        if (sample === undefined || latestObservationSequence === Number.MAX_SAFE_INTEGER)
+            continue;
+        latestObservationSequence += 1;
+        appendSampleToIdentityHistory(seriesByIdentity, sample, latestObservationSequence, input.maxSamplesPerSeries);
+        acceptedSampleCount += 1;
+    }
+    return Object.freeze({ acceptedSampleCount, latestObservationSequence, seriesByIdentity });
+}
+function appendSampleToIdentityHistory(seriesByIdentity, sample, observationSequence, maxSamplesPerSeries) {
+    const existing = seriesByIdentity.get(sample.identityDigest);
+    const samples = [
+        ...(existing?.samples ?? []),
+        {
+            durationMs: sample.durationMs,
+            observationSequence,
+            settlementKind: sample.settlementKind
+        }
+    ].slice(-maxSamplesPerSeries);
+    seriesByIdentity.set(sample.identityDigest, Object.freeze({
+        identityDigest: sample.identityDigest,
+        latestObservationSequence: observationSequence,
+        samples: Object.freeze(samples)
+    }));
+}
+function sampleForAdmission(admission, prediction, settledByTaskId) {
+    if (admission.admittedAtMonotonicMs === null ||
+        admission.settledAtMonotonicMs === null ||
+        !isFiniteMonotonicTimestamp(admission.admittedAtMonotonicMs) ||
+        !isFiniteMonotonicTimestamp(admission.settledAtMonotonicMs) ||
+        admission.settledAtMonotonicMs < admission.admittedAtMonotonicMs) {
+        return undefined;
+    }
+    const durationMs = admission.settledAtMonotonicMs - admission.admittedAtMonotonicMs;
+    if (!isBoundedDurationMs(durationMs))
+        return undefined;
+    const taskPrediction = predictionForTask(prediction, admission.taskId);
+    const settlementKind = settledByTaskId.get(admission.taskId);
+    if (taskPrediction === undefined || settlementKind === undefined)
+        return undefined;
+    return Object.freeze({
+        durationMs,
+        identityDigest: taskPrediction.identityDigest,
+        settlementKind
+    });
+}
+function retainRecentSeries(series, maxSeries) {
+    return Object.freeze([...series]
+        .sort((left, right) => right.latestObservationSequence - left.latestObservationSequence ||
+        compareText(left.identityDigest, right.identityDigest))
+        .slice(0, maxSeries));
+}
+function isFiniteMonotonicTimestamp(value) {
+    return Number.isFinite(value) && value >= 0 && value <= Number.MAX_SAFE_INTEGER;
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=recording.mjs.map

package/dist/esm/learned-critical-path/duration-model/recording.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.mjs","sourceRoot":"","sources":["../../../../src/learned-critical-path/duration-model/recording.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  SchedulerMeasurementAdmission,\n  SchedulerRawMeasurement\n} from \"../../project-definition/project-definition.ts\";\nimport {\n  freezeSchedulerHistoryModel,\n  isBoundedDurationMs,\n  MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES,\n  MAX_SCHEDULER_HISTORY_SERIES,\n  type SchedulerDurationSettlementKind,\n  type SchedulerHistoryModel,\n  type SchedulerHistorySeries\n} from \"./bounded-history.ts\";\nimport { predictionForTask, type SchedulerPredictionSnapshot } from \"./prediction.ts\";\n\nexport type SchedulerHistoryRecordingObservation =\n  | Readonly<{\n      readonly acceptedSampleCount: number;\n      readonly retainedSeriesCount: number;\n      readonly status: \"recorded\";\n    }>\n  | Readonly<{\n      readonly acceptedSampleCount: 0;\n      readonly retainedSeriesCount: number;\n      readonly status: \"timing-unavailable\";\n    }>;\n\nexport interface SchedulerHistoryRecording {\n  readonly history: SchedulerHistoryModel;\n  readonly observation: SchedulerHistoryRecordingObservation;\n}\n\n/** Merges only trusted terminal Scheduler occupancy intervals; unavailable timing creates no samples. */\nexport function recordSchedulerHistory(input: {\n  readonly history: SchedulerHistoryModel;\n  readonly prediction: SchedulerPredictionSnapshot;\n  readonly rawMeasurement: SchedulerRawMeasurement;\n  readonly settledTasks: readonly Readonly<{\n    readonly kind: SchedulerDurationSettlementKind;\n    readonly taskId: string;\n  }>[];\n  readonly maxSamplesPerSeries?: number;\n  readonly maxSeries?: number;\n}): SchedulerHistoryRecording {\n  const rawMeasurement = input.rawMeasurement;\n  const timingFacts = rawMeasurement.timingFacts;\n  if (rawMeasurement.timing.availability !== \"available\" || timingFacts === undefined) {\n    return Object.freeze({\n      history: input.history,\n      observation: Object.freeze({\n        acceptedSampleCount: 0,\n        retainedSeriesCount: input.history.series.length,\n        status: \"timing-unavailable\"\n      })\n    });\n  }\n\n  return recordedHistory(input, timingFacts.admissions);\n}\n\nfunction recordedHistory(\n  input: Parameters<typeof recordSchedulerHistory>[0],\n  admissions: readonly SchedulerMeasurementAdmission[]\n): SchedulerHistoryRecording {\n  const merged = mergeVerifiedAdmissionSamples({\n    admissions,\n    history: input.history,\n    prediction: input.prediction,\n    settledByTaskId: new Map(input.settledTasks.map((settled) => [settled.taskId, settled.kind])),\n    maxSamplesPerSeries: input.maxSamplesPerSeries ?? MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES\n  });\n  const retained = retainRecentSeries(\n    merged.seriesByIdentity.values(),\n    input.maxSeries ?? MAX_SCHEDULER_HISTORY_SERIES\n  );\n  const history = freezeSchedulerHistoryModel({\n    latestObservationSequence: merged.latestObservationSequence,\n    series: retained\n  });\n  return Object.freeze({\n    history,\n    observation: Object.freeze({\n      acceptedSampleCount: merged.acceptedSampleCount,\n      retainedSeriesCount: history.series.length,\n      status: \"recorded\"\n    })\n  });\n}\n\ntype VerifiedAdmissionMerge = Readonly<{\n  readonly acceptedSampleCount: number;\n  readonly latestObservationSequence: number;\n  readonly seriesByIdentity: ReadonlyMap<string, SchedulerHistorySeries>;\n}>;\n\n/** Applies valid admissions in Scheduler order and returns the updated identity histories. */\nfunction mergeVerifiedAdmissionSamples(input: {\n  readonly admissions: readonly SchedulerMeasurementAdmission[];\n  readonly history: SchedulerHistoryModel;\n  readonly prediction: SchedulerPredictionSnapshot;\n  readonly settledByTaskId: ReadonlyMap<string, SchedulerDurationSettlementKind>;\n  readonly maxSamplesPerSeries: number;\n}): VerifiedAdmissionMerge {\n  const seriesByIdentity = new Map(\n    input.history.series.map((series) => [series.identityDigest, series] as const)\n  );\n  let latestObservationSequence = input.history.latestObservationSequence;\n  let acceptedSampleCount = 0;\n  for (const admission of input.admissions) {\n    const sample = sampleForAdmission(admission, input.prediction, input.settledByTaskId);\n    if (sample === undefined || latestObservationSequence === Number.MAX_SAFE_INTEGER) continue;\n    latestObservationSequence += 1;\n    appendSampleToIdentityHistory(\n      seriesByIdentity,\n      sample,\n      latestObservationSequence,\n      input.maxSamplesPerSeries\n    );\n    acceptedSampleCount += 1;\n  }\n  return Object.freeze({ acceptedSampleCount, latestObservationSequence, seriesByIdentity });\n}\n\nfunction appendSampleToIdentityHistory(\n  seriesByIdentity: Map<string, SchedulerHistorySeries>,\n  sample: AdmissionSample,\n  observationSequence: number,\n  maxSamplesPerSeries: number\n): void {\n  const existing = seriesByIdentity.get(sample.identityDigest);\n  const samples = [\n    ...(existing?.samples ?? []),\n    {\n      durationMs: sample.durationMs,\n      observationSequence,\n      settlementKind: sample.settlementKind\n    }\n  ].slice(-maxSamplesPerSeries);\n  seriesByIdentity.set(\n    sample.identityDigest,\n    Object.freeze({\n      identityDigest: sample.identityDigest,\n      latestObservationSequence: observationSequence,\n      samples: Object.freeze(samples)\n    })\n  );\n}\n\ntype AdmissionSample = Readonly<{\n  readonly durationMs: number;\n  readonly identityDigest: string;\n  readonly settlementKind: SchedulerDurationSettlementKind;\n}>;\n\nfunction sampleForAdmission(\n  admission: Readonly<{\n    readonly admittedAtMonotonicMs: number | null;\n    readonly settledAtMonotonicMs: number | null;\n    readonly taskId: string;\n  }>,\n  prediction: SchedulerPredictionSnapshot,\n  settledByTaskId: ReadonlyMap<string, SchedulerDurationSettlementKind>\n): AdmissionSample | undefined {\n  if (\n    admission.admittedAtMonotonicMs === null ||\n    admission.settledAtMonotonicMs === null ||\n    !isFiniteMonotonicTimestamp(admission.admittedAtMonotonicMs) ||\n    !isFiniteMonotonicTimestamp(admission.settledAtMonotonicMs) ||\n    admission.settledAtMonotonicMs < admission.admittedAtMonotonicMs\n  ) {\n    return undefined;\n  }\n  const durationMs = admission.settledAtMonotonicMs - admission.admittedAtMonotonicMs;\n  if (!isBoundedDurationMs(durationMs)) return undefined;\n  const taskPrediction = predictionForTask(prediction, admission.taskId);\n  const settlementKind = settledByTaskId.get(admission.taskId);\n  if (taskPrediction === undefined || settlementKind === undefined) return undefined;\n  return Object.freeze({\n    durationMs,\n    identityDigest: taskPrediction.identityDigest,\n    settlementKind\n  });\n}\n\nfunction retainRecentSeries(\n  series: Iterable<SchedulerHistorySeries>,\n  maxSeries: number\n): readonly SchedulerHistorySeries[] {\n  return Object.freeze(\n    [...series]\n      .sort(\n        (left, right) =>\n          right.latestObservationSequence - left.latestObservationSequence ||\n          compareText(left.identityDigest, right.identityDigest)\n      )\n      .slice(0, maxSeries)\n  );\n}\n\nfunction isFiniteMonotonicTimestamp(value: number): boolean {\n  return Number.isFinite(value) && value >= 0 && value <= Number.MAX_SAFE_INTEGER;\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"]}