@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/package-tools/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/package-tools/learned-critical-path/duration-model/bounded-history.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-history.mjs","sourceRoot":"","sources":["../../../../../src/package-tools/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/package-tools/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 preparation. */
+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/package-tools/learned-critical-path/duration-model/prediction.mjs.map

@@ -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/package-tools/learned-critical-path/duration-model/preparation.mjs

@@ -0,0 +1,43 @@
+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,
+                        ...(input.maxSamplesPerSeries === undefined
+                            ? {}
+                            : { maxSamplesPerSeries: input.maxSamplesPerSeries }),
+                        ...(input.maxSeries === undefined ? {} : { 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/package-tools/learned-critical-path/duration-model/preparation.mjs.map

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

@@ -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/package-tools/learned-critical-path/duration-model/recording.mjs.map

@@ -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/package-tools/learned-critical-path/duration-model/storage.mjs

@@ -0,0 +1,187 @@
+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 { 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",
+    "latestObservationSequence",
+    "modelVersion",
+    "series"
+];
+const SERIES_KEYS = ["identityDigest", "latestObservationSequence", "samples"];
+const SAMPLE_KEYS = ["durationMs", "observationSequence", "settlementKind"];
+/** Reads untrusted local state and always degrades to an empty model on an I/O or format fault. */
+export async function loadSchedulerHistory(stateDirectory) {
+    let source;
+    try {
+        source = await fs.readFile(schedulerHistoryPath(stateDirectory), "utf8");
+    }
+    catch (error) {
+        return Object.freeze({
+            history: emptySchedulerHistory(),
+            observation: isMissingPath(error) ? "missing" : "failed"
+        });
+    }
+    try {
+        const parsed = parseSchedulerHistoryEnvelope(JSON.parse(source));
+        if (parsed.kind === "incompatible") {
+            return Object.freeze({ history: emptySchedulerHistory(), observation: "incompatible" });
+        }
+        if (parsed.kind === "invalid") {
+            return Object.freeze({ history: emptySchedulerHistory(), observation: "invalid" });
+        }
+        return Object.freeze({ history: parsed.history, observation: "loaded" });
+    }
+    catch {
+        return Object.freeze({ history: emptySchedulerHistory(), observation: "invalid" });
+    }
+}
+/** Publishes a full closed model through a same-directory temporary file and atomic replacement. */
+export async function writeSchedulerHistory(stateDirectory, history) {
+    let temporaryPath;
+    try {
+        const targetPath = schedulerHistoryPath(stateDirectory);
+        temporaryPath = join(stateDirectory, `.vibe-check-scheduler-history-${randomUUID()}.tmp`);
+        await fs.mkdir(stateDirectory, { recursive: true });
+        await fs.writeFile(temporaryPath, schedulerHistoryText(history), {
+            encoding: "utf8",
+            flag: "wx"
+        });
+        await fs.rename(temporaryPath, targetPath);
+        return "stored";
+    }
+    catch {
+        return "failed";
+    }
+    finally {
+        if (temporaryPath !== undefined) {
+            await fs.rm(temporaryPath, { force: true }).catch(() => undefined);
+        }
+    }
+}
+export function schedulerHistoryPath(stateDirectory) {
+    return join(stateDirectory, SCHEDULER_HISTORY_FILE_NAME);
+}
+function schedulerHistoryText(history) {
+    return canonicalJsonText({
+        envelopeVersion: SCHEDULER_HISTORY_ENVELOPE_VERSION,
+        latestObservationSequence: history.latestObservationSequence,
+        modelVersion: SCHEDULER_HISTORY_MODEL_VERSION,
+        series: history.series.map((series) => ({
+            identityDigest: series.identityDigest,
+            latestObservationSequence: series.latestObservationSequence,
+            samples: series.samples.map((sample) => ({
+                durationMs: sample.durationMs,
+                observationSequence: sample.observationSequence,
+                settlementKind: sample.settlementKind
+            }))
+        }))
+    });
+}
+function parseSchedulerHistoryEnvelope(value) {
+    const envelope = snapshotExactClosedRecord(value, ENVELOPE_KEYS);
+    if (envelope === undefined) {
+        return Object.freeze({ kind: "invalid" });
+    }
+    if (typeof envelope.envelopeVersion !== "string" ||
+        typeof envelope.modelVersion !== "string" ||
+        !isObservationSequence(envelope.latestObservationSequence)) {
+        return Object.freeze({ kind: "invalid" });
+    }
+    if (envelope.envelopeVersion !== SCHEDULER_HISTORY_ENVELOPE_VERSION ||
+        envelope.modelVersion !== SCHEDULER_HISTORY_MODEL_VERSION) {
+        return Object.freeze({ kind: "incompatible" });
+    }
+    const series = parseSeries(envelope.series);
+    if (series === undefined)
+        return Object.freeze({ kind: "invalid" });
+    const greatestSequence = series.reduce((greatest, entry) => Math.max(greatest, entry.latestObservationSequence), 0);
+    if (envelope.latestObservationSequence !== greatestSequence) {
+        return Object.freeze({ kind: "invalid" });
+    }
+    return Object.freeze({
+        kind: "loaded",
+        history: freezeSchedulerHistoryModel({
+            latestObservationSequence: envelope.latestObservationSequence,
+            series
+        })
+    });
+}
+function parseSeries(value) {
+    const entries = snapshotClosedArray(value);
+    if (entries === undefined || entries.length > MAX_SCHEDULER_HISTORY_SERIES)
+        return undefined;
+    const identities = new Set();
+    const parsed = [];
+    for (const entry of entries) {
+        const series = parseSeriesEntry(entry);
+        if (series === undefined || identities.has(series.identityDigest))
+            return undefined;
+        identities.add(series.identityDigest);
+        parsed.push(series);
+    }
+    return Object.freeze(parsed);
+}
+function parseSeriesEntry(value) {
+    const record = snapshotExactClosedRecord(value, SERIES_KEYS);
+    if (record === undefined)
+        return undefined;
+    if (!isSchedulerHistoryIdentityDigest(record.identityDigest) ||
+        !isObservationSequence(record.latestObservationSequence)) {
+        return undefined;
+    }
+    const samples = parseSamples(record.samples);
+    if (samples === undefined ||
+        samples.at(-1)?.observationSequence !== record.latestObservationSequence) {
+        return undefined;
+    }
+    return Object.freeze({
+        identityDigest: record.identityDigest,
+        latestObservationSequence: record.latestObservationSequence,
+        samples
+    });
+}
+function parseSamples(value) {
+    const entries = snapshotClosedArray(value);
+    if (entries === undefined ||
+        entries.length === 0 ||
+        entries.length > MAX_SCHEDULER_HISTORY_SAMPLES_PER_SERIES) {
+        return undefined;
+    }
+    const samples = [];
+    let priorSequence = -1;
+    for (const entry of entries) {
+        const sample = parseSample(entry);
+        if (sample === undefined || sample.observationSequence <= priorSequence)
+            return undefined;
+        priorSequence = sample.observationSequence;
+        samples.push(sample);
+    }
+    return Object.freeze(samples);
+}
+function parseSample(value) {
+    const record = snapshotExactClosedRecord(value, SAMPLE_KEYS);
+    if (record === undefined)
+        return undefined;
+    if (!isBoundedDurationMs(record.durationMs) ||
+        !isPositiveObservationSequence(record.observationSequence) ||
+        !isSchedulerSettlementKind(record.settlementKind)) {
+        return undefined;
+    }
+    return Object.freeze({
+        durationMs: record.durationMs,
+        observationSequence: record.observationSequence,
+        settlementKind: record.settlementKind
+    });
+}
+function isMissingPath(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error.code === "ENOENT");
+}
+function isPositiveObservationSequence(value) {
+    return isObservationSequence(value) && value > 0;
+}
+//# sourceMappingURL=storage.mjs.map

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

@@ -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"]}