@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/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 { hasExactPlainRecordKeys, snapshotClosedArray, snapshotClosedRecord } 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 = snapshotClosedRecord(value);
+    if (envelope === undefined || !hasExactPlainRecordKeys(envelope, ENVELOPE_KEYS)) {
+        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 = snapshotClosedRecord(value);
+    if (record === undefined || !hasExactPlainRecordKeys(record, SERIES_KEYS))
+        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 = snapshotClosedRecord(value);
+    if (record === undefined || !hasExactPlainRecordKeys(record, SAMPLE_KEYS))
+        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/learned-critical-path/duration-model/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.mjs","sourceRoot":"","sources":["../../../../src/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  hasExactPlainRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\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 = snapshotClosedRecord(value);\n  if (envelope === undefined || !hasExactPlainRecordKeys(envelope, ENVELOPE_KEYS)) {\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 = snapshotClosedRecord(value);\n  if (record === undefined || !hasExactPlainRecordKeys(record, SERIES_KEYS)) 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 = snapshotClosedRecord(value);\n  if (record === undefined || !hasExactPlainRecordKeys(record, SAMPLE_KEYS)) 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/selection-layers.mjs

@@ -0,0 +1,28 @@
+/** Projects the public graph and boundary facts into the Scheduler's two constrained selection layers. */
+export function learnedSelectionLayers(context) {
+    const taskById = new Map(context.graph.tasks.map((task) => [task.taskId, task]));
+    const scopeById = new Map(context.graph.scopes.map((scope) => [scope.id, scope]));
+    const activeScopeIds = new Set(context.activeScopeIds);
+    return Object.freeze({
+        continuation: Object.freeze(context.candidates.filter((candidate) => isContinuation(candidate, taskById, scopeById, activeScopeIds, context.capacity.maxParallel))),
+        scopeById,
+        taskById,
+        tightening: Object.freeze(context.candidates.filter((candidate) => isTightening(candidate, taskById, scopeById, activeScopeIds, context.capacity.maxParallel)))
+    });
+}
+function isTightening(candidate, taskById, scopeById, activeScopeIds, maxParallel) {
+    const scope = scopeForCandidate(candidate, taskById, scopeById);
+    return (scope !== undefined &&
+        scope.activationTaskIds.includes(candidate.taskId) &&
+        !activeScopeIds.has(scope.id) &&
+        scope.maxParallel < maxParallel);
+}
+function isContinuation(candidate, taskById, scopeById, activeScopeIds, maxParallel) {
+    const scope = scopeForCandidate(candidate, taskById, scopeById);
+    return scope !== undefined && activeScopeIds.has(scope.id) && scope.maxParallel < maxParallel;
+}
+export function scopeForCandidate(candidate, taskById, scopeById) {
+    const task = taskById.get(candidate.taskId);
+    return task?.scopeId === null || task === undefined ? undefined : scopeById.get(task.scopeId);
+}
+//# sourceMappingURL=selection-layers.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection-layers.mjs","sourceRoot":"","sources":["../../../src/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,KAAK,SAAS;QACnB,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;QAClD,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 !== undefined &&\n    scope.activationTaskIds.includes(candidate.taskId) &&\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/learned-critical-path/static-decision.mjs

@@ -0,0 +1,55 @@
+import { learnedSelectionLayers, scopeForCandidate } from "./selection-layers.mjs";
+/** Preserves ordinary static selection when learned preparation cannot form a ranking. */
+export function staticDecision(context) {
+    const layers = learnedSelectionLayers(context);
+    const selected = selectStaticCandidate(context.candidates, layers.continuation, layers.scopeById, layers.taskById, layers.tightening);
+    return selected === undefined || !selected.canAdmit
+        ? Object.freeze({ kind: "wait" })
+        : Object.freeze({ kind: "select", taskId: selected.taskId });
+}
+function selectStaticCandidate(candidates, continuation, scopeById, taskById, tightening) {
+    if (tightening.length > 0)
+        return first(sortConstrained(tightening, taskById, scopeById));
+    if (continuation.length > 0)
+        return first(sortConstrained(continuation, taskById, scopeById));
+    return selectOrdinary(candidates, taskById);
+}
+function selectOrdinary(candidates, taskById) {
+    const admissible = candidates.filter((candidate) => candidate.canAdmit);
+    return [...(admissible.length === 0 ? candidates : admissible)].sort((left, right) => priorityDifference(left, right, taskById) || compareText(left.taskId, right.taskId))[0];
+}
+function sortConstrained(candidates, taskById, scopeById) {
+    return [...candidates].sort((left, right) => constrainedComparison(left, right, taskById, scopeById));
+}
+function constrainedComparison(left, right, taskById, scopeById) {
+    const leftScope = requiredScope(left, taskById, scopeById);
+    const rightScope = requiredScope(right, taskById, scopeById);
+    return (leftScope.maxParallel - rightScope.maxParallel ||
+        priorityDifference(left, right, taskById) ||
+        compareText(leftScope.id, rightScope.id) ||
+        compareText(left.taskId, right.taskId));
+}
+function requiredScope(candidate, taskById, scopeById) {
+    const scope = scopeForCandidate(candidate, taskById, scopeById);
+    if (scope === undefined)
+        throw new Error("constrained task is missing a scope");
+    return scope;
+}
+function priorityDifference(left, right, taskById) {
+    return ((taskById.get(right.taskId)?.admissionPriority ?? 0) -
+        (taskById.get(left.taskId)?.admissionPriority ?? 0));
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function first(values) {
+    const value = values[0];
+    if (value === undefined)
+        throw new Error("static strategy requires a candidate");
+    return value;
+}
+//# sourceMappingURL=static-decision.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-decision.mjs","sourceRoot":"","sources":["../../../src/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/strategy.mjs

@@ -0,0 +1,179 @@
+import { isAbsolute } from "node:path";
+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";
+/**
+ * 构造普通公开 prepared strategy。调用方拥有 history location 与 identity projection；
+ * Product 只按同一 custom strategy lifecycle 调用它，不为该 helper 增加特权。
+ */
+export function createLearnedCriticalPathStrategy(options) {
+    if (typeof options.stateDirectory !== "string" || !isAbsolute(options.stateDirectory)) {
+        throw new TypeError("learned critical-path stateDirectory must be an absolute path");
+    }
+    const model = modelOptions(options);
+    return Object.freeze({
+        kind: "prepared",
+        prepare: async ({ graph }) => {
+            const predictionInputs = predictionInputsFor(graph, options.identityForTask, model);
+            if (predictionInputs === undefined) {
+                observe(options, { kind: "history-unavailable", reason: "identity-invalid" });
+                return Object.freeze({ decide: staticDecision });
+            }
+            const durationModel = await prepareSchedulerDurationModel({
+                predictionInputs,
+                stateDirectory: options.stateDirectory,
+                coldStartDurationMs: model.coldStartDurationMs,
+                maxSamplesPerSeries: model.sampleWindow,
+                maxSeries: model.maxHistorySeries
+            });
+            if (durationModel.kind === "static-fallback") {
+                observe(options, { kind: "history-unavailable", reason: "setup-failed" });
+                return Object.freeze({ decide: staticDecision });
+            }
+            let criticalPath;
+            try {
+                criticalPath = createSchedulerCriticalPathSnapshot(graph, durationModel.prediction);
+            }
+            catch {
+                observe(options, { kind: "history-unavailable", reason: "setup-failed" });
+                return Object.freeze({ decide: staticDecision });
+            }
+            return Object.freeze({
+                decide: (context) => learnedDecision(context, durationModel.prediction, criticalPath, options),
+                complete: async (context) => {
+                    const recorded = await durationModel.record(context);
+                    if (recorded.kind === "failed" || recorded.writeObservation === "failed") {
+                        observe(options, { kind: "recording-unavailable" });
+                    }
+                }
+            });
+        }
+    });
+}
+function modelOptions(options) {
+    const coldStartDurationMs = options.coldStartDurationMs ?? 1;
+    const maxHistorySeries = options.maxHistorySeries ?? 4_096;
+    const sampleWindow = options.sampleWindow ?? 32;
+    validatePositiveFinite(coldStartDurationMs, "coldStartDurationMs");
+    validateBoundedInteger(maxHistorySeries, "maxHistorySeries", 4_096);
+    validateBoundedInteger(sampleWindow, "sampleWindow", 32);
+    return Object.freeze({ coldStartDurationMs, maxHistorySeries, sampleWindow });
+}
+function validatePositiveFinite(value, name) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new TypeError(`learned critical-path ${name} must be positive and finite`);
+}
+function validateBoundedInteger(value, name, maximum) {
+    if (!Number.isSafeInteger(value) || value <= 0 || value > maximum)
+        throw new TypeError(`learned critical-path ${name} must be a positive safe integer`);
+}
+function predictionInputsFor(graph, identityForTask, model) {
+    const inputs = [];
+    for (const task of graph.tasks) {
+        let identity;
+        try {
+            identity = canonicalizeJsonValue({ historyKey: identityForTask(task), model });
+        }
+        catch {
+            return undefined;
+        }
+        if (identity === undefined)
+            return undefined;
+        inputs.push(Object.freeze({
+            authoredOptions: identity,
+            checkId: task.taskId,
+            flags: null,
+            taskId: task.taskId
+        }));
+    }
+    return Object.freeze(inputs);
+}
+function learnedDecision(context, prediction, criticalPath, options) {
+    const selected = selectLearnedCandidate(context, criticalPath);
+    if (!selected.canAdmit)
+        return Object.freeze({ kind: "wait" });
+    const taskPrediction = predictionForTask(prediction, selected.taskId);
+    const score = criticalPathScoreForTask(criticalPath, selected.taskId);
+    if (taskPrediction !== undefined && score !== undefined) {
+        observe(options, Object.freeze({
+            kind: "selection-proposed",
+            taskId: selected.taskId,
+            criticalPathScore: score,
+            estimatedDurationMs: taskPrediction.estimatedDurationMs,
+            sampleCount: taskPrediction.sampleCount,
+            source: taskPrediction.source
+        }));
+    }
+    return Object.freeze({ kind: "select", taskId: selected.taskId });
+}
+function selectLearnedCandidate(context, criticalPath) {
+    const layers = learnedSelectionLayers(context);
+    if (layers.tightening.length > 0)
+        return requiredFirst(sortConstrained(layers.tightening, layers.taskById, layers.scopeById, criticalPath));
+    if (layers.continuation.length > 0)
+        return requiredFirst(sortConstrained(layers.continuation, layers.taskById, layers.scopeById, criticalPath));
+    return requiredFirst([...context.candidates].sort(learnedCandidateComparator(layers.taskById, criticalPath)));
+}
+function learnedCandidateComparator(taskById, criticalPath) {
+    return (left, right) => compareLearnedTasks(taskById, criticalPath, left.taskId, right.taskId);
+}
+function sortConstrained(candidates, taskById, scopeById, criticalPath) {
+    return [...candidates].sort(learnedConstrainedComparator(taskById, scopeById, criticalPath));
+}
+function learnedConstrainedComparator(taskById, scopeById, criticalPath) {
+    return (left, right) => {
+        const leftScope = requiredLearnedScope(left, taskById, scopeById);
+        const rightScope = requiredLearnedScope(right, taskById, scopeById);
+        return (leftScope.maxParallel - rightScope.maxParallel ||
+            compareLearnedTasks(taskById, criticalPath, left.taskId, right.taskId) ||
+            compareText(leftScope.id, rightScope.id) ||
+            compareText(left.taskId, right.taskId));
+    };
+}
+function requiredLearnedScope(candidate, taskById, scopeById) {
+    const task = taskById.get(candidate.taskId);
+    const scope = task?.scopeId === null || task === undefined ? undefined : scopeById.get(task.scopeId);
+    if (scope === undefined)
+        throw new Error("constrained task is missing a scope");
+    return scope;
+}
+function compareLearnedTasks(taskById, criticalPath, leftId, rightId) {
+    const left = taskById.get(leftId);
+    const right = taskById.get(rightId);
+    if (left === undefined || right === undefined)
+        throw new Error("learned candidate is missing from graph");
+    const leftScore = criticalPathScoreForTask(criticalPath, leftId);
+    const rightScore = criticalPathScoreForTask(criticalPath, rightId);
+    if (leftScore === undefined || rightScore === undefined)
+        throw new Error("learned scheduler score is missing");
+    return (rightScore - leftScore ||
+        right.admissionPriority - left.admissionPriority ||
+        compareText(leftId, rightId));
+}
+function observe(options, event) {
+    try {
+        const observed = options.observe?.(event);
+        if (observed !== undefined)
+            void Promise.resolve(observed).catch(() => undefined);
+    }
+    catch {
+        // Caller observation is contained.
+    }
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function requiredFirst(values) {
+    const first = values[0];
+    if (first === undefined)
+        throw new Error("learned strategy requires a candidate");
+    return first;
+}
+//# sourceMappingURL=strategy.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.mjs","sourceRoot":"","sources":["../../../src/learned-critical-path/strategy.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute } from \"node:path\";\n\nimport { canonicalizeJsonValue, type CanonicalJsonValue } 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 \"../project-run/task-scheduler/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        complete: 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/machine-output/v4/atomic-publication.mjs

@@ -2,12 +2,6 @@ import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import { join } from "node:path";
 const CANONICAL_NAMES = ["records.ndjson", "run.json"];
-const RETIRED_NAMES = [
-    "metrics.json",
-    "report.md",
-    "warnings-all.ndjson",
-    "warnings.ndjson"
-];
 const OWNED_TEMP_PREFIX = ".vibe-check-publication-";
 /** Writes an already validated two-file candidate set through owned temporary paths. */
 export function publishPublicationCandidatesV4(artifactDir, candidates) {
@@ -23,7 +17,6 @@ export function publishPublicationCandidatesV4(artifactDir, candidates) {
             fs.renameSync(file.temp, file.canonical);
             hasReplacedCanonicalPath = true;
         }
-        cleanupRetiredArtifacts(artifactDir);
     }
     catch (error) {
         if (hasReplacedCanonicalPath)
@@ -34,11 +27,7 @@ export function publishPublicationCandidatesV4(artifactDir, candidates) {
     }
 }
 export function cleanupPublicationV4(artifactDir) {
-    removePaths([
-        ...artifactPaths(artifactDir, CANONICAL_NAMES),
-        ...artifactPaths(artifactDir, RETIRED_NAMES),
-        ...ownedTempPaths(artifactDir)
-    ]);
+    removePaths([...artifactPaths(artifactDir, CANONICAL_NAMES), ...ownedTempPaths(artifactDir)]);
 }
 export function cleanupPublicationV4BestEffort(artifactDir) {
     try {
@@ -73,9 +62,6 @@ function cleanupOwnedTempsBestEffort(artifactDir) {
         // Failure cleanup cannot conceal the original publication failure.
     }
 }
-function cleanupRetiredArtifacts(artifactDir) {
-    removePaths(artifactPaths(artifactDir, RETIRED_NAMES));
-}
 function artifactPaths(artifactDir, names) {
     return names.map((name) => join(artifactDir, name));
 }

package/dist/esm/machine-output/v4/atomic-publication.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAU,CAAC;AAChE,MAAM,aAAa,GAAG;IACpB,cAAc;IACd,WAAW;IACX,qBAAqB;IACrB,iBAAiB;CACT,CAAC;AACX,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAarD,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,UAAiC;IAEjC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/E,IAAI,wBAAwB,GAAG,KAAK,CAAC;IACrC,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,wBAAwB,GAAG,IAAI,CAAC;QAClC,CAAC;QACD,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,wBAAwB;YAAE,8BAA8B,CAAC,WAAW,CAAC,CAAC;;YACrE,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,WAAW,CAAC;QACV,GAAG,aAAa,CAAC,WAAW,EAAE,eAAe,CAAC;QAC9C,GAAG,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC;QAC5C,GAAG,cAAc,CAAC,WAAW,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,IAAI,CAAC;QACH,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAmB,EACnB,KAAa,EACb,UAAiC;IAEjC,OAAO;QACL;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;YACxC,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,eAAe,CAAC;SACzE;QACD;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC;YAC9C,QAAQ,EAAE,UAAU,CAAC,aAAa;YAClC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,qBAAqB,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAAC,WAAmB;IACtD,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAmB;IAClD,WAAW,CAAC,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,WAAmB,EAAE,KAAwB;IAClE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,OAAO,EAAE;SACN,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SAC7C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,KAAwB;IAC3C,IAAI,YAAqB,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,YAAY,KAAK,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,YAAY,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC;AACrD,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CANONICAL_NAMES = [\"records.ndjson\", \"run.json\"] as const;\nconst RETIRED_NAMES = [\n  \"metrics.json\",\n  \"report.md\",\n  \"warnings-all.ndjson\",\n  \"warnings.ndjson\"\n] as const;\nconst OWNED_TEMP_PREFIX = \".vibe-check-publication-\";\n\ninterface PublicationCandidatePath {\n  readonly canonical: string;\n  readonly contents: string;\n  readonly temp: string;\n}\n\ninterface PublicationCandidates {\n  readonly recordsNdjson: string;\n  readonly runJson: string;\n}\n\n/** Writes an already validated two-file candidate set through owned temporary paths. */\nexport function publishPublicationCandidatesV4(\n  artifactDir: string,\n  candidates: PublicationCandidates\n): void {\n  fs.mkdirSync(artifactDir, { recursive: true });\n  const files = publicationCandidatePaths(artifactDir, randomUUID(), candidates);\n  let hasReplacedCanonicalPath = false;\n  try {\n    cleanupOwnedTemps(artifactDir);\n    for (const file of files) {\n      fs.writeFileSync(file.temp, file.contents, { encoding: \"utf8\", flag: \"wx\" });\n    }\n    for (const file of files) {\n      fs.renameSync(file.temp, file.canonical);\n      hasReplacedCanonicalPath = true;\n    }\n    cleanupRetiredArtifacts(artifactDir);\n  } catch (error: unknown) {\n    if (hasReplacedCanonicalPath) cleanupPublicationV4BestEffort(artifactDir);\n    else cleanupOwnedTempsBestEffort(artifactDir);\n    throw error;\n  }\n}\n\nexport function cleanupPublicationV4(artifactDir: string): void {\n  removePaths([\n    ...artifactPaths(artifactDir, CANONICAL_NAMES),\n    ...artifactPaths(artifactDir, RETIRED_NAMES),\n    ...ownedTempPaths(artifactDir)\n  ]);\n}\n\nexport function cleanupPublicationV4BestEffort(artifactDir: string): void {\n  try {\n    cleanupPublicationV4(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction publicationCandidatePaths(\n  artifactDir: string,\n  token: string,\n  candidates: PublicationCandidates\n): readonly PublicationCandidatePath[] {\n  return [\n    {\n      canonical: join(artifactDir, \"run.json\"),\n      contents: candidates.runJson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-run.json.tmp`)\n    },\n    {\n      canonical: join(artifactDir, \"records.ndjson\"),\n      contents: candidates.recordsNdjson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-records.ndjson.tmp`)\n    }\n  ];\n}\n\nfunction cleanupOwnedTemps(artifactDir: string): void {\n  removePaths(ownedTempPaths(artifactDir));\n}\n\nfunction cleanupOwnedTempsBestEffort(artifactDir: string): void {\n  try {\n    cleanupOwnedTemps(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction cleanupRetiredArtifacts(artifactDir: string): void {\n  removePaths(artifactPaths(artifactDir, RETIRED_NAMES));\n}\n\nfunction artifactPaths(artifactDir: string, names: readonly string[]): readonly string[] {\n  return names.map((name) => join(artifactDir, name));\n}\n\nfunction ownedTempPaths(artifactDir: string): readonly string[] {\n  return fs\n    .readdirSync(artifactDir, { withFileTypes: true })\n    .filter((entry) => entry.name.startsWith(OWNED_TEMP_PREFIX))\n    .map((entry) => join(artifactDir, entry.name))\n    .sort();\n}\n\nfunction removePaths(paths: readonly string[]): void {\n  let firstFailure: unknown;\n  for (const path of paths) {\n    try {\n      fs.rmSync(path, { force: true, recursive: true });\n    } catch (error: unknown) {\n      firstFailure ??= error;\n    }\n  }\n  if (firstFailure !== undefined) throw firstFailure;\n}\n"]}
+{"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CANONICAL_NAMES = [\"records.ndjson\", \"run.json\"] as const;\nconst OWNED_TEMP_PREFIX = \".vibe-check-publication-\";\n\ninterface PublicationCandidatePath {\n  readonly canonical: string;\n  readonly contents: string;\n  readonly temp: string;\n}\n\ninterface PublicationCandidates {\n  readonly recordsNdjson: string;\n  readonly runJson: string;\n}\n\n/** Writes an already validated two-file candidate set through owned temporary paths. */\nexport function publishPublicationCandidatesV4(\n  artifactDir: string,\n  candidates: PublicationCandidates\n): void {\n  fs.mkdirSync(artifactDir, { recursive: true });\n  const files = publicationCandidatePaths(artifactDir, randomUUID(), candidates);\n  let hasReplacedCanonicalPath = false;\n  try {\n    cleanupOwnedTemps(artifactDir);\n    for (const file of files) {\n      fs.writeFileSync(file.temp, file.contents, { encoding: \"utf8\", flag: \"wx\" });\n    }\n    for (const file of files) {\n      fs.renameSync(file.temp, file.canonical);\n      hasReplacedCanonicalPath = true;\n    }\n  } catch (error: unknown) {\n    if (hasReplacedCanonicalPath) cleanupPublicationV4BestEffort(artifactDir);\n    else cleanupOwnedTempsBestEffort(artifactDir);\n    throw error;\n  }\n}\n\nexport function cleanupPublicationV4(artifactDir: string): void {\n  removePaths([...artifactPaths(artifactDir, CANONICAL_NAMES), ...ownedTempPaths(artifactDir)]);\n}\n\nexport function cleanupPublicationV4BestEffort(artifactDir: string): void {\n  try {\n    cleanupPublicationV4(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction publicationCandidatePaths(\n  artifactDir: string,\n  token: string,\n  candidates: PublicationCandidates\n): readonly PublicationCandidatePath[] {\n  return [\n    {\n      canonical: join(artifactDir, \"run.json\"),\n      contents: candidates.runJson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-run.json.tmp`)\n    },\n    {\n      canonical: join(artifactDir, \"records.ndjson\"),\n      contents: candidates.recordsNdjson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-records.ndjson.tmp`)\n    }\n  ];\n}\n\nfunction cleanupOwnedTemps(artifactDir: string): void {\n  removePaths(ownedTempPaths(artifactDir));\n}\n\nfunction cleanupOwnedTempsBestEffort(artifactDir: string): void {\n  try {\n    cleanupOwnedTemps(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction artifactPaths(artifactDir: string, names: readonly string[]): readonly string[] {\n  return names.map((name) => join(artifactDir, name));\n}\n\nfunction ownedTempPaths(artifactDir: string): readonly string[] {\n  return fs\n    .readdirSync(artifactDir, { withFileTypes: true })\n    .filter((entry) => entry.name.startsWith(OWNED_TEMP_PREFIX))\n    .map((entry) => join(artifactDir, entry.name))\n    .sort();\n}\n\nfunction removePaths(paths: readonly string[]): void {\n  let firstFailure: unknown;\n  for (const path of paths) {\n    try {\n      fs.rmSync(path, { force: true, recursive: true });\n    } catch (error: unknown) {\n      firstFailure ??= error;\n    }\n  }\n  if (firstFailure !== undefined) throw firstFailure;\n}\n"]}