@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/project-run/check-execution/flag-controls.mjs

@@ -0,0 +1,95 @@
+import { diagnosticTags } from "../diagnostic-logging/logger.mjs";
+export const FLAG_CONDITION_NOT_MATCHED_CODE = "flag-condition-not-matched";
+/**
+ * Selects canonical Check IDs for direct flag matches and their opt-in
+ * `dependsOn` closures after complete static graph validation.
+ */
+export function selectEffectiveCheckIds(checks, flags) {
+    const expandedCheckIds = new Set();
+    const selectedCheckIds = new Set();
+    const checksByCheckId = new Map(checks.map((check) => [check.definition.checkId, check]));
+    for (const check of checks) {
+        const enablement = check.enabledByFlags;
+        if (enablement !== undefined && !matchesFlagEnablement(enablement, flags))
+            continue;
+        if (enablement?.propagateDependsOn === true) {
+            selectCheckAndDependsOnClosure(check, checksByCheckId, expandedCheckIds, selectedCheckIds);
+            continue;
+        }
+        selectedCheckIds.add(check.definition.checkId);
+    }
+    return Object.freeze([...selectedCheckIds].sort());
+}
+/** Resolves all flag-controlled outcomes before Scheduler admission or Check-owned work. */
+export function resolveFlagControlSettlements(input) {
+    if (input.signal?.aborted === true)
+        return Object.freeze([]);
+    const settlements = [];
+    const selectedCheckIds = new Set(input.effectiveCheckIds);
+    for (const check of input.checks) {
+        const settlement = resolveFlagControl(check, selectedCheckIds);
+        if (settlement === undefined)
+            continue;
+        settlements.push(settlement);
+        input.diagnosticLogger?.observe({
+            event: "control.resolved",
+            tags: diagnosticTags(`CHECK:${check.definition.checkId}`, "CONTROL", FLAG_CONDITION_NOT_MATCHED_CODE.toUpperCase()),
+            details: {
+                enabledByFlags: check.enabledByFlags,
+                outcome: settlement.outcome
+            }
+        });
+    }
+    return Object.freeze(settlements);
+}
+function resolveFlagControl(check, selectedCheckIds) {
+    if (check.enabledByFlags === undefined || selectedCheckIds.has(check.definition.checkId)) {
+        return undefined;
+    }
+    return Object.freeze({
+        check: Object.freeze({
+            definition: check.definition,
+            omitQuietPassedRow: check.omitQuietPassedRow
+        }),
+        outcome: Object.freeze({
+            status: "not-applicable",
+            reason: Object.freeze({ code: FLAG_CONDITION_NOT_MATCHED_CODE })
+        })
+    });
+}
+function selectCheckAndDependsOnClosure(check, checksByCheckId, expandedCheckIds, selectedCheckIds) {
+    const checkId = check.definition.checkId;
+    if (expandedCheckIds.has(checkId))
+        return;
+    expandedCheckIds.add(checkId);
+    selectedCheckIds.add(checkId);
+    for (const dependencyId of check.dependsOn) {
+        const dependency = checksByCheckId.get(dependencyId);
+        if (dependency === undefined) {
+            throw new Error("Validated Check graph has an unavailable dependency");
+        }
+        selectCheckAndDependsOnClosure(dependency, checksByCheckId, expandedCheckIds, selectedCheckIds);
+    }
+}
+function matchesFlagEnablement(enablement, runFlags) {
+    return matchesFlagCondition(enablement.when, new Set(runFlags));
+}
+function matchesFlagCondition(condition, runFlags) {
+    if (typeof condition === "string")
+        return runFlags.has(condition);
+    switch (condition.kind) {
+        case "all":
+            return condition.conditions.every((child) => matchesFlagCondition(child, runFlags));
+        case "any":
+            return condition.conditions.some((child) => matchesFlagCondition(child, runFlags));
+        case "none":
+            return !condition.conditions.some((child) => matchesFlagCondition(child, runFlags));
+        case "not-all":
+            return !condition.conditions.every((child) => matchesFlagCondition(child, runFlags));
+        case "exactly-one":
+            return (condition.conditions.filter((child) => matchesFlagCondition(child, runFlags)).length === 1);
+        case "not":
+            return !matchesFlagCondition(condition.condition, runFlags);
+    }
+}
+//# sourceMappingURL=flag-controls.mjs.map

package/dist/esm/project-run/check-execution/flag-controls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-controls.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/flag-controls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckFlagCondition } from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport { diagnosticTags, type DiagnosticLogger } from \"../diagnostic-logging/logger.ts\";\n\nexport const FLAG_CONDITION_NOT_MATCHED_CODE = \"flag-condition-not-matched\";\n\ntype FlagControlledCheck = Pick<NormalizedCheck, \"definition\" | \"omitQuietPassedRow\">;\ntype FlagControlOutcome = Readonly<{\n  readonly status: \"not-applicable\";\n  readonly reason: Readonly<{ readonly code: typeof FLAG_CONDITION_NOT_MATCHED_CODE }>;\n}>;\n\nexport type FlagControlSettlement = Readonly<{\n  readonly check: FlagControlledCheck;\n  readonly outcome: FlagControlOutcome;\n}>;\n\n/**\n * Selects canonical Check IDs for direct flag matches and their opt-in\n * `dependsOn` closures after complete static graph validation.\n */\nexport function selectEffectiveCheckIds(\n  checks: readonly NormalizedCheck[],\n  flags: readonly string[]\n): readonly string[] {\n  const expandedCheckIds = new Set<string>();\n  const selectedCheckIds = new Set<string>();\n  const checksByCheckId = new Map(\n    checks.map((check) => [check.definition.checkId, check] as const)\n  );\n\n  for (const check of checks) {\n    const enablement = check.enabledByFlags;\n    if (enablement !== undefined && !matchesFlagEnablement(enablement, flags)) continue;\n\n    if (enablement?.propagateDependsOn === true) {\n      selectCheckAndDependsOnClosure(check, checksByCheckId, expandedCheckIds, selectedCheckIds);\n      continue;\n    }\n    selectedCheckIds.add(check.definition.checkId);\n  }\n\n  return Object.freeze([...selectedCheckIds].sort());\n}\n\n/** Resolves all flag-controlled outcomes before Scheduler admission or Check-owned work. */\nexport function resolveFlagControlSettlements(\n  input: Readonly<{\n    readonly checks: readonly NormalizedCheck[];\n    readonly diagnosticLogger?: DiagnosticLogger;\n    readonly effectiveCheckIds: readonly string[];\n    readonly signal: AbortSignal | undefined;\n  }>\n): readonly FlagControlSettlement[] {\n  if (input.signal?.aborted === true) return Object.freeze([]);\n\n  const settlements: FlagControlSettlement[] = [];\n  const selectedCheckIds = new Set(input.effectiveCheckIds);\n  for (const check of input.checks) {\n    const settlement = resolveFlagControl(check, selectedCheckIds);\n    if (settlement === undefined) continue;\n    settlements.push(settlement);\n    input.diagnosticLogger?.observe({\n      event: \"control.resolved\",\n      tags: diagnosticTags(\n        `CHECK:${check.definition.checkId}`,\n        \"CONTROL\",\n        FLAG_CONDITION_NOT_MATCHED_CODE.toUpperCase()\n      ),\n      details: {\n        enabledByFlags: check.enabledByFlags,\n        outcome: settlement.outcome\n      }\n    });\n  }\n  return Object.freeze(settlements);\n}\n\nfunction resolveFlagControl(\n  check: NormalizedCheck,\n  selectedCheckIds: ReadonlySet<string>\n): FlagControlSettlement | undefined {\n  if (check.enabledByFlags === undefined || selectedCheckIds.has(check.definition.checkId)) {\n    return undefined;\n  }\n  return Object.freeze({\n    check: Object.freeze({\n      definition: check.definition,\n      omitQuietPassedRow: check.omitQuietPassedRow\n    }),\n    outcome: Object.freeze({\n      status: \"not-applicable\",\n      reason: Object.freeze({ code: FLAG_CONDITION_NOT_MATCHED_CODE })\n    })\n  });\n}\n\nfunction selectCheckAndDependsOnClosure(\n  check: NormalizedCheck,\n  checksByCheckId: ReadonlyMap<string, NormalizedCheck>,\n  expandedCheckIds: Set<string>,\n  selectedCheckIds: Set<string>\n): void {\n  const checkId = check.definition.checkId;\n  if (expandedCheckIds.has(checkId)) return;\n  expandedCheckIds.add(checkId);\n  selectedCheckIds.add(checkId);\n\n  for (const dependencyId of check.dependsOn) {\n    const dependency = checksByCheckId.get(dependencyId);\n    if (dependency === undefined) {\n      throw new Error(\"Validated Check graph has an unavailable dependency\");\n    }\n    selectCheckAndDependsOnClosure(dependency, checksByCheckId, expandedCheckIds, selectedCheckIds);\n  }\n}\n\nfunction matchesFlagEnablement(\n  enablement: NonNullable<NormalizedCheck[\"enabledByFlags\"]>,\n  runFlags: readonly string[]\n): boolean {\n  return matchesFlagCondition(enablement.when, new Set(runFlags));\n}\n\nfunction matchesFlagCondition(\n  condition: CheckFlagCondition,\n  runFlags: ReadonlySet<string>\n): boolean {\n  if (typeof condition === \"string\") return runFlags.has(condition);\n  switch (condition.kind) {\n    case \"all\":\n      return condition.conditions.every((child) => matchesFlagCondition(child, runFlags));\n    case \"any\":\n      return condition.conditions.some((child) => matchesFlagCondition(child, runFlags));\n    case \"none\":\n      return !condition.conditions.some((child) => matchesFlagCondition(child, runFlags));\n    case \"not-all\":\n      return !condition.conditions.every((child) => matchesFlagCondition(child, runFlags));\n    case \"exactly-one\":\n      return (\n        condition.conditions.filter((child) => matchesFlagCondition(child, runFlags)).length === 1\n      );\n    case \"not\":\n      return !matchesFlagCondition(condition.condition, runFlags);\n  }\n}\n"]}

package/dist/esm/project-run/check-execution/lifecycle.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.mjs.map

package/dist/esm/project-run/check-execution/lifecycle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/lifecycle.ts"],"names":[],"mappings":"","sourcesContent":["import type { CheckMessage, CheckOutcome } from \"../../check/check.ts\";\nimport type { CoreRecord } from \"../../check-settlement/facts.ts\";\n\n/** Private invocation-wide barrier that is independent from per-Check lifecycle facts. */\nexport type InvocationLifecycle = Readonly<{\n  /** Fires once after Product accepts every flag-control settlement and before Scheduler work. */\n  readonly selectionSettled: () => void;\n}>;\n\n/** Private per-Check lifecycle presentation and accounting channel. */\nexport type CheckExecutionLifecycle = Readonly<{\n  readonly started: (fact: CheckStartedFact) => void;\n  readonly settled: (fact: CheckSettledFact) => void;\n}>;\n\nexport type CheckStartedFact = Readonly<{\n  checkId: string;\n  displayName: string;\n  omitQuietPassedRow: boolean;\n}>;\n\nexport type CheckSettledFact = CheckStartedFact &\n  Readonly<{\n    durationMs: number | null;\n    messages: readonly CheckMessage[];\n    records: readonly CoreRecord[];\n    outcome: CheckOutcome;\n    omitQuietPassedRow: boolean;\n  }>;\n"]}

package/dist/esm/project-run/check-execution/messages.mjs

@@ -1,5 +1,10 @@
 import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
 const EMPTY_MESSAGES = Object.freeze([]);
+/** Preserves phase-local order while avoiding mutable or per-call empty message collections. */
+export function combineCheckMessages(...collections) {
+    const messages = collections.flat();
+    return messages.length === 0 ? EMPTY_MESSAGES : Object.freeze(messages);
+}
 /** Parses the shared closed Check-message attachment without retaining author input. */
 export function parseCheckMessages(value) {
     if (value === undefined)

package/dist/esm/project-run/check-execution/messages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/messages.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElE,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC/C,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAErD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,IACE,OAAO,KAAK,SAAS;QACrB,CAAC,gCAAgC,CAAC,OAAO,EAAE;YACzC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;YACtC,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,CAAC;AACtE,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\n\nconst EMPTY_MESSAGES: readonly CheckMessage[] = Object.freeze([]);\n\n/** Parses the shared closed Check-message attachment without retaining author input. */\nexport function parseCheckMessages(value: unknown): readonly CheckMessage[] | undefined {\n  if (value === undefined) return EMPTY_MESSAGES;\n  const authoredMessages = snapshotClosedArray(value);\n  if (authoredMessages === undefined) return undefined;\n\n  const messages: CheckMessage[] = [];\n  for (const authoredMessage of authoredMessages) {\n    const message = detachedMessage(authoredMessage);\n    if (message === undefined) return undefined;\n    messages.push(message);\n  }\n  return messages.length === 0 ? EMPTY_MESSAGES : Object.freeze(messages);\n}\n\nfunction detachedMessage(value: unknown): CheckMessage | undefined {\n  const message = snapshotClosedRecord(value);\n  if (\n    message === undefined ||\n    !hasRequiredAndOptionalRecordKeys(message, {\n      required: [\"level\", \"code\", \"message\"],\n      optional: []\n    }) ||\n    !isCheckMessageLevel(message.level) ||\n    typeof message.code !== \"string\" ||\n    message.code.length === 0 ||\n    typeof message.message !== \"string\" ||\n    message.message.length === 0\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ code: message.code, level: message.level, message: message.message });\n}\n\nfunction isCheckMessageLevel(value: unknown): value is CheckMessage[\"level\"] {\n  return value === \"info\" || value === \"warning\" || value === \"error\";\n}\n"]}
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/messages.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElE,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAClC,GAAG,WAAiD;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC/C,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAErD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,IACE,OAAO,KAAK,SAAS;QACrB,CAAC,gCAAgC,CAAC,OAAO,EAAE;YACzC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;YACtC,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,CAAC;AACtE,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\n\nconst EMPTY_MESSAGES: readonly CheckMessage[] = Object.freeze([]);\n\n/** Preserves phase-local order while avoiding mutable or per-call empty message collections. */\nexport function combineCheckMessages(\n  ...collections: readonly (readonly CheckMessage[])[]\n): readonly CheckMessage[] {\n  const messages = collections.flat();\n  return messages.length === 0 ? EMPTY_MESSAGES : Object.freeze(messages);\n}\n\n/** Parses the shared closed Check-message attachment without retaining author input. */\nexport function parseCheckMessages(value: unknown): readonly CheckMessage[] | undefined {\n  if (value === undefined) return EMPTY_MESSAGES;\n  const authoredMessages = snapshotClosedArray(value);\n  if (authoredMessages === undefined) return undefined;\n\n  const messages: CheckMessage[] = [];\n  for (const authoredMessage of authoredMessages) {\n    const message = detachedMessage(authoredMessage);\n    if (message === undefined) return undefined;\n    messages.push(message);\n  }\n  return messages.length === 0 ? EMPTY_MESSAGES : Object.freeze(messages);\n}\n\nfunction detachedMessage(value: unknown): CheckMessage | undefined {\n  const message = snapshotClosedRecord(value);\n  if (\n    message === undefined ||\n    !hasRequiredAndOptionalRecordKeys(message, {\n      required: [\"level\", \"code\", \"message\"],\n      optional: []\n    }) ||\n    !isCheckMessageLevel(message.level) ||\n    typeof message.code !== \"string\" ||\n    message.code.length === 0 ||\n    typeof message.message !== \"string\" ||\n    message.message.length === 0\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ code: message.code, level: message.level, message: message.message });\n}\n\nfunction isCheckMessageLevel(value: unknown): value is CheckMessage[\"level\"] {\n  return value === \"info\" || value === \"warning\" || value === \"error\";\n}\n"]}

package/dist/esm/project-run/check-execution/plan.mjs

@@ -1,22 +1,26 @@
+import { EMPTY_RESOURCE_UNIT_MAPPING } from "../../project-definition/resource-unit-mapping.mjs";
 /**
  * Pure executable-Check projection. Check ids are the only scheduler Task
  * identities: containment has already been resolved by Definition and has no
  * runtime alias or completion semantics here.
  */
-export function planStaticCheckGraph(checks, options = {}) {
-    const alreadySettledCheckIds = options.alreadySettledCheckIds ?? new Set();
-    const tasks = checks.map((check) => taskForCheck(check, alreadySettledCheckIds));
+export function planStaticCheckGraph(checks, resourceCapacities = EMPTY_RESOURCE_UNIT_MAPPING) {
+    const tasks = checks.map(taskForCheck);
     const scopes = checks.map(scopeForCheck);
     return Object.freeze({
+        resourceCapacities,
         tasks: Object.freeze(tasks),
         scopes: Object.freeze(scopes)
     });
 }
-function taskForCheck(check, alreadySettledCheckIds) {
+function taskForCheck(check) {
     return Object.freeze({
-        dependsOn: check.dependsOn.filter((checkId) => !alreadySettledCheckIds.has(checkId)),
+        admissionPriority: check.admissionPriority,
+        dependsOn: check.dependsOn,
         id: check.definition.checkId,
         mutex: check.mutex,
+        observes: check.observes,
+        resourceClaims: check.resourceClaims,
         scopeId: scopeIdFor(check)
     });
 }

package/dist/esm/project-run/check-execution/plan.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plan.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/plan.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkC,EAClC,OAAO,GAAwE,EAAE;IAEjF,MAAM,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,IAAI,IAAI,GAAG,EAAU,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,KAAsB,EACtB,sBAA2C;IAE3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpF,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAsB;IACxC,OAAO,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;AAC7C,CAAC","sourcesContent":["import type { TaskGraph, TaskNode, TaskScope } from \"../task-scheduler/graph.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\n\n/**\n * Pure executable-Check projection. Check ids are the only scheduler Task\n * identities: containment has already been resolved by Definition and has no\n * runtime alias or completion semantics here.\n */\nexport function planStaticCheckGraph(\n  checks: readonly NormalizedCheck[],\n  options: Readonly<{ readonly alreadySettledCheckIds?: ReadonlySet<string> }> = {}\n): TaskGraph {\n  const alreadySettledCheckIds = options.alreadySettledCheckIds ?? new Set<string>();\n  const tasks = checks.map((check) => taskForCheck(check, alreadySettledCheckIds));\n  const scopes = checks.map(scopeForCheck);\n  return Object.freeze({\n    tasks: Object.freeze(tasks),\n    scopes: Object.freeze(scopes)\n  });\n}\n\nfunction taskForCheck(\n  check: NormalizedCheck,\n  alreadySettledCheckIds: ReadonlySet<string>\n): TaskNode {\n  return Object.freeze({\n    dependsOn: check.dependsOn.filter((checkId) => !alreadySettledCheckIds.has(checkId)),\n    id: check.definition.checkId,\n    mutex: check.mutex,\n    scopeId: scopeIdFor(check)\n  });\n}\n\nfunction scopeForCheck(check: NormalizedCheck): TaskScope {\n  const taskId = check.definition.checkId;\n  return Object.freeze({\n    activationTaskIds: Object.freeze([taskId]),\n    id: scopeIdFor(check),\n    maxParallel: check.maxParallel,\n    terminalTaskId: taskId\n  });\n}\n\nfunction scopeIdFor(check: NormalizedCheck): string {\n  return `check/${check.definition.checkId}`;\n}\n"]}
+{"version":3,"file":"plan.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/plan.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAE5B,MAAM,mDAAmD,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkC,EAClC,kBAAkB,GAAwB,2BAA2B;IAErE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,kBAAkB;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAsB;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAsB;IACxC,OAAO,SAAS,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;AAC7C,CAAC","sourcesContent":["import type { TaskGraph, TaskNode, TaskScope } from \"../task-scheduler/graph.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport {\n  EMPTY_RESOURCE_UNIT_MAPPING,\n  type ResourceUnitMapping\n} from \"../../project-definition/resource-unit-mapping.ts\";\n\n/**\n * Pure executable-Check projection. Check ids are the only scheduler Task\n * identities: containment has already been resolved by Definition and has no\n * runtime alias or completion semantics here.\n */\nexport function planStaticCheckGraph(\n  checks: readonly NormalizedCheck[],\n  resourceCapacities: ResourceUnitMapping = EMPTY_RESOURCE_UNIT_MAPPING\n): TaskGraph {\n  const tasks = checks.map(taskForCheck);\n  const scopes = checks.map(scopeForCheck);\n  return Object.freeze({\n    resourceCapacities,\n    tasks: Object.freeze(tasks),\n    scopes: Object.freeze(scopes)\n  });\n}\n\nfunction taskForCheck(check: NormalizedCheck): TaskNode {\n  return Object.freeze({\n    admissionPriority: check.admissionPriority,\n    dependsOn: check.dependsOn,\n    id: check.definition.checkId,\n    mutex: check.mutex,\n    observes: check.observes,\n    resourceClaims: check.resourceClaims,\n    scopeId: scopeIdFor(check)\n  });\n}\n\nfunction scopeForCheck(check: NormalizedCheck): TaskScope {\n  const taskId = check.definition.checkId;\n  return Object.freeze({\n    activationTaskIds: Object.freeze([taskId]),\n    id: scopeIdFor(check),\n    maxParallel: check.maxParallel,\n    terminalTaskId: taskId\n  });\n}\n\nfunction scopeIdFor(check: NormalizedCheck): string {\n  return `check/${check.definition.checkId}`;\n}\n"]}

package/dist/esm/project-run/check-execution/{preflight-result.mjs → preparation-result.mjs}

@@ -1,25 +1,25 @@
 import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
 import { parseCheckMessages } from "./messages.mjs";
-/** Parses the closed result vocabulary returned by one trusted Check preflight. */
-export function parseCheckPreflightResult(value) {
-    const preflightResult = snapshotClosedRecord(value);
-    if (preflightResult === undefined) {
+/** Parses the closed result vocabulary returned by one trusted Check preparation. */
+export function parseCheckPreparationResult(value) {
+    const preparationResult = snapshotClosedRecord(value);
+    if (preparationResult === undefined) {
         return undefined;
     }
-    const messages = parseCheckMessages(preflightResult.messages);
+    const messages = parseCheckMessages(preparationResult.messages);
     if (messages === undefined)
         return undefined;
-    switch (preflightResult.status) {
+    switch (preparationResult.status) {
         case "success":
-            return parseSuccessfulPreflight(preflightResult, messages);
+            return parseSuccessfulPreparation(preparationResult, messages);
         case "failure":
-            return parseFailedPreflight(preflightResult, messages);
+            return parseFailedPreparation(preparationResult, messages);
         default:
             return undefined;
     }
 }
-function parseSuccessfulPreflight(preflightResult, messages) {
-    if (!hasRequiredAndOptionalRecordKeys(preflightResult, {
+function parseSuccessfulPreparation(preparationResult, messages) {
+    if (!hasRequiredAndOptionalRecordKeys(preparationResult, {
         optional: ["messages"],
         required: ["status", "preparedOptions"]
     })) {
@@ -27,27 +27,27 @@ function parseSuccessfulPreflight(preflightResult, messages) {
     }
     return Object.freeze({
         status: "success",
-        preparedOptions: preflightResult.preparedOptions,
+        preparedOptions: preparationResult.preparedOptions,
         messages
     });
 }
-function parseFailedPreflight(preflightResult, messages) {
-    if (typeof preflightResult.action !== "string")
+function parseFailedPreparation(preparationResult, messages) {
+    if (typeof preparationResult.action !== "string")
         return undefined;
-    const reason = parsePreflightReason(preflightResult.reason);
+    const reason = parsePreparationReason(preparationResult.reason);
     if (reason === undefined)
         return undefined;
-    switch (preflightResult.action) {
+    switch (preparationResult.action) {
         case "block":
-            return parseBlockedPreflight(preflightResult, reason, messages);
+            return parseBlockedPreparation(preparationResult, reason, messages);
         case "continue":
-            return parseContinuedPreflight(preflightResult, reason, messages);
+            return parseContinuedPreparation(preparationResult, reason, messages);
         default:
             return undefined;
     }
 }
-function parseBlockedPreflight(preflightResult, reason, messages) {
-    if (!hasRequiredAndOptionalRecordKeys(preflightResult, {
+function parseBlockedPreparation(preparationResult, reason, messages) {
+    if (!hasRequiredAndOptionalRecordKeys(preparationResult, {
         optional: ["messages"],
         required: ["status", "action", "reason"]
     })) {
@@ -55,8 +55,8 @@ function parseBlockedPreflight(preflightResult, reason, messages) {
     }
     return Object.freeze({ status: "failure", action: "block", reason, messages });
 }
-function parseContinuedPreflight(preflightResult, reason, messages) {
-    if (!hasRequiredAndOptionalRecordKeys(preflightResult, {
+function parseContinuedPreparation(preparationResult, reason, messages) {
+    if (!hasRequiredAndOptionalRecordKeys(preparationResult, {
         optional: ["messages"],
         required: ["status", "action", "fallback", "reason"]
     })) {
@@ -65,12 +65,12 @@ function parseContinuedPreflight(preflightResult, reason, messages) {
     return Object.freeze({
         status: "failure",
         action: "continue",
-        fallback: preflightResult.fallback,
+        fallback: preparationResult.fallback,
         reason,
         messages
     });
 }
-function parsePreflightReason(value) {
+function parsePreparationReason(value) {
     const reason = snapshotClosedRecord(value);
     if (reason === undefined ||
         Object.keys(reason).length !== 1 ||
@@ -80,4 +80,4 @@ function parsePreflightReason(value) {
     }
     return Object.freeze({ code: reason.code });
 }
-//# sourceMappingURL=preflight-result.mjs.map
+//# sourceMappingURL=preparation-result.mjs.map

package/dist/esm/project-run/check-execution/preparation-result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation-result.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/preparation-result.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport type { CheckMessage } from \"../../check/check.ts\";\nimport { parseCheckMessages } from \"./messages.ts\";\n\nexport type ParsedCheckPreparationResult =\n  | Readonly<{\n      readonly status: \"success\";\n      readonly preparedOptions: unknown;\n      readonly messages: readonly CheckMessage[];\n    }>\n  | Readonly<{\n      readonly status: \"failure\";\n      readonly action: \"block\";\n      readonly reason: { readonly code: string };\n      readonly messages: readonly CheckMessage[];\n    }>\n  | Readonly<{\n      readonly status: \"failure\";\n      readonly action: \"continue\";\n      readonly fallback: unknown;\n      readonly reason: { readonly code: string };\n      readonly messages: readonly CheckMessage[];\n    }>;\n\n/** Parses the closed result vocabulary returned by one trusted Check preparation. */\nexport function parseCheckPreparationResult(\n  value: unknown\n): ParsedCheckPreparationResult | undefined {\n  const preparationResult = snapshotClosedRecord(value);\n  if (preparationResult === undefined) {\n    return undefined;\n  }\n  const messages = parseCheckMessages(preparationResult.messages);\n  if (messages === undefined) return undefined;\n  switch (preparationResult.status) {\n    case \"success\":\n      return parseSuccessfulPreparation(preparationResult, messages);\n    case \"failure\":\n      return parseFailedPreparation(preparationResult, messages);\n    default:\n      return undefined;\n  }\n}\n\nfunction parseSuccessfulPreparation(\n  preparationResult: Readonly<Record<string, unknown>>,\n  messages: readonly CheckMessage[]\n): ParsedCheckPreparationResult | undefined {\n  if (\n    !hasRequiredAndOptionalRecordKeys(preparationResult, {\n      optional: [\"messages\"],\n      required: [\"status\", \"preparedOptions\"]\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    status: \"success\",\n    preparedOptions: preparationResult.preparedOptions,\n    messages\n  });\n}\n\nfunction parseFailedPreparation(\n  preparationResult: Readonly<Record<string, unknown>>,\n  messages: readonly CheckMessage[]\n): ParsedCheckPreparationResult | undefined {\n  if (typeof preparationResult.action !== \"string\") return undefined;\n  const reason = parsePreparationReason(preparationResult.reason);\n  if (reason === undefined) return undefined;\n  switch (preparationResult.action) {\n    case \"block\":\n      return parseBlockedPreparation(preparationResult, reason, messages);\n    case \"continue\":\n      return parseContinuedPreparation(preparationResult, reason, messages);\n    default:\n      return undefined;\n  }\n}\n\nfunction parseBlockedPreparation(\n  preparationResult: Readonly<Record<string, unknown>>,\n  reason: Readonly<{ readonly code: string }>,\n  messages: readonly CheckMessage[]\n): ParsedCheckPreparationResult | undefined {\n  if (\n    !hasRequiredAndOptionalRecordKeys(preparationResult, {\n      optional: [\"messages\"],\n      required: [\"status\", \"action\", \"reason\"]\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ status: \"failure\", action: \"block\", reason, messages });\n}\n\nfunction parseContinuedPreparation(\n  preparationResult: Readonly<Record<string, unknown>>,\n  reason: Readonly<{ readonly code: string }>,\n  messages: readonly CheckMessage[]\n): ParsedCheckPreparationResult | undefined {\n  if (\n    !hasRequiredAndOptionalRecordKeys(preparationResult, {\n      optional: [\"messages\"],\n      required: [\"status\", \"action\", \"fallback\", \"reason\"]\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    status: \"failure\",\n    action: \"continue\" as const,\n    fallback: preparationResult.fallback,\n    reason,\n    messages\n  });\n}\n\nfunction parsePreparationReason(value: unknown): Readonly<{ readonly code: string }> | undefined {\n  const reason = snapshotClosedRecord(value);\n  if (\n    reason === undefined ||\n    Object.keys(reason).length !== 1 ||\n    typeof reason.code !== \"string\" ||\n    reason.code.length === 0\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ code: reason.code });\n}\n"]}

package/dist/esm/project-run/check-execution/preparation.mjs

@@ -0,0 +1,172 @@
+import { snapshotJsonObject } from "../../check/options-snapshot.mjs";
+import { diagnosticTags, summarizeDiagnosticValue } from "../diagnostic-logging/logger.mjs";
+import { parseCheckPreparationResult } from "./preparation-result.mjs";
+import { invokeWithCapturedConsole } from "./console-capture.mjs";
+import { combineCheckMessages } from "./messages.mjs";
+const EMPTY_MESSAGES = Object.freeze([]);
+const INERT_SIGNAL = new AbortController().signal;
+/** Resolves one Check's task-local preparation after Scheduler admission. */
+export async function prepareCheck(input) {
+    if (input.signal?.aborted === true) {
+        return observeBlockedPreparation({
+            check: input.check,
+            diagnosticLogger: input.diagnosticLogger,
+            details: {},
+            result: "cancelled-before-callback",
+            reasonCode: "execution-cancelled"
+        });
+    }
+    if (input.check.prepare === undefined) {
+        return resolveAuthoredOptions(input);
+    }
+    return resolvePreparationInvocation(input, await invokePreparation(input));
+}
+function resolveAuthoredOptions(input) {
+    const resolution = readyResolution({
+        authoredCheck: input.check,
+        messages: EMPTY_MESSAGES,
+        preparedOptions: input.check.options
+    });
+    observeReadyOrMalformedResolution(input.diagnosticLogger, input.check.definition.checkId, resolution, "skipped", { source: "authored" });
+    return resolution;
+}
+function resolvePreparationInvocation(input, invocation) {
+    if (invocation.kind === "threw") {
+        return observeBlockedPreparation({
+            check: input.check,
+            diagnosticLogger: input.diagnosticLogger,
+            details: { error: invocation.error },
+            messages: invocation.messages,
+            result: input.signal?.aborted === true ? "cancelled-after-throw" : "threw",
+            reasonCode: input.signal?.aborted === true ? "execution-cancelled" : "preparation-threw"
+        });
+    }
+    return resolveReturnedPreparation(input, invocation.output, invocation.messages);
+}
+function resolveReturnedPreparation(input, preparationOutput, consoleMessages) {
+    if (input.signal?.aborted === true) {
+        return observeBlockedPreparation({
+            check: input.check,
+            diagnosticLogger: input.diagnosticLogger,
+            details: { raw: preparationOutput },
+            messages: consoleMessages,
+            result: "cancelled-after-callback",
+            reasonCode: "execution-cancelled"
+        });
+    }
+    const preparationResult = parseCheckPreparationResult(preparationOutput);
+    if (preparationResult === undefined) {
+        return observeBlockedPreparation({
+            check: input.check,
+            diagnosticLogger: input.diagnosticLogger,
+            details: { raw: preparationOutput },
+            messages: consoleMessages,
+            result: "malformed",
+            reasonCode: "invalid-preparation-result"
+        });
+    }
+    if (preparationResult.status === "failure" && preparationResult.action === "block") {
+        return resolveBlockedPreparationResult(input, preparationResult, consoleMessages);
+    }
+    return resolveReadyPreparationResult(input, preparationOutput, preparationResult, consoleMessages);
+}
+function resolveBlockedPreparationResult(input, preparationResult, consoleMessages) {
+    const resolution = blockedResolution({
+        check: input.check,
+        messages: combineCheckMessages(consoleMessages, preparationResult.messages),
+        reasonCode: preparationResult.reason.code
+    });
+    observePreparationResolution(input.diagnosticLogger, input.check.definition.checkId, resolution, "blocked", {
+        ...(preparationResult.messages.length === 0 ? {} : { messages: preparationResult.messages }),
+        reason: preparationResult.reason
+    });
+    return resolution;
+}
+function resolveReadyPreparationResult(input, preparationOutput, preparationResult, consoleMessages) {
+    const checkId = input.check.definition.checkId;
+    const result = preparationResult.status === "success" ? "prepared" : "continued";
+    const resolution = readyResolution({
+        authoredCheck: input.check,
+        messages: combineCheckMessages(consoleMessages, preparationResult.messages),
+        preparedOptions: preparationResult.status === "success"
+            ? preparationResult.preparedOptions
+            : preparationResult.fallback
+    });
+    observeReadyOrMalformedResolution(input.diagnosticLogger, checkId, resolution, result, {
+        messages: preparationResult.messages,
+        ...(preparationResult.status === "success" ? {} : { reason: preparationResult.reason }),
+        raw: preparationOutput
+    });
+    return resolution;
+}
+async function invokePreparation(input) {
+    return invokeWithCapturedConsole(() => input.check.prepare(input.check.options, input.signal ?? INERT_SIGNAL, input.project));
+}
+function observeBlockedPreparation(input) {
+    const resolution = blockedResolution({
+        check: input.check,
+        messages: input.messages ?? EMPTY_MESSAGES,
+        reasonCode: input.reasonCode
+    });
+    observePreparationResolution(input.diagnosticLogger, input.check.definition.checkId, resolution, input.result, input.details);
+    return resolution;
+}
+function observeReadyOrMalformedResolution(diagnosticLogger, checkId, resolution, result, details) {
+    if (resolution.kind === "blocked") {
+        observePreparationResolution(diagnosticLogger, checkId, resolution, "malformed", {
+            raw: "raw" in details ? details.raw : summarizeDiagnosticValue(details)
+        });
+        return;
+    }
+    const messages = "messages" in details ? details.messages : EMPTY_MESSAGES;
+    observePreparationResolution(diagnosticLogger, checkId, resolution, result, {
+        ...(Array.isArray(messages) && messages.length > 0 ? { messages } : {}),
+        options: summarizeDiagnosticValue(resolution.check.options),
+        ...("reason" in details ? { reason: details.reason } : {}),
+        ...("source" in details ? { source: details.source } : {})
+    });
+}
+function observePreparationResolution(diagnosticLogger, checkId, resolution, result, details) {
+    diagnosticLogger?.observe({
+        event: "preparation.resolved",
+        tags: diagnosticTags(`CHECK:${checkId}`, "PREPARATION", result.toUpperCase()),
+        details: {
+            ...details,
+            ...(resolution.kind === "blocked" ? { outcome: resolution.outcome } : {})
+        }
+    });
+}
+function readyResolution(input) {
+    const preparedOptions = snapshotJsonObject(input.preparedOptions);
+    if (preparedOptions === undefined) {
+        return blockedResolution({
+            check: input.authoredCheck,
+            messages: input.messages,
+            reasonCode: "invalid-preparation-result"
+        });
+    }
+    const { prepare: _preparation, ...check } = input.authoredCheck;
+    return Object.freeze({
+        kind: "ready",
+        check: Object.freeze({
+            ...check,
+            options: preparedOptions,
+            preparationMessages: input.messages
+        })
+    });
+}
+function blockedResolution(input) {
+    return Object.freeze({
+        kind: "blocked",
+        check: Object.freeze({
+            definition: input.check.definition,
+            preparationMessages: input.messages,
+            omitQuietPassedRow: input.check.omitQuietPassedRow
+        }),
+        outcome: Object.freeze({
+            status: "unavailable",
+            reason: Object.freeze({ code: input.reasonCode })
+        })
+    });
+}
+//# sourceMappingURL=preparation.mjs.map

package/dist/esm/project-run/check-execution/preparation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/preparation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,cAAc,EACd,wBAAwB,EAEzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAE5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAClE,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;AA2ClD,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,yBAAyB,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,2BAA2B;YACnC,UAAU,EAAE,qBAAqB;SAClC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,4BAA4B,CAAC,KAAK,EAAE,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAwB;IACtD,MAAM,UAAU,GAAG,eAAe,CAAC;QACjC,aAAa,EAAE,KAAK,CAAC,KAAK;QAC1B,QAAQ,EAAE,cAAc;QACxB,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;KACrC,CAAC,CAAC;IACH,iCAAiC,CAC/B,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAC9B,UAAU,EACV,SAAS,EACT,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAwB,EACxB,UAAiC;IAEjC,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,yBAAyB,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE;YACpC,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO;YAC1E,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB;SACzF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAwB,EACxB,iBAA0B,EAC1B,eAAwC;IAExC,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,yBAAyB,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,OAAO,EAAE,EAAE,GAAG,EAAE,iBAAiB,EAAE;YACnC,QAAQ,EAAE,eAAe;YACzB,MAAM,EAAE,0BAA0B;YAClC,UAAU,EAAE,qBAAqB;SAClC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IACzE,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,yBAAyB,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,OAAO,EAAE,EAAE,GAAG,EAAE,iBAAiB,EAAE;YACnC,QAAQ,EAAE,eAAe;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,4BAA4B;SACzC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,iBAAiB,CAAC,MAAM,KAAK,SAAS,IAAI,iBAAiB,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACnF,OAAO,+BAA+B,CAAC,KAAK,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,6BAA6B,CAClC,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAwB,EACxB,iBAAsF,EACtF,eAAwC;IAExC,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,oBAAoB,CAAC,eAAe,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QAC3E,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI;KAC1C,CAAC,CAAC;IACH,4BAA4B,CAC1B,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAC9B,UAAU,EACV,SAAS,EACT;QACE,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QAC5F,MAAM,EAAE,iBAAiB,CAAC,MAAM;KACjC,CACF,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAwB,EACxB,iBAA0B,EAC1B,iBAAsF,EACtF,eAAwC;IAExC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;IACjF,MAAM,UAAU,GAAG,eAAe,CAAC;QACjC,aAAa,EAAE,KAAK,CAAC,KAAK;QAC1B,QAAQ,EAAE,oBAAoB,CAAC,eAAe,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QAC3E,eAAe,EACb,iBAAiB,CAAC,MAAM,KAAK,SAAS;YACpC,CAAC,CAAC,iBAAiB,CAAC,eAAe;YACnC,CAAC,CAAC,iBAAiB,CAAC,QAAQ;KACjC,CAAC,CAAC;IACH,iCAAiC,CAAC,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QACrF,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;QACpC,GAAG,CAAC,iBAAiB,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,CAAC;QACvF,GAAG,EAAE,iBAAiB;KACvB,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,KAAwB;IACvD,OAAO,yBAAyB,CAAC,GAAG,EAAE,CACpC,KAAK,CAAC,KAAK,CAAC,OAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CACvF,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,KAOE;IAEF,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,cAAc;QAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,4BAA4B,CAC1B,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAC9B,UAAU,EACV,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,CACd,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,iCAAiC,CACxC,gBAA8C,EAC9C,OAAe,EACf,UAAsC,EACtC,MAA4C,EAC5C,OAA0C;IAE1C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,4BAA4B,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE;YAC/E,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC;SACxE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC;IAC3E,4BAA4B,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QAC1E,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,wBAAwB,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAC3D,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CACnC,gBAA8C,EAC9C,OAAe,EACf,UAAsC,EACtC,MAAmC,EACnC,OAA0C;IAE1C,gBAAgB,EAAE,OAAO,CAAC;QACxB,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,cAAc,CAAC,SAAS,OAAO,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC7E,OAAO,EAAE;YACP,GAAG,OAAO;YACV,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAIE;IAEF,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,iBAAiB,CAAC;YACvB,KAAK,EAAE,KAAK,CAAC,aAAa;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,4BAA4B;SACzC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,KAAK;YACR,OAAO,EAAE,eAAe;YACxB,mBAAmB,EAAE,KAAK,CAAC,QAAQ;SACpC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,KAIE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;YAClC,mBAAmB,EAAE,KAAK,CAAC,QAAQ;YACnC,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,kBAAkB;SACnD,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;SAClD,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage, CheckOutcome, CheckProjectContext } from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport { snapshotJsonObject } from \"../../check/options-snapshot.ts\";\nimport {\n  diagnosticTags,\n  summarizeDiagnosticValue,\n  type DiagnosticLogger\n} from \"../diagnostic-logging/logger.ts\";\nimport {\n  parseCheckPreparationResult,\n  type ParsedCheckPreparationResult\n} from \"./preparation-result.ts\";\nimport { invokeWithCapturedConsole } from \"./console-capture.ts\";\nimport { combineCheckMessages } from \"./messages.ts\";\n\nconst EMPTY_MESSAGES: readonly CheckMessage[] = Object.freeze([]);\nconst INERT_SIGNAL = new AbortController().signal;\n\nexport type PreparedCheck = Omit<NormalizedCheck, \"options\" | \"prepare\"> &\n  Readonly<{ readonly options: object; readonly preparationMessages: readonly CheckMessage[] }>;\n\ntype BlockedCheck = Pick<NormalizedCheck, \"definition\" | \"omitQuietPassedRow\"> &\n  Readonly<{ readonly preparationMessages: readonly CheckMessage[] }>;\n\nexport type ReadyCheckPreparationResolution = Readonly<{\n  readonly kind: \"ready\";\n  readonly check: PreparedCheck;\n}>;\n\nexport type BlockedCheckPreparationResolution = Readonly<{\n  readonly kind: \"blocked\";\n  readonly check: BlockedCheck;\n  readonly outcome: CheckOutcome;\n}>;\n\nexport type CheckPreparationResolution =\n  | ReadyCheckPreparationResolution\n  | BlockedCheckPreparationResolution;\n\ntype PreparationResolutionResult =\n  | \"skipped\"\n  | \"prepared\"\n  | \"continued\"\n  | \"blocked\"\n  | \"cancelled-before-callback\"\n  | \"cancelled-after-callback\"\n  | \"cancelled-after-throw\"\n  | \"threw\"\n  | \"malformed\";\n\ntype PrepareCheckInput = Readonly<{\n  readonly check: NormalizedCheck;\n  readonly diagnosticLogger: DiagnosticLogger | undefined;\n  readonly project: CheckProjectContext;\n  readonly signal: AbortSignal | undefined;\n}>;\n\ntype PreparationInvocation = Awaited<ReturnType<typeof invokeWithCapturedConsole<unknown>>>;\n\n/** Resolves one Check's task-local preparation after Scheduler admission. */\nexport async function prepareCheck(input: PrepareCheckInput): Promise<CheckPreparationResolution> {\n  if (input.signal?.aborted === true) {\n    return observeBlockedPreparation({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: {},\n      result: \"cancelled-before-callback\",\n      reasonCode: \"execution-cancelled\"\n    });\n  }\n  if (input.check.prepare === undefined) {\n    return resolveAuthoredOptions(input);\n  }\n  return resolvePreparationInvocation(input, await invokePreparation(input));\n}\n\nfunction resolveAuthoredOptions(input: PrepareCheckInput): CheckPreparationResolution {\n  const resolution = readyResolution({\n    authoredCheck: input.check,\n    messages: EMPTY_MESSAGES,\n    preparedOptions: input.check.options\n  });\n  observeReadyOrMalformedResolution(\n    input.diagnosticLogger,\n    input.check.definition.checkId,\n    resolution,\n    \"skipped\",\n    { source: \"authored\" }\n  );\n  return resolution;\n}\n\nfunction resolvePreparationInvocation(\n  input: PrepareCheckInput,\n  invocation: PreparationInvocation\n): CheckPreparationResolution {\n  if (invocation.kind === \"threw\") {\n    return observeBlockedPreparation({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { error: invocation.error },\n      messages: invocation.messages,\n      result: input.signal?.aborted === true ? \"cancelled-after-throw\" : \"threw\",\n      reasonCode: input.signal?.aborted === true ? \"execution-cancelled\" : \"preparation-threw\"\n    });\n  }\n  return resolveReturnedPreparation(input, invocation.output, invocation.messages);\n}\n\nfunction resolveReturnedPreparation(\n  input: PrepareCheckInput,\n  preparationOutput: unknown,\n  consoleMessages: readonly CheckMessage[]\n): CheckPreparationResolution {\n  if (input.signal?.aborted === true) {\n    return observeBlockedPreparation({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { raw: preparationOutput },\n      messages: consoleMessages,\n      result: \"cancelled-after-callback\",\n      reasonCode: \"execution-cancelled\"\n    });\n  }\n  const preparationResult = parseCheckPreparationResult(preparationOutput);\n  if (preparationResult === undefined) {\n    return observeBlockedPreparation({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { raw: preparationOutput },\n      messages: consoleMessages,\n      result: \"malformed\",\n      reasonCode: \"invalid-preparation-result\"\n    });\n  }\n  if (preparationResult.status === \"failure\" && preparationResult.action === \"block\") {\n    return resolveBlockedPreparationResult(input, preparationResult, consoleMessages);\n  }\n  return resolveReadyPreparationResult(\n    input,\n    preparationOutput,\n    preparationResult,\n    consoleMessages\n  );\n}\n\nfunction resolveBlockedPreparationResult(\n  input: PrepareCheckInput,\n  preparationResult: Extract<ParsedCheckPreparationResult, { readonly action: \"block\" }>,\n  consoleMessages: readonly CheckMessage[]\n): CheckPreparationResolution {\n  const resolution = blockedResolution({\n    check: input.check,\n    messages: combineCheckMessages(consoleMessages, preparationResult.messages),\n    reasonCode: preparationResult.reason.code\n  });\n  observePreparationResolution(\n    input.diagnosticLogger,\n    input.check.definition.checkId,\n    resolution,\n    \"blocked\",\n    {\n      ...(preparationResult.messages.length === 0 ? {} : { messages: preparationResult.messages }),\n      reason: preparationResult.reason\n    }\n  );\n  return resolution;\n}\n\nfunction resolveReadyPreparationResult(\n  input: PrepareCheckInput,\n  preparationOutput: unknown,\n  preparationResult: Exclude<ParsedCheckPreparationResult, { readonly action: \"block\" }>,\n  consoleMessages: readonly CheckMessage[]\n): CheckPreparationResolution {\n  const checkId = input.check.definition.checkId;\n  const result = preparationResult.status === \"success\" ? \"prepared\" : \"continued\";\n  const resolution = readyResolution({\n    authoredCheck: input.check,\n    messages: combineCheckMessages(consoleMessages, preparationResult.messages),\n    preparedOptions:\n      preparationResult.status === \"success\"\n        ? preparationResult.preparedOptions\n        : preparationResult.fallback\n  });\n  observeReadyOrMalformedResolution(input.diagnosticLogger, checkId, resolution, result, {\n    messages: preparationResult.messages,\n    ...(preparationResult.status === \"success\" ? {} : { reason: preparationResult.reason }),\n    raw: preparationOutput\n  });\n  return resolution;\n}\n\nasync function invokePreparation(input: PrepareCheckInput): Promise<PreparationInvocation> {\n  return invokeWithCapturedConsole(() =>\n    input.check.prepare!(input.check.options, input.signal ?? INERT_SIGNAL, input.project)\n  );\n}\n\nfunction observeBlockedPreparation(\n  input: Readonly<{\n    readonly check: NormalizedCheck;\n    readonly diagnosticLogger: DiagnosticLogger | undefined;\n    readonly details: Readonly<Record<string, unknown>>;\n    readonly messages?: readonly CheckMessage[];\n    readonly result: PreparationResolutionResult;\n    readonly reasonCode: string;\n  }>\n): BlockedCheckPreparationResolution {\n  const resolution = blockedResolution({\n    check: input.check,\n    messages: input.messages ?? EMPTY_MESSAGES,\n    reasonCode: input.reasonCode\n  });\n  observePreparationResolution(\n    input.diagnosticLogger,\n    input.check.definition.checkId,\n    resolution,\n    input.result,\n    input.details\n  );\n  return resolution;\n}\n\nfunction observeReadyOrMalformedResolution(\n  diagnosticLogger: DiagnosticLogger | undefined,\n  checkId: string,\n  resolution: CheckPreparationResolution,\n  result: \"skipped\" | \"prepared\" | \"continued\",\n  details: Readonly<Record<string, unknown>>\n): void {\n  if (resolution.kind === \"blocked\") {\n    observePreparationResolution(diagnosticLogger, checkId, resolution, \"malformed\", {\n      raw: \"raw\" in details ? details.raw : summarizeDiagnosticValue(details)\n    });\n    return;\n  }\n  const messages = \"messages\" in details ? details.messages : EMPTY_MESSAGES;\n  observePreparationResolution(diagnosticLogger, checkId, resolution, result, {\n    ...(Array.isArray(messages) && messages.length > 0 ? { messages } : {}),\n    options: summarizeDiagnosticValue(resolution.check.options),\n    ...(\"reason\" in details ? { reason: details.reason } : {}),\n    ...(\"source\" in details ? { source: details.source } : {})\n  });\n}\n\nfunction observePreparationResolution(\n  diagnosticLogger: DiagnosticLogger | undefined,\n  checkId: string,\n  resolution: CheckPreparationResolution,\n  result: PreparationResolutionResult,\n  details: Readonly<Record<string, unknown>>\n): void {\n  diagnosticLogger?.observe({\n    event: \"preparation.resolved\",\n    tags: diagnosticTags(`CHECK:${checkId}`, \"PREPARATION\", result.toUpperCase()),\n    details: {\n      ...details,\n      ...(resolution.kind === \"blocked\" ? { outcome: resolution.outcome } : {})\n    }\n  });\n}\n\nfunction readyResolution(\n  input: Readonly<{\n    readonly authoredCheck: NormalizedCheck;\n    readonly messages: readonly CheckMessage[];\n    readonly preparedOptions: unknown;\n  }>\n): CheckPreparationResolution {\n  const preparedOptions = snapshotJsonObject(input.preparedOptions);\n  if (preparedOptions === undefined) {\n    return blockedResolution({\n      check: input.authoredCheck,\n      messages: input.messages,\n      reasonCode: \"invalid-preparation-result\"\n    });\n  }\n  const { prepare: _preparation, ...check } = input.authoredCheck;\n  return Object.freeze({\n    kind: \"ready\",\n    check: Object.freeze({\n      ...check,\n      options: preparedOptions,\n      preparationMessages: input.messages\n    })\n  });\n}\n\nfunction blockedResolution(\n  input: Readonly<{\n    readonly check: NormalizedCheck;\n    readonly messages: readonly CheckMessage[];\n    readonly reasonCode: string;\n  }>\n): BlockedCheckPreparationResolution {\n  return Object.freeze({\n    kind: \"blocked\",\n    check: Object.freeze({\n      definition: input.check.definition,\n      preparationMessages: input.messages,\n      omitQuietPassedRow: input.check.omitQuietPassedRow\n    }),\n    outcome: Object.freeze({\n      status: \"unavailable\",\n      reason: Object.freeze({ code: input.reasonCode })\n    })\n  });\n}\n"]}

package/dist/esm/project-run/check-execution/ready-check-execution.mjs

@@ -0,0 +1,71 @@
+/** Executes and settles a Check after its task-local preparation has admitted it. */
+import { artifactDirectoryForCheck } from "../invocation/paths.mjs";
+import { diagnosticTags, summarizeDiagnosticValue } from "../diagnostic-logging/logger.mjs";
+import { executeCheckCallback } from "./callback.mjs";
+import { createCheckDependencies } from "./dependencies.mjs";
+import { checkIdentity } from "./execution-finalization.mjs";
+import { recordSettledCheck, settleCallback } from "./execution-settlement.mjs";
+export async function executeReadyCheck(input) {
+    const check = input.prepare.check;
+    const checkId = check.definition.checkId;
+    const scope = input.session.openCheckScope(checkId);
+    const identity = checkIdentity(check);
+    input.diagnosticLogger?.observe({
+        event: "check.started",
+        tags: diagnosticTags(`CHECK:${checkId}`, "EXECUTION", "STARTED"),
+        details: {
+            dependencies: check.dependsOn,
+            displayName: check.definition.displayName,
+            options: summarizeDiagnosticValue(check.options)
+        }
+    });
+    input.lifecycle?.started(Object.freeze({
+        checkId: identity.checkId,
+        displayName: identity.displayName,
+        omitQuietPassedRow: identity.omitQuietPassedRow
+    }));
+    const startedAt = input.clock.now();
+    const callback = await executeCheckCallback({
+        artifactDirectory: input.paths === undefined ? null : artifactDirectoryForCheck(input.paths, checkId),
+        check,
+        dependencies: createCheckDependencies({
+            checkId,
+            directDependsOnCheckIds: check.dependsOn,
+            diagnosticLogger: input.diagnosticLogger,
+            directRelationCheckIds: directRelationCheckIds(check),
+            handoffsByCheckId: input.handoffsByCheckId,
+            session: input.session
+        }),
+        ...(input.diagnosticLogger === undefined ? {} : { diagnosticLogger: input.diagnosticLogger }),
+        invocationId: input.invocationId,
+        project: input.project,
+        scope,
+        signal: input.signal
+    });
+    const settled = settleCallback({
+        callback,
+        checkId,
+        diagnosticLogger: input.diagnosticLogger,
+        handoff: check.handoff,
+        preparationMessages: check.preparationMessages,
+        scope,
+        state: input
+    });
+    recordSettledCheck({
+        check: identity,
+        durationMs: durationSince(startedAt, input.clock),
+        messages: settled.messages,
+        outcome: settled.outcome,
+        phase: "execution",
+        state: input
+    });
+    return settled.outcome.status === "passed";
+}
+function directRelationCheckIds(check) {
+    return Object.freeze([...new Set([...check.dependsOn, ...check.observes])].sort());
+}
+function durationSince(startedAt, clock) {
+    const elapsed = clock.now() - startedAt;
+    return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;
+}
+//# sourceMappingURL=ready-check-execution.mjs.map

package/dist/esm/project-run/check-execution/ready-check-execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-check-execution.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/ready-check-execution.ts"],"names":[],"mappings":"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","sourcesContent":["/** Executes and settles a Check after its task-local preparation has admitted it. */\n\nimport type { CheckProjectContext } from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport { artifactDirectoryForCheck, type ResolvedInvocationPaths } from \"../invocation/paths.ts\";\nimport { diagnosticTags, summarizeDiagnosticValue } from \"../diagnostic-logging/logger.ts\";\nimport { executeCheckCallback } from \"./callback.ts\";\nimport { createCheckDependencies } from \"./dependencies.ts\";\nimport { checkIdentity } from \"./execution-finalization.ts\";\nimport {\n  recordSettledCheck,\n  settleCallback,\n  type CheckExecutionState\n} from \"./execution-settlement.ts\";\nimport type { ReadyCheckPreparationResolution } from \"./preparation.ts\";\n\nexport type ReadyCheckExecutionInput = CheckExecutionState &\n  Readonly<{\n    readonly check: NormalizedCheck;\n    readonly clock: Readonly<{ now(): number }>;\n    readonly invocationId: string;\n    readonly paths: ResolvedInvocationPaths | undefined;\n    readonly prepare: ReadyCheckPreparationResolution;\n    readonly project: CheckProjectContext;\n    readonly signal: AbortSignal;\n  }>;\n\nexport async function executeReadyCheck(input: ReadyCheckExecutionInput): Promise<boolean> {\n  const check = input.prepare.check;\n  const checkId = check.definition.checkId;\n  const scope = input.session.openCheckScope(checkId);\n  const identity = checkIdentity(check);\n  input.diagnosticLogger?.observe({\n    event: \"check.started\",\n    tags: diagnosticTags(`CHECK:${checkId}`, \"EXECUTION\", \"STARTED\"),\n    details: {\n      dependencies: check.dependsOn,\n      displayName: check.definition.displayName,\n      options: summarizeDiagnosticValue(check.options)\n    }\n  });\n  input.lifecycle?.started(\n    Object.freeze({\n      checkId: identity.checkId,\n      displayName: identity.displayName,\n      omitQuietPassedRow: identity.omitQuietPassedRow\n    })\n  );\n  const startedAt = input.clock.now();\n  const callback = await executeCheckCallback({\n    artifactDirectory:\n      input.paths === undefined ? null : artifactDirectoryForCheck(input.paths, checkId),\n    check,\n    dependencies: createCheckDependencies({\n      checkId,\n      directDependsOnCheckIds: check.dependsOn,\n      diagnosticLogger: input.diagnosticLogger,\n      directRelationCheckIds: directRelationCheckIds(check),\n      handoffsByCheckId: input.handoffsByCheckId,\n      session: input.session\n    }),\n    ...(input.diagnosticLogger === undefined ? {} : { diagnosticLogger: input.diagnosticLogger }),\n    invocationId: input.invocationId,\n    project: input.project,\n    scope,\n    signal: input.signal\n  });\n  const settled = settleCallback({\n    callback,\n    checkId,\n    diagnosticLogger: input.diagnosticLogger,\n    handoff: check.handoff,\n    preparationMessages: check.preparationMessages,\n    scope,\n    state: input\n  });\n  recordSettledCheck({\n    check: identity,\n    durationMs: durationSince(startedAt, input.clock),\n    messages: settled.messages,\n    outcome: settled.outcome,\n    phase: \"execution\",\n    state: input\n  });\n  return settled.outcome.status === \"passed\";\n}\n\nfunction directRelationCheckIds(\n  check: Pick<NormalizedCheck, \"dependsOn\" | \"observes\">\n): readonly string[] {\n  return Object.freeze([...new Set([...check.dependsOn, ...check.observes])].sort());\n}\n\nfunction durationSince(startedAt: number, clock: Readonly<{ now(): number }>): number {\n  const elapsed = clock.now() - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\n"]}