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

@zxyycom/vibe-check 0.0.2 → 0.0.3

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

Files changed (670) hide show

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

@@ -0,0 +1 @@

+ {"version":3,"file":"prediction.mjs","sourceRoot":"","sources":["../../../../../src/package-tools/learned-critical-path/duration-model/prediction.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport {\n canonicalJsonBytes,\n type CanonicalJsonValue\n} 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 preparation. */\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 → package-tools/learned-critical-path}/duration-model/preparation.mjs RENAMED Viewed

@@ -18,8 +18,10 @@ export async function prepareSchedulerDurationModel(input) {
                         prediction,
                         rawMeasurement: terminalMeasurement.rawMeasurement,
                         settledTasks: terminalMeasurement.execution.settledTasks,
-                        maxSamplesPerSeries: input.maxSamplesPerSeries,
-                        maxSeries: input.maxSeries
+                        ...(input.maxSamplesPerSeries === undefined
+                            ? {}
+                            : { maxSamplesPerSeries: input.maxSamplesPerSeries }),
+                        ...(input.maxSeries === undefined ? {} : { maxSeries: input.maxSeries })
                     });
                     const writeObservation = await writeSchedulerHistory(input.stateDirectory, recorded.history);
                     return Object.freeze({

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

@@ -0,0 +1 @@

+ {"version":3,"file":"preparation.mjs","sourceRoot":"","sources":["../../../../../src/package-tools/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,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS;4BACzC,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC;wBACvD,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;qBACzE,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 ...(input.maxSamplesPerSeries === undefined\n ? {}\n : { maxSamplesPerSeries: input.maxSamplesPerSeries }),\n ...(input.maxSeries === undefined ? {} : { 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/package-tools/learned-critical-path/duration-model/recording.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"recording.mjs","sourceRoot":"","sources":["../../../../../src/package-tools/learned-critical-path/duration-model/recording.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SchedulerRawMeasurement } 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\ntype SchedulerMeasurementAdmission = NonNullable<\n SchedulerRawMeasurement[\"timingFacts\"]\n>[\"admissions\"][number];\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"]}

package/dist/esm/{learned-critical-path → package-tools/learned-critical-path}/duration-model/storage.mjs RENAMED Viewed

@@ -1,8 +1,8 @@
 import { promises as fs } from "node:fs";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import { canonicalJsonText } from "../../data-boundary/canonical-data.mjs";
-import { hasExactPlainRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { canonicalJsonText } from "../../../data-boundary/canonical-data.mjs";
+import { snapshotClosedArray, snapshotExactClosedRecord } from "../../../data-boundary/closed-values.mjs";
 import { emptySchedulerHistory, freezeSchedulerHistoryModel, isBoundedDurationMs, isObservationSequence, isSchedulerHistoryIdentityDigest, isSchedulerSettlementKind, MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES, MAX_SCHEDULER_HISTORY_SERIES, SCHEDULER_HISTORY_ENVELOPE_VERSION, SCHEDULER_HISTORY_FILE_NAME, SCHEDULER_HISTORY_MODEL_VERSION } from "./bounded-history.mjs";
 const ENVELOPE_KEYS = [
     "envelopeVersion",
@@ -81,8 +81,8 @@ function schedulerHistoryText(history) {
     });
 }
 function parseSchedulerHistoryEnvelope(value) {
-    const envelope = snapshotClosedRecord(value);
-    if (envelope === undefined || !hasExactPlainRecordKeys(envelope, ENVELOPE_KEYS)) {
+    const envelope = snapshotExactClosedRecord(value, ENVELOPE_KEYS);
+    if (envelope === undefined) {
         return Object.freeze({ kind: "invalid" });
     }
     if (typeof envelope.envelopeVersion !== "string" ||
@@ -125,8 +125,8 @@ function parseSeries(value) {
     return Object.freeze(parsed);
 }
 function parseSeriesEntry(value) {
-    const record = snapshotClosedRecord(value);
-    if (record === undefined || !hasExactPlainRecordKeys(record, SERIES_KEYS))
+    const record = snapshotExactClosedRecord(value, SERIES_KEYS);
+    if (record === undefined)
         return undefined;
     if (!isSchedulerHistoryIdentityDigest(record.identityDigest) ||
         !isObservationSequence(record.latestObservationSequence)) {
@@ -162,8 +162,8 @@ function parseSamples(value) {
     return Object.freeze(samples);
 }
 function parseSample(value) {
-    const record = snapshotClosedRecord(value);
-    if (record === undefined || !hasExactPlainRecordKeys(record, SAMPLE_KEYS))
+    const record = snapshotExactClosedRecord(value, SAMPLE_KEYS);
+    if (record === undefined)
         return undefined;
     if (!isBoundedDurationMs(record.durationMs) ||
         !isPositiveObservationSequence(record.observationSequence) ||

package/dist/esm/package-tools/learned-critical-path/duration-model/storage.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"storage.mjs","sourceRoot":"","sources":["../../../../../src/package-tools/learned-critical-path/duration-model/storage.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\n\nimport { canonicalJsonText } from \"../../../data-boundary/canonical-data.ts\";\nimport {\n snapshotClosedArray,\n snapshotExactClosedRecord\n} from \"../../../data-boundary/closed-values.ts\";\nimport {\n emptySchedulerHistory,\n freezeSchedulerHistoryModel,\n isBoundedDurationMs,\n isObservationSequence,\n isSchedulerHistoryIdentityDigest,\n isSchedulerSettlementKind,\n MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES,\n MAX_SCHEDULER_HISTORY_SERIES,\n SCHEDULER_HISTORY_ENVELOPE_VERSION,\n SCHEDULER_HISTORY_FILE_NAME,\n SCHEDULER_HISTORY_MODEL_VERSION,\n type SchedulerHistoryModel,\n type SchedulerHistorySample,\n type SchedulerHistorySeries\n} from \"./bounded-history.ts\";\n\nconst ENVELOPE_KEYS = [\n \"envelopeVersion\",\n \"latestObservationSequence\",\n \"modelVersion\",\n \"series\"\n] as const;\nconst SERIES_KEYS = [\"identityDigest\", \"latestObservationSequence\", \"samples\"] as const;\nconst SAMPLE_KEYS = [\"durationMs\", \"observationSequence\", \"settlementKind\"] as const;\n\nexport type SchedulerHistoryReadObservation =\n | \"loaded\"\n | \"missing\"\n | \"invalid\"\n | \"incompatible\"\n | \"failed\";\n\nexport type SchedulerHistoryWriteObservation = \"stored\" | \"failed\";\n\nexport interface SchedulerHistoryLoad {\n readonly history: SchedulerHistoryModel;\n readonly observation: SchedulerHistoryReadObservation;\n}\n\n/** Reads untrusted local state and always degrades to an empty model on an I/O or format fault. */\nexport async function loadSchedulerHistory(stateDirectory: string): Promise<SchedulerHistoryLoad> {\n let source: string;\n try {\n source = await fs.readFile(schedulerHistoryPath(stateDirectory), \"utf8\");\n } catch (error: unknown) {\n return Object.freeze({\n history: emptySchedulerHistory(),\n observation: isMissingPath(error) ? \"missing\" : \"failed\"\n });\n }\n\n try {\n const parsed = parseSchedulerHistoryEnvelope(JSON.parse(source));\n if (parsed.kind === \"incompatible\") {\n return Object.freeze({ history: emptySchedulerHistory(), observation: \"incompatible\" });\n }\n if (parsed.kind === \"invalid\") {\n return Object.freeze({ history: emptySchedulerHistory(), observation: \"invalid\" });\n }\n return Object.freeze({ history: parsed.history, observation: \"loaded\" });\n } catch {\n return Object.freeze({ history: emptySchedulerHistory(), observation: \"invalid\" });\n }\n}\n\n/** Publishes a full closed model through a same-directory temporary file and atomic replacement. */\nexport async function writeSchedulerHistory(\n stateDirectory: string,\n history: SchedulerHistoryModel\n): Promise<SchedulerHistoryWriteObservation> {\n let temporaryPath: string | undefined;\n try {\n const targetPath = schedulerHistoryPath(stateDirectory);\n temporaryPath = join(stateDirectory, `.vibe-check-scheduler-history-${randomUUID()}.tmp`);\n await fs.mkdir(stateDirectory, { recursive: true });\n await fs.writeFile(temporaryPath, schedulerHistoryText(history), {\n encoding: \"utf8\",\n flag: \"wx\"\n });\n await fs.rename(temporaryPath, targetPath);\n return \"stored\";\n } catch {\n return \"failed\";\n } finally {\n if (temporaryPath !== undefined) {\n await fs.rm(temporaryPath, { force: true }).catch(() => undefined);\n }\n }\n}\n\nexport function schedulerHistoryPath(stateDirectory: string): string {\n return join(stateDirectory, SCHEDULER_HISTORY_FILE_NAME);\n}\n\nfunction schedulerHistoryText(history: SchedulerHistoryModel): string {\n return canonicalJsonText({\n envelopeVersion: SCHEDULER_HISTORY_ENVELOPE_VERSION,\n latestObservationSequence: history.latestObservationSequence,\n modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,\n series: history.series.map((series) => ({\n identityDigest: series.identityDigest,\n latestObservationSequence: series.latestObservationSequence,\n samples: series.samples.map((sample) => ({\n durationMs: sample.durationMs,\n observationSequence: sample.observationSequence,\n settlementKind: sample.settlementKind\n }))\n }))\n });\n}\n\ntype ParsedEnvelope =\n | Readonly<{ readonly kind: \"loaded\"; readonly history: SchedulerHistoryModel }>\n | Readonly<{ readonly kind: \"invalid\" }>\n | Readonly<{ readonly kind: \"incompatible\" }>;\n\nfunction parseSchedulerHistoryEnvelope(value: unknown): ParsedEnvelope {\n const envelope = snapshotExactClosedRecord(value, ENVELOPE_KEYS);\n if (envelope === undefined) {\n return Object.freeze({ kind: \"invalid\" });\n }\n if (\n typeof envelope.envelopeVersion !== \"string\" ||\n typeof envelope.modelVersion !== \"string\" ||\n !isObservationSequence(envelope.latestObservationSequence)\n ) {\n return Object.freeze({ kind: \"invalid\" });\n }\n if (\n envelope.envelopeVersion !== SCHEDULER_HISTORY_ENVELOPE_VERSION ||\n envelope.modelVersion !== SCHEDULER_HISTORY_MODEL_VERSION\n ) {\n return Object.freeze({ kind: \"incompatible\" });\n }\n\n const series = parseSeries(envelope.series);\n if (series === undefined) return Object.freeze({ kind: \"invalid\" });\n const greatestSequence = series.reduce(\n (greatest, entry) => Math.max(greatest, entry.latestObservationSequence),\n 0\n );\n if (envelope.latestObservationSequence !== greatestSequence) {\n return Object.freeze({ kind: \"invalid\" });\n }\n\n return Object.freeze({\n kind: \"loaded\",\n history: freezeSchedulerHistoryModel({\n latestObservationSequence: envelope.latestObservationSequence,\n series\n })\n });\n}\n\nfunction parseSeries(value: unknown): readonly SchedulerHistorySeries[] | undefined {\n const entries = snapshotClosedArray(value);\n if (entries === undefined || entries.length > MAX_SCHEDULER_HISTORY_SERIES) return undefined;\n\n const identities = new Set<string>();\n const parsed: SchedulerHistorySeries[] = [];\n for (const entry of entries) {\n const series = parseSeriesEntry(entry);\n if (series === undefined || identities.has(series.identityDigest)) return undefined;\n identities.add(series.identityDigest);\n parsed.push(series);\n }\n return Object.freeze(parsed);\n}\n\nfunction parseSeriesEntry(value: unknown): SchedulerHistorySeries | undefined {\n const record = snapshotExactClosedRecord(value, SERIES_KEYS);\n if (record === undefined) return undefined;\n if (\n !isSchedulerHistoryIdentityDigest(record.identityDigest) ||\n !isObservationSequence(record.latestObservationSequence)\n ) {\n return undefined;\n }\n const samples = parseSamples(record.samples);\n if (\n samples === undefined ||\n samples.at(-1)?.observationSequence !== record.latestObservationSequence\n ) {\n return undefined;\n }\n return Object.freeze({\n identityDigest: record.identityDigest,\n latestObservationSequence: record.latestObservationSequence,\n samples\n });\n}\n\nfunction parseSamples(value: unknown): readonly SchedulerHistorySample[] | undefined {\n const entries = snapshotClosedArray(value);\n if (\n entries === undefined ||\n entries.length === 0 ||\n entries.length > MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES\n ) {\n return undefined;\n }\n\n const samples: SchedulerHistorySample[] = [];\n let priorSequence = -1;\n for (const entry of entries) {\n const sample = parseSample(entry);\n if (sample === undefined || sample.observationSequence <= priorSequence) return undefined;\n priorSequence = sample.observationSequence;\n samples.push(sample);\n }\n return Object.freeze(samples);\n}\n\nfunction parseSample(value: unknown): SchedulerHistorySample | undefined {\n const record = snapshotExactClosedRecord(value, SAMPLE_KEYS);\n if (record === undefined) return undefined;\n if (\n !isBoundedDurationMs(record.durationMs) ||\n !isPositiveObservationSequence(record.observationSequence) ||\n !isSchedulerSettlementKind(record.settlementKind)\n ) {\n return undefined;\n }\n return Object.freeze({\n durationMs: record.durationMs,\n observationSequence: record.observationSequence,\n settlementKind: record.settlementKind\n });\n}\n\nfunction isMissingPath(error: unknown): boolean {\n return (\n typeof error === \"object\" &&\n error !== null &&\n (error as { readonly code?: unknown }).code === \"ENOENT\"\n );\n}\n\nfunction isPositiveObservationSequence(value: unknown): value is number {\n return isObservationSequence(value) && value > 0;\n}\n"]}

package/dist/esm/{learned-critical-path → package-tools/learned-critical-path}/selection-layers.mjs RENAMED Viewed

@@ -12,8 +12,7 @@ export function learnedSelectionLayers(context) {
 }
 function isTightening(candidate, taskById, scopeById, activeScopeIds, maxParallel) {
     const scope = scopeForCandidate(candidate, taskById, scopeById);
-    return (scope !== undefined &&
-        scope.activationTaskIds.includes(candidate.taskId) &&
+    return (scope?.activationTaskIds.includes(candidate.taskId) === true &&
         !activeScopeIds.has(scope.id) &&
         scope.maxParallel < maxParallel);
 }

package/dist/esm/package-tools/learned-critical-path/selection-layers.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"selection-layers.mjs","sourceRoot":"","sources":["../../../../src/package-tools/learned-critical-path/selection-layers.ts"],"names":[],"mappings":"AAgBA,0GAA0G;AAC1G,MAAM,UAAU,sBAAsB,CAAC,OAA+B;IACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;IAC1F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC;IAC3F,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC,MAAM,CACzB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACtC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC7F,CACF;QACD,SAAS;QACT,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,MAAM,CACvB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACtC,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC3F,CACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,SAAoB,EACpB,QAAmC,EACnC,SAAqC,EACrC,cAAmC,EACnC,WAAmB;IAEnB,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChE,OAAO,CACL,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI;QAC5D,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,WAAW,GAAG,WAAW,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,SAAoB,EACpB,QAAmC,EACnC,SAAqC,EACrC,cAAmC,EACnC,WAAmB;IAEnB,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChE,OAAO,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAoB,EACpB,QAAmC,EACnC,SAAqC;IAErC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChG,CAAC","sourcesContent":["import type {\n AdmissionPolicyContext,\n SchedulerGraphSnapshot\n} from \"../../project-definition/project-definition.ts\";\n\ntype Candidate = AdmissionPolicyContext[\"candidates\"][number];\ntype Task = SchedulerGraphSnapshot[\"tasks\"][number];\ntype Scope = SchedulerGraphSnapshot[\"scopes\"][number];\n\nexport interface LearnedSelectionLayers {\n readonly continuation: readonly Candidate[];\n readonly scopeById: ReadonlyMap<string, Scope>;\n readonly taskById: ReadonlyMap<string, Task>;\n readonly tightening: readonly Candidate[];\n}\n\n/** Projects the public graph and boundary facts into the Scheduler's two constrained selection layers. */\nexport function learnedSelectionLayers(context: AdmissionPolicyContext): LearnedSelectionLayers {\n const taskById = new Map(context.graph.tasks.map((task) => [task.taskId, task] as const));\n const scopeById = new Map(context.graph.scopes.map((scope) => [scope.id, scope] as const));\n const activeScopeIds = new Set(context.activeScopeIds);\n return Object.freeze({\n continuation: Object.freeze(\n context.candidates.filter((candidate) =>\n isContinuation(candidate, taskById, scopeById, activeScopeIds, context.capacity.maxParallel)\n )\n ),\n scopeById,\n taskById,\n tightening: Object.freeze(\n context.candidates.filter((candidate) =>\n isTightening(candidate, taskById, scopeById, activeScopeIds, context.capacity.maxParallel)\n )\n )\n });\n}\n\nfunction isTightening(\n candidate: Candidate,\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>,\n activeScopeIds: ReadonlySet<string>,\n maxParallel: number\n): boolean {\n const scope = scopeForCandidate(candidate, taskById, scopeById);\n return (\n scope?.activationTaskIds.includes(candidate.taskId) === true &&\n !activeScopeIds.has(scope.id) &&\n scope.maxParallel < maxParallel\n );\n}\n\nfunction isContinuation(\n candidate: Candidate,\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>,\n activeScopeIds: ReadonlySet<string>,\n maxParallel: number\n): boolean {\n const scope = scopeForCandidate(candidate, taskById, scopeById);\n return scope !== undefined && activeScopeIds.has(scope.id) && scope.maxParallel < maxParallel;\n}\n\nexport function scopeForCandidate(\n candidate: Candidate,\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>\n): Scope | undefined {\n const task = taskById.get(candidate.taskId);\n return task?.scopeId === null || task === undefined ? undefined : scopeById.get(task.scopeId);\n}\n"]}

package/dist/esm/package-tools/learned-critical-path/static-decision.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"static-decision.mjs","sourceRoot":"","sources":["../../../../src/package-tools/learned-critical-path/static-decision.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n AdmissionPolicyContext,\n AdmissionProposal,\n SchedulerGraphSnapshot\n} from \"../../project-definition/project-definition.ts\";\nimport { learnedSelectionLayers, scopeForCandidate } from \"./selection-layers.ts\";\n\ntype Candidate = AdmissionPolicyContext[\"candidates\"][number];\ntype Task = SchedulerGraphSnapshot[\"tasks\"][number];\ntype Scope = SchedulerGraphSnapshot[\"scopes\"][number];\n\n/** Preserves ordinary static selection when learned preparation cannot form a ranking. */\nexport function staticDecision(context: AdmissionPolicyContext): AdmissionProposal {\n const layers = learnedSelectionLayers(context);\n const selected = selectStaticCandidate(\n context.candidates,\n layers.continuation,\n layers.scopeById,\n layers.taskById,\n layers.tightening\n );\n return selected === undefined || !selected.canAdmit\n ? Object.freeze({ kind: \"wait\" })\n : Object.freeze({ kind: \"select\", taskId: selected.taskId });\n}\n\nfunction selectStaticCandidate(\n candidates: readonly Candidate[],\n continuation: readonly Candidate[],\n scopeById: ReadonlyMap<string, Scope>,\n taskById: ReadonlyMap<string, Task>,\n tightening: readonly Candidate[]\n): Candidate | undefined {\n if (tightening.length > 0) return first(sortConstrained(tightening, taskById, scopeById));\n if (continuation.length > 0) return first(sortConstrained(continuation, taskById, scopeById));\n return selectOrdinary(candidates, taskById);\n}\n\nfunction selectOrdinary(\n candidates: readonly Candidate[],\n taskById: ReadonlyMap<string, Task>\n): Candidate | undefined {\n const admissible = candidates.filter((candidate) => candidate.canAdmit);\n return [...(admissible.length === 0 ? candidates : admissible)].sort(\n (left, right) =>\n priorityDifference(left, right, taskById) || compareText(left.taskId, right.taskId)\n )[0];\n}\n\nfunction sortConstrained(\n candidates: readonly Candidate[],\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>\n): Candidate[] {\n return [...candidates].sort((left, right) =>\n constrainedComparison(left, right, taskById, scopeById)\n );\n}\n\nfunction constrainedComparison(\n left: Candidate,\n right: Candidate,\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>\n): number {\n const leftScope = requiredScope(left, taskById, scopeById);\n const rightScope = requiredScope(right, taskById, scopeById);\n return (\n leftScope.maxParallel - rightScope.maxParallel ||\n priorityDifference(left, right, taskById) ||\n compareText(leftScope.id, rightScope.id) ||\n compareText(left.taskId, right.taskId)\n );\n}\n\nfunction requiredScope(\n candidate: Candidate,\n taskById: ReadonlyMap<string, Task>,\n scopeById: ReadonlyMap<string, Scope>\n): Scope {\n const scope = scopeForCandidate(candidate, taskById, scopeById);\n if (scope === undefined) throw new Error(\"constrained task is missing a scope\");\n return scope;\n}\n\nfunction priorityDifference(\n left: Candidate,\n right: Candidate,\n taskById: ReadonlyMap<string, Task>\n): number {\n return (\n (taskById.get(right.taskId)?.admissionPriority ?? 0) -\n (taskById.get(left.taskId)?.admissionPriority ?? 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}\nfunction first<T>(values: readonly T[]): T {\n const value = values[0];\n if (value === undefined) throw new Error(\"static strategy requires a candidate\");\n return value;\n}\n"]}

package/dist/esm/{learned-critical-path → package-tools/learned-critical-path}/strategy.mjs RENAMED Viewed

@@ -1,10 +1,10 @@
 import { isAbsolute } from "node:path";
-import { canonicalizeJsonValue } from "../data-boundary/canonical-data.mjs";
+import { canonicalizeJsonValue } from "../../data-boundary/canonical-data.mjs";
 import { prepareSchedulerDurationModel } from "./duration-model/preparation.mjs";
 import { learnedSelectionLayers } from "./selection-layers.mjs";
 import { staticDecision } from "./static-decision.mjs";
 import { predictionForTask } from "./duration-model/prediction.mjs";
-import { createSchedulerCriticalPathSnapshot, criticalPathScoreForTask } from "../project-run/task-scheduler/critical-path-ranking.mjs";
+import { createSchedulerCriticalPathSnapshot, criticalPathScoreForTask } from "./critical-path-ranking.mjs";
 /**
  * 构造普通公开 prepared strategy。调用方拥有 history location 与 identity projection；
  * Product 只按同一 custom strategy lifecycle 调用它，不为该 helper 增加特权。
@@ -43,7 +43,7 @@ export function createLearnedCriticalPathStrategy(options) {
             }
             return Object.freeze({
                 decide: (context) => learnedDecision(context, durationModel.prediction, criticalPath, options),
-                complete: async (context) => {
+                terminalEffect: async (context) => {
                     const recorded = await durationModel.record(context);
                     if (recorded.kind === "failed" || recorded.writeObservation === "failed") {
                         observe(options, { kind: "recording-unavailable" });

package/dist/esm/package-tools/learned-critical-path/strategy.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"strategy.mjs","sourceRoot":"","sources":["../../../../src/package-tools/learned-critical-path/strategy.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute } from \"node:path\";\n\nimport {\n canonicalizeJsonValue,\n type CanonicalJsonValue\n} from \"../../data-boundary/canonical-data.ts\";\nimport type {\n AdmissionPolicyContext,\n AdmissionProposal,\n CustomAdmissionStrategy,\n SchedulerGraphSnapshot,\n SchedulerMeasurementContext\n} from \"../../project-definition/project-definition.ts\";\nimport { prepareSchedulerDurationModel } from \"./duration-model/preparation.ts\";\nimport { learnedSelectionLayers } from \"./selection-layers.ts\";\nimport { staticDecision } from \"./static-decision.ts\";\nimport {\n predictionForTask,\n type SchedulerPredictionInput,\n type SchedulerPredictionSnapshot\n} from \"./duration-model/prediction.ts\";\nimport {\n createSchedulerCriticalPathSnapshot,\n criticalPathScoreForTask,\n type SchedulerCriticalPathSnapshot\n} from \"./critical-path-ranking.ts\";\n\n/** 公开 learned critical-path prepared strategy 的调用方配置。 */\nexport interface LearnedCriticalPathStrategyOptions {\n /** 调用方拥有的可丢弃 learned duration history 本地目录；必须是绝对路径。 */\n readonly stateDirectory: string;\n /** 为每个公开 Task 提供 canonical-JSON-compatible 的调用方 identity projection。 */\n readonly identityForTask: (task: SchedulerGraphSnapshot[\"tasks\"][number]) => unknown;\n /** 单个 identity 最多保留的样本数；默认 32。 */\n readonly sampleWindow?: number;\n /** 最多保留的 identity 数；默认 4096。 */\n readonly maxHistorySeries?: number;\n /** 正的 cold-start duration 权重（毫秒）；默认 1。 */\n readonly coldStartDurationMs?: number;\n /** 可选调用方 observation sink；observer fault 不改变 scheduling 或 Run facts。 */\n readonly observe?: (event: LearnedCriticalPathObservation) => void | Promise<void>;\n}\n\n/** 调用方可选 observer 收到的有界 learned strategy 事件；selection-proposed 不表示 Scheduler 已接受 admission。 */\nexport type LearnedCriticalPathObservation =\n | Readonly<{\n readonly kind: \"history-unavailable\";\n readonly reason: \"identity-invalid\" | \"setup-failed\";\n }>\n | Readonly<{\n readonly kind: \"selection-proposed\";\n readonly taskId: string;\n readonly estimatedDurationMs: number;\n readonly criticalPathScore: number;\n readonly sampleCount: number;\n readonly source: \"learned\" | \"project-prior\" | \"cold-start\";\n }>\n | Readonly<{ readonly kind: \"recording-unavailable\" }>;\n\n/**\n * 构造普通公开 prepared strategy。调用方拥有 history location 与 identity projection；\n * Product 只按同一 custom strategy lifecycle 调用它，不为该 helper 增加特权。\n */\nexport function createLearnedCriticalPathStrategy(\n options: LearnedCriticalPathStrategyOptions\n): CustomAdmissionStrategy {\n if (typeof options.stateDirectory !== \"string\" || !isAbsolute(options.stateDirectory)) {\n throw new TypeError(\"learned critical-path stateDirectory must be an absolute path\");\n }\n const model = modelOptions(options);\n return Object.freeze({\n kind: \"prepared\" as const,\n prepare: async ({ graph }) => {\n const predictionInputs = predictionInputsFor(graph, options.identityForTask, model);\n if (predictionInputs === undefined) {\n observe(options, { kind: \"history-unavailable\", reason: \"identity-invalid\" });\n return Object.freeze({ decide: staticDecision });\n }\n const durationModel = await prepareSchedulerDurationModel({\n predictionInputs,\n stateDirectory: options.stateDirectory,\n coldStartDurationMs: model.coldStartDurationMs,\n maxSamplesPerSeries: model.sampleWindow,\n maxSeries: model.maxHistorySeries\n });\n if (durationModel.kind === \"static-fallback\") {\n observe(options, { kind: \"history-unavailable\", reason: \"setup-failed\" });\n return Object.freeze({ decide: staticDecision });\n }\n let criticalPath: SchedulerCriticalPathSnapshot;\n try {\n criticalPath = createSchedulerCriticalPathSnapshot(graph, durationModel.prediction);\n } catch {\n observe(options, { kind: \"history-unavailable\", reason: \"setup-failed\" });\n return Object.freeze({ decide: staticDecision });\n }\n return Object.freeze({\n decide: (context: AdmissionPolicyContext) =>\n learnedDecision(context, durationModel.prediction, criticalPath, options),\n terminalEffect: async (context: SchedulerMeasurementContext) => {\n const recorded = await durationModel.record(context);\n if (recorded.kind === \"failed\" || recorded.writeObservation === \"failed\") {\n observe(options, { kind: \"recording-unavailable\" });\n }\n }\n });\n }\n });\n}\n\nfunction modelOptions(options: LearnedCriticalPathStrategyOptions): Readonly<{\n readonly coldStartDurationMs: number;\n readonly maxHistorySeries: number;\n readonly sampleWindow: number;\n}> {\n const coldStartDurationMs = options.coldStartDurationMs ?? 1;\n const maxHistorySeries = options.maxHistorySeries ?? 4_096;\n const sampleWindow = options.sampleWindow ?? 32;\n validatePositiveFinite(coldStartDurationMs, \"coldStartDurationMs\");\n validateBoundedInteger(maxHistorySeries, \"maxHistorySeries\", 4_096);\n validateBoundedInteger(sampleWindow, \"sampleWindow\", 32);\n return Object.freeze({ coldStartDurationMs, maxHistorySeries, sampleWindow });\n}\n\nfunction validatePositiveFinite(value: number, name: string): void {\n if (!Number.isFinite(value) || value <= 0)\n throw new TypeError(`learned critical-path ${name} must be positive and finite`);\n}\n\nfunction validateBoundedInteger(value: number, name: string, maximum: number): void {\n if (!Number.isSafeInteger(value) || value <= 0 || value > maximum)\n throw new TypeError(`learned critical-path ${name} must be a positive safe integer`);\n}\n\nfunction predictionInputsFor(\n graph: SchedulerGraphSnapshot,\n identityForTask: LearnedCriticalPathStrategyOptions[\"identityForTask\"],\n model: Readonly<{\n readonly coldStartDurationMs: number;\n readonly maxHistorySeries: number;\n readonly sampleWindow: number;\n }>\n): readonly SchedulerPredictionInput[] | undefined {\n const inputs: SchedulerPredictionInput[] = [];\n for (const task of graph.tasks) {\n let identity: CanonicalJsonValue | undefined;\n try {\n identity = canonicalizeJsonValue({ historyKey: identityForTask(task), model });\n } catch {\n return undefined;\n }\n if (identity === undefined) return undefined;\n inputs.push(\n Object.freeze({\n authoredOptions: identity,\n checkId: task.taskId,\n flags: null,\n taskId: task.taskId\n })\n );\n }\n return Object.freeze(inputs);\n}\n\nfunction learnedDecision(\n context: AdmissionPolicyContext,\n prediction: SchedulerPredictionSnapshot,\n criticalPath: SchedulerCriticalPathSnapshot,\n options: LearnedCriticalPathStrategyOptions\n): AdmissionProposal {\n const selected = selectLearnedCandidate(context, criticalPath);\n if (!selected.canAdmit) return Object.freeze({ kind: \"wait\" });\n const taskPrediction = predictionForTask(prediction, selected.taskId);\n const score = criticalPathScoreForTask(criticalPath, selected.taskId);\n if (taskPrediction !== undefined && score !== undefined) {\n observe(\n options,\n Object.freeze({\n kind: \"selection-proposed\",\n taskId: selected.taskId,\n criticalPathScore: score,\n estimatedDurationMs: taskPrediction.estimatedDurationMs,\n sampleCount: taskPrediction.sampleCount,\n source: taskPrediction.source\n })\n );\n }\n return Object.freeze({ kind: \"select\", taskId: selected.taskId });\n}\n\nfunction selectLearnedCandidate(\n context: AdmissionPolicyContext,\n criticalPath: SchedulerCriticalPathSnapshot\n): AdmissionPolicyContext[\"candidates\"][number] {\n const layers = learnedSelectionLayers(context);\n if (layers.tightening.length > 0)\n return requiredFirst(\n sortConstrained(layers.tightening, layers.taskById, layers.scopeById, criticalPath)\n );\n if (layers.continuation.length > 0)\n return requiredFirst(\n sortConstrained(layers.continuation, layers.taskById, layers.scopeById, criticalPath)\n );\n return requiredFirst(\n [...context.candidates].sort(learnedCandidateComparator(layers.taskById, criticalPath))\n );\n}\n\nfunction learnedCandidateComparator(\n taskById: ReadonlyMap<string, SchedulerGraphSnapshot[\"tasks\"][number]>,\n criticalPath: SchedulerCriticalPathSnapshot\n): (\n left: AdmissionPolicyContext[\"candidates\"][number],\n right: AdmissionPolicyContext[\"candidates\"][number]\n) => number {\n return (left, right) => compareLearnedTasks(taskById, criticalPath, left.taskId, right.taskId);\n}\n\nfunction sortConstrained(\n candidates: readonly AdmissionPolicyContext[\"candidates\"][number][],\n taskById: ReadonlyMap<string, SchedulerGraphSnapshot[\"tasks\"][number]>,\n scopeById: ReadonlyMap<string, SchedulerGraphSnapshot[\"scopes\"][number]>,\n criticalPath: SchedulerCriticalPathSnapshot\n): AdmissionPolicyContext[\"candidates\"][number][] {\n return [...candidates].sort(learnedConstrainedComparator(taskById, scopeById, criticalPath));\n}\n\nfunction learnedConstrainedComparator(\n taskById: ReadonlyMap<string, SchedulerGraphSnapshot[\"tasks\"][number]>,\n scopeById: ReadonlyMap<string, SchedulerGraphSnapshot[\"scopes\"][number]>,\n criticalPath: SchedulerCriticalPathSnapshot\n): (\n left: AdmissionPolicyContext[\"candidates\"][number],\n right: AdmissionPolicyContext[\"candidates\"][number]\n) => number {\n return (left, right) => {\n const leftScope = requiredLearnedScope(left, taskById, scopeById);\n const rightScope = requiredLearnedScope(right, taskById, scopeById);\n return (\n leftScope.maxParallel - rightScope.maxParallel ||\n compareLearnedTasks(taskById, criticalPath, left.taskId, right.taskId) ||\n compareText(leftScope.id, rightScope.id) ||\n compareText(left.taskId, right.taskId)\n );\n };\n}\n\nfunction requiredLearnedScope(\n candidate: AdmissionPolicyContext[\"candidates\"][number],\n taskById: ReadonlyMap<string, SchedulerGraphSnapshot[\"tasks\"][number]>,\n scopeById: ReadonlyMap<string, SchedulerGraphSnapshot[\"scopes\"][number]>\n): SchedulerGraphSnapshot[\"scopes\"][number] {\n const task = taskById.get(candidate.taskId);\n const scope =\n task?.scopeId === null || task === undefined ? undefined : scopeById.get(task.scopeId);\n if (scope === undefined) throw new Error(\"constrained task is missing a scope\");\n return scope;\n}\nfunction compareLearnedTasks(\n taskById: ReadonlyMap<string, SchedulerGraphSnapshot[\"tasks\"][number]>,\n criticalPath: SchedulerCriticalPathSnapshot,\n leftId: string,\n rightId: string\n): number {\n const left = taskById.get(leftId);\n const right = taskById.get(rightId);\n if (left === undefined || right === undefined)\n throw new Error(\"learned candidate is missing from graph\");\n const leftScore = criticalPathScoreForTask(criticalPath, leftId);\n const rightScore = criticalPathScoreForTask(criticalPath, rightId);\n if (leftScore === undefined || rightScore === undefined)\n throw new Error(\"learned scheduler score is missing\");\n return (\n rightScore - leftScore ||\n right.admissionPriority - left.admissionPriority ||\n compareText(leftId, rightId)\n );\n}\n\nfunction observe(\n options: LearnedCriticalPathStrategyOptions,\n event: LearnedCriticalPathObservation\n): void {\n try {\n const observed = options.observe?.(event);\n if (observed !== undefined) void Promise.resolve(observed).catch(() => undefined);\n } catch {\n // Caller observation is contained.\n }\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 requiredFirst<T>(values: readonly T[]): T {\n const first = values[0];\n if (first === undefined) throw new Error(\"learned strategy requires a candidate\");\n return first;\n}\n"]}

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

@@ -1,3 +1,4 @@
+import { getDefinedHandoffProviderIdentity } from "../../check/handoff-provider-identity.mjs";
 import { snapshotClosedArray } from "../../data-boundary/closed-values.mjs";
 import { parseCheckAuthoringData, parseCheckFieldPrelude, parseCheckFields } from "./check-fields-authoring.mjs";
 import { parseCheckScheduling } from "./scheduling-authoring.mjs";
@@ -23,10 +24,11 @@ export function parseCheckTreeAuthoring(value) {
     });
 }
 function parseCheck(value, path, state) {
+    const handoffProviderIdentity = getDefinedHandoffProviderIdentity(value);
     const data = parseCheckAuthoringData(value);
     if (data === undefined)
         return undefined;
-    const prelude = parseCheckFieldPrelude(data);
+    const prelude = parseCheckFieldPrelude(data, handoffProviderIdentity);
     if (prelude === undefined)
         return undefined;
     const checks = parseChildren(data, path, state);
@@ -47,7 +49,8 @@ function parseCheck(value, path, state) {
         dependsOn: scheduling.dependsOn,
         displayName: data.displayName,
         enabledByFlags: fields.enabledByFlags,
-        execution: fields.execution,
+        execute: fields.execute,
+        handoff: fields.handoff,
         maxParallel: scheduling.maxParallel,
         mutex: scheduling.mutex,
         observes: scheduling.observes,
@@ -55,8 +58,8 @@ function parseCheck(value, path, state) {
         options: fields.options,
         path,
         parseData: fields.parseData,
-        preflight: fields.preflight,
-        visibility: fields.visibility
+        prepare: fields.prepare,
+        omitQuietPassedRow: fields.omitQuietPassedRow
     });
 }
 function parseChildren(data, path, state) {
@@ -75,7 +78,7 @@ function parseChildren(data, path, state) {
     return Object.freeze(checks);
 }
 function warnForMeaninglessCheck(data, checks, fields, path, state) {
-    if (fields.execution !== null || checks.length > 0)
+    if (fields.execute !== null || checks.length > 0)
         return;
     state.warnings.push(Object.freeze({ code: "meaningless-check", path, checkId: data.checkId }));
 }

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

	@@ -1 +1 @@
1	- {"version":3,"file":"authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/authoring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAKjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAA8B,MAAM,2BAA2B,CAAC;~~AAwC7F~~;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAe,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,qBAAqB,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,IAAY,EAAE,KAAiB;IACjE,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;~~IAC7C~~,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;QAC/C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,~~SAAS~~,EAAE,MAAM,CAAC,~~SAAS~~;~~QAC3B~~,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,~~SAAS~~,EAAE,MAAM,CAAC,~~SAAS~~;~~QAC3B~~,~~UAAU~~,EAAE,MAAM,CAAC,~~UAAU~~;~~KAC9B~~,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CACpB,IAAwB,EACxB,IAAY,EACZ,KAAiB;IAEjB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,WAAW,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3E,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAwB,EACxB,MAA8B,EAC9B,MAAyB,EACzB,IAAY,EACZ,KAAiB;IAEjB,IAAI,MAAM,CAAC,~~SAAS~~,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;~~IAC3D~~,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport { snapshotClosedArray } from \"../../data-boundary/closed-values.ts\";\nimport {\n parseCheckAuthoringData,\n parseCheckFieldPrelude,\n parseCheckFields,\n type CheckAuthoringData,\n type ParsedCheckFields,\n type ParsedCheckFieldPrelude,\n type TrustedDataParser\n} from \"./check-fields-authoring.ts\";\nimport { parseCheckScheduling, type ParsedCheckCollection } from \"./scheduling-authoring.ts\";\nimport type { ResourceUnitMapping } from \"../resource-unit-mapping.ts\";\n\nexport type { ParsedCheckCollection } from \"./scheduling-authoring.ts\";\n\nexport interface ParsedCheck {\n readonly admissionPriority: number \| undefined;\n readonly checkId: string;\n readonly checks: readonly ParsedCheck[];\n readonly definition: CheckDescriptor \| null;\n readonly dependsOn: ParsedCheckCollection \| undefined;\n readonly displayName: string;\n readonly enabledByFlags: ParsedCheckFieldPrelude[\"enabledByFlags\"];\n readonly ~~execution~~: ParsedCheckFieldPrelude[\"~~execution~~\"];\n readonly maxParallel: number \| undefined;\n readonly mutex: ParsedCheckCollection \| undefined;\n readonly observes: ParsedCheckCollection \| undefined;\n readonly resourceClaims: ResourceUnitMapping \| undefined;\n readonly options: object \| null;\n readonly path: string;\n readonly parseData: TrustedDataParser \| null;\n readonly ~~preflight~~: ParsedCheckFieldPrelude[\"~~preflight~~\"];\n readonly ~~visibility~~: ParsedCheckFields[\"~~visibility~~\"];\n}\n\nexport interface ParsedCheckTree {\n readonly checks: readonly ParsedCheck[];\n readonly warnings: readonly MeaninglessCheckWarning[];\n}\n\nexport interface MeaninglessCheckWarning {\n readonly code: \"meaningless-check\";\n readonly path: string;\n readonly checkId: string;\n}\n\ninterface ParseState {\n readonly warnings: MeaninglessCheckWarning[];\n}\n\n/*\n Parses only the closed recursive authoring grammar. Execution callbacks are\n * trusted project code, while every declarative field is copied and validated.\n */\nexport function parseCheckTreeAuthoring(value: unknown): ParsedCheckTree \| undefined {\n const roots = snapshotClosedArray(value);\n if (roots === undefined) return undefined;\n const state: ParseState = { warnings: [] };\n const checks: ParsedCheck[] = [];\n for (let index = 0; index < roots.length; index += 1) {\n const check = parseCheck(roots[index], `definition.checks[${index}]`, state);\n if (check === undefined) return undefined;\n checks.push(check);\n }\n return Object.freeze({\n checks: Object.freeze(checks),\n warnings: Object.freeze(state.warnings)\n });\n}\n\nfunction parseCheck(value: unknown, path: string, state: ParseState): ParsedCheck \| undefined {\n const data = parseCheckAuthoringData(value);\n if (data === undefined) return undefined;\n const prelude = parseCheckFieldPrelude(data);\n if (prelude === undefined) return undefined;\n const checks = parseChildren(data, path, state);\n if (checks === undefined) return undefined;\n const scheduling = parseCheckScheduling(data);\n if (scheduling === undefined) return undefined;\n const fields = parseCheckFields(data, prelude);\n if (fields === undefined) return undefined;\n warnForMeaninglessCheck(data, checks, fields, path, state);\n return Object.freeze({\n admissionPriority: scheduling.admissionPriority,\n checkId: data.checkId,\n checks,\n definition: fields.definition,\n dependsOn: scheduling.dependsOn,\n displayName: data.displayName,\n enabledByFlags: fields.enabledByFlags,\n ~~execution~~: fields.~~execution~~,\n maxParallel: scheduling.maxParallel,\n mutex: scheduling.mutex,\n observes: scheduling.observes,\n resourceClaims: scheduling.resourceClaims,\n options: fields.options,\n path,\n parseData: fields.parseData,\n ~~preflight~~: fields.~~preflight~~,\n ~~visibility~~: fields.~~visibility~~\n });\n}\n\nfunction parseChildren(\n data: CheckAuthoringData,\n path: string,\n state: ParseState\n): readonly ParsedCheck[] \| undefined {\n if (!Object.hasOwn(data, \"checks\")) return Object.freeze([]);\n const values = snapshotClosedArray(data.checks);\n if (values === undefined) return undefined;\n const checks: ParsedCheck[] = [];\n for (let index = 0; index < values.length; index += 1) {\n const check = parseCheck(values[index], `${path}.checks[${index}]`, state);\n if (check === undefined) return undefined;\n checks.push(check);\n }\n return Object.freeze(checks);\n}\n\nfunction warnForMeaninglessCheck(\n data: CheckAuthoringData,\n checks: readonly ParsedCheck[],\n fields: ParsedCheckFields,\n path: string,\n state: ParseState\n): void {\n if (fields.~~execution~~ !== null \|\| checks.length > 0) return;\n state.warnings.push(Object.freeze({ code: \"meaningless-check\", path, checkId: data.checkId }));\n}\n"]}
1	+ {"version":3,"file":"authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport {\n getDefinedHandoffProviderIdentity,\n type HandoffProviderIdentity\n} from \"../../check/handoff-provider-identity.ts\";\nimport { snapshotClosedArray } from \"../../data-boundary/closed-values.ts\";\nimport {\n parseCheckAuthoringData,\n parseCheckFieldPrelude,\n parseCheckFields,\n type CheckAuthoringData,\n type ParsedCheckFields,\n type ParsedCheckFieldPrelude,\n type TrustedDataParser\n} from \"./check-fields-authoring.ts\";\nimport { parseCheckScheduling, type ParsedCheckCollection } from \"./scheduling-authoring.ts\";\nimport type { ResourceUnitMapping } from \"../resource-unit-mapping.ts\";\n\nexport type { ParsedCheckCollection } from \"./scheduling-authoring.ts\";\n\nexport interface ParsedCheck {\n readonly admissionPriority: number \| undefined;\n readonly checkId: string;\n readonly checks: readonly ParsedCheck[];\n readonly definition: CheckDescriptor \| null;\n readonly dependsOn: ParsedCheckCollection \| undefined;\n readonly displayName: string;\n readonly enabledByFlags: ParsedCheckFieldPrelude[\"enabledByFlags\"];\n readonly execute: ParsedCheckFieldPrelude[\"execute\"];\n readonly handoff: HandoffProviderIdentity \| null;\n readonly maxParallel: number \| undefined;\n readonly mutex: ParsedCheckCollection \| undefined;\n readonly observes: ParsedCheckCollection \| undefined;\n readonly resourceClaims: ResourceUnitMapping \| undefined;\n readonly options: object \| null;\n readonly path: string;\n readonly parseData: TrustedDataParser \| null;\n readonly prepare: ParsedCheckFieldPrelude[\"prepare\"];\n readonly omitQuietPassedRow: ParsedCheckFields[\"omitQuietPassedRow\"];\n}\n\nexport interface ParsedCheckTree {\n readonly checks: readonly ParsedCheck[];\n readonly warnings: readonly MeaninglessCheckWarning[];\n}\n\nexport interface MeaninglessCheckWarning {\n readonly code: \"meaningless-check\";\n readonly path: string;\n readonly checkId: string;\n}\n\ninterface ParseState {\n readonly warnings: MeaninglessCheckWarning[];\n}\n\n/*\n Parses only the closed recursive authoring grammar. Execution callbacks are\n * trusted project code, while every declarative field is copied and validated.\n */\nexport function parseCheckTreeAuthoring(value: unknown): ParsedCheckTree \| undefined {\n const roots = snapshotClosedArray(value);\n if (roots === undefined) return undefined;\n const state: ParseState = { warnings: [] };\n const checks: ParsedCheck[] = [];\n for (let index = 0; index < roots.length; index += 1) {\n const check = parseCheck(roots[index], `definition.checks[${index}]`, state);\n if (check === undefined) return undefined;\n checks.push(check);\n }\n return Object.freeze({\n checks: Object.freeze(checks),\n warnings: Object.freeze(state.warnings)\n });\n}\n\nfunction parseCheck(value: unknown, path: string, state: ParseState): ParsedCheck \| undefined {\n const handoffProviderIdentity = getDefinedHandoffProviderIdentity(value);\n const data = parseCheckAuthoringData(value);\n if (data === undefined) return undefined;\n const prelude = parseCheckFieldPrelude(data, handoffProviderIdentity);\n if (prelude === undefined) return undefined;\n const checks = parseChildren(data, path, state);\n if (checks === undefined) return undefined;\n const scheduling = parseCheckScheduling(data);\n if (scheduling === undefined) return undefined;\n const fields = parseCheckFields(data, prelude);\n if (fields === undefined) return undefined;\n warnForMeaninglessCheck(data, checks, fields, path, state);\n return Object.freeze({\n admissionPriority: scheduling.admissionPriority,\n checkId: data.checkId,\n checks,\n definition: fields.definition,\n dependsOn: scheduling.dependsOn,\n displayName: data.displayName,\n enabledByFlags: fields.enabledByFlags,\n execute: fields.execute,\n handoff: fields.handoff,\n maxParallel: scheduling.maxParallel,\n mutex: scheduling.mutex,\n observes: scheduling.observes,\n resourceClaims: scheduling.resourceClaims,\n options: fields.options,\n path,\n parseData: fields.parseData,\n prepare: fields.prepare,\n omitQuietPassedRow: fields.omitQuietPassedRow\n });\n}\n\nfunction parseChildren(\n data: CheckAuthoringData,\n path: string,\n state: ParseState\n): readonly ParsedCheck[] \| undefined {\n if (!Object.hasOwn(data, \"checks\")) return Object.freeze([]);\n const values = snapshotClosedArray(data.checks);\n if (values === undefined) return undefined;\n const checks: ParsedCheck[] = [];\n for (let index = 0; index < values.length; index += 1) {\n const check = parseCheck(values[index], `${path}.checks[${index}]`, state);\n if (check === undefined) return undefined;\n checks.push(check);\n }\n return Object.freeze(checks);\n}\n\nfunction warnForMeaninglessCheck(\n data: CheckAuthoringData,\n checks: readonly ParsedCheck[],\n fields: ParsedCheckFields,\n path: string,\n state: ParseState\n): void {\n if (fields.execute !== null \|\| checks.length > 0) return;\n state.warnings.push(Object.freeze({ code: \"meaningless-check\", path, checkId: data.checkId }));\n}\n"]}

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

@@ -2,7 +2,7 @@ import {} from "../../check/check.mjs";
 import { validateCheckDescriptor } from "../../check/descriptor-validation.mjs";
 import { snapshotJsonObject } from "../../check/options-snapshot.mjs";
 import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
-import { parseUniqueIdentifiers } from "./collection-authoring.mjs";
+import { hasOnlyKeys, parseFlagCondition } from "./flag-conditions.mjs";
 const CHECK_KEYS = [
     "admissionPriority",
     "checkId",
@@ -10,25 +10,27 @@ const CHECK_KEYS = [
     "dependsOn",
     "displayName",
     "enabledByFlags",
-    "execution",
+    "execute",
+    "handoff",
     "maxParallel",
     "mutex",
     "options",
     "observes",
     "parseData",
-    "preflight",
+    "prepare",
     "resourceClaims",
-    "visibility"
+    "omitQuietPassedRow"
 ];
-const FLAG_ENABLEMENT_KEYS = ["flags", "mode", "propagateDependsOn"];
+const FLAG_ENABLEMENT_EXPRESSION_KEYS = ["when", "propagateDependsOn"];
 const CONTAINER_CHECK_FIELDS = Object.freeze({
     definition: null,
     enabledByFlags: null,
-    execution: null,
+    execute: null,
+    handoff: null,
     options: null,
     parseData: null,
-    preflight: null,
-    visibility: null
+    prepare: null,
+    omitQuietPassedRow: null
 });
 export function parseCheckAuthoringData(value) {
     const data = snapshotClosedRecord(value);
@@ -41,67 +43,91 @@ function hasValidCheckIdentity(data) {
         typeof data.displayName === "string" &&
         data.displayName.length > 0);
 }
-export function parseCheckFieldPrelude(data) {
+export function parseCheckFieldPrelude(data, handoffProviderIdentity) {
     const execution = parseExecution(data);
     if (execution === undefined)
         return undefined;
+    const handoff = parseHandoff(data, handoffProviderIdentity);
+    if (handoff === undefined)
+        return undefined;
     const parseData = parseDataParser(data);
     if (parseData === undefined)
         return undefined;
-    const preflight = parsePreflight(data);
-    if (preflight === undefined)
+    const preparation = parsePreparation(data);
+    if (preparation === undefined)
         return undefined;
     const enabledByFlags = parseEnabledByFlags(data);
     return enabledByFlags === undefined
         ? undefined
-        : Object.freeze({ enabledByFlags, execution, parseData, preflight });
+        : Object.freeze({
+            enabledByFlags,
+            execute: execution,
+            handoff,
+            parseData,
+            prepare: preparation
+        });
 }
 export function parseCheckFields(data, prelude) {
-    if (prelude.execution === null) {
-        return Object.hasOwn(data, "options") ||
-            Object.hasOwn(data, "enabledByFlags") ||
-            Object.hasOwn(data, "visibility") ||
-            prelude.parseData !== null ||
-            prelude.preflight !== null
-            ? undefined
-            : CONTAINER_CHECK_FIELDS;
+    if (prelude.execute === null) {
+        return containerHasExecutableFields(data, prelude) ? undefined : CONTAINER_CHECK_FIELDS;
     }
+    return parseExecutableCheckFields(data, prelude);
+}
+/** Container nodes cannot carry values that only an executable callback can consume. */
+function containerHasExecutableFields(data, prelude) {
+    return (Object.hasOwn(data, "options") ||
+        Object.hasOwn(data, "enabledByFlags") ||
+        prelude.handoff !== null ||
+        Object.hasOwn(data, "omitQuietPassedRow") ||
+        prelude.parseData !== null ||
+        prelude.prepare !== null);
+}
+/** Parses the callback-owned fields that form one executable Check definition. */
+function parseExecutableCheckFields(data, prelude) {
     const definition = parseDefinition(data);
     if (definition === undefined)
         return undefined;
     const options = parseOptions(data);
     if (options === undefined)
         return undefined;
-    const visibility = parseVisibility(data);
-    if (visibility === undefined)
+    const omitQuietPassedRow = parseOmitQuietPassedRow(data);
+    if (omitQuietPassedRow === undefined)
         return undefined;
     return Object.freeze({
         definition,
         enabledByFlags: prelude.enabledByFlags,
-        execution: prelude.execution,
+        execute: prelude.execute,
+        handoff: prelude.handoff,
         options,
         parseData: prelude.parseData,
-        preflight: prelude.preflight,
-        visibility
+        prepare: prelude.prepare,
+        omitQuietPassedRow
     });
 }
 function hasOnlyCheckKeys(data) {
     return Object.keys(data).every((key) => CHECK_KEYS.some((checkKey) => checkKey === key));
 }
 function parseExecution(data) {
-    if (!Object.hasOwn(data, "execution"))
+    if (!Object.hasOwn(data, "execute"))
+        return null;
+    return isTrustedFunction(data.execute) ? data.execute : undefined;
+}
+function parseHandoff(data, handoffProviderIdentity) {
+    if (!Object.hasOwn(data, "handoff"))
         return null;
-    return isTrustedFunction(data.execution) ? data.execution : undefined;
+    return data.handoff === true && handoffProviderIdentity !== undefined
+        ? handoffProviderIdentity
+        : undefined;
 }
 function parseDataParser(data) {
     if (!Object.hasOwn(data, "parseData") || data.parseData === undefined)
         return null;
     return isTrustedFunction(data.parseData) ? data.parseData : undefined;
 }
-function parsePreflight(data) {
-    if (!Object.hasOwn(data, "preflight"))
+function parsePreparation(data) {
+    if (!Object.hasOwn(data, "prepare"))
         return null;
-    return isTrustedFunction(data.preflight) ? data.preflight : undefined;
+    return isTrustedFunction(data.prepare) ? data.prepare : undefined;
 }
 function isTrustedFunction(value) {
     return typeof value === "function";
@@ -124,48 +150,35 @@ function parseOptions(data) {
 function parseEnabledByFlags(data) {
     if (!Object.hasOwn(data, "enabledByFlags"))
         return null;
-    const control = parseFlagEnablementControl(data.enabledByFlags);
-    if (control === undefined)
-        return undefined;
-    const flags = parseUniqueIdentifiers(control.flags);
-    return flags === undefined ? undefined : canonicalFlagEnablement(control, flags);
+    return parseFlagEnablementControl(data.enabledByFlags);
 }
-function parseFlagEnablementControl(value) {
+/** Parses one closed flag-enablement field without validating its Project flag references. */
+export function parseFlagEnablementControl(value) {
     const control = snapshotClosedRecord(value);
-    if (control === undefined || !hasOnlyFlagEnablementKeys(control))
+    if (control === undefined ||
+        !hasOnlyKeys(control, FLAG_ENABLEMENT_EXPRESSION_KEYS) ||
+        !Object.hasOwn(control, "when")) {
         return undefined;
-    return hasFlagEnablementFields(control) ? control : undefined;
+    }
+    const when = parseFlagCondition(control.when);
+    const propagateDependsOn = parsePropagation(control);
+    return when === undefined || propagateDependsOn === undefined
+        ? undefined
+        : Object.freeze({
+            when,
+            ...(propagateDependsOn ? { propagateDependsOn: true } : {})
+        });
 }
-function hasFlagEnablementFields(control) {
-    if (!Object.hasOwn(control, "flags") || !Object.hasOwn(control, "mode"))
-        return false;
-    if (!isCheckFlagEnablementMode(control.mode))
+function parsePropagation(control) {
+    if (!Object.hasOwn(control, "propagateDependsOn"))
         return false;
-    return !Object.hasOwn(control, "propagateDependsOn") || control.propagateDependsOn === true;
+    return control.propagateDependsOn === true ? true : undefined;
 }
-function canonicalFlagEnablement(control, flags) {
-    const [firstFlag, ...remainingFlags] = [...flags].sort();
-    if (firstFlag === undefined)
-        return undefined;
-    const canonicalFlags = [firstFlag, ...remainingFlags];
-    return Object.freeze({
-        flags: Object.freeze(canonicalFlags),
-        mode: control.mode,
-        ...(control.propagateDependsOn === true ? { propagateDependsOn: true } : {})
-    });
-}
-function hasOnlyFlagEnablementKeys(control) {
-    return Object.keys(control).every((key) => FLAG_ENABLEMENT_KEYS.some((allowed) => allowed === key));
-}
-function isCheckFlagEnablementMode(value) {
-    return value === "all" || value === "any" || value === "none" || value === "not-all";
-}
-function parseVisibility(data) {
-    if (!Object.hasOwn(data, "visibility"))
-        return "always";
-    const visibility = data.visibility;
-    return visibility === undefined || visibility === "always" || visibility === "attention"
-        ? (visibility ?? "always")
+function parseOmitQuietPassedRow(data) {
+    if (!Object.hasOwn(data, "omitQuietPassedRow"))
+        return false;
+    return data.omitQuietPassedRow === undefined || data.omitQuietPassedRow === true
+        ? (data.omitQuietPassedRow ?? false)
         : undefined;
 }
 //# sourceMappingURL=check-fields-authoring.mjs.map