@zxyycom/vibe-check 0.0.1 → 0.0.3

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

@@ -1,186 +0,0 @@
-import { snapshotJsonObject } from "../../check/options-snapshot.mjs";
-import { diagnosticTags, summarizeDiagnosticValue } from "../diagnostic-logging/logger.mjs";
-import { parseCheckPreflightResult } from "./preflight-result.mjs";
-const EMPTY_MESSAGES = Object.freeze([]);
-const INERT_SIGNAL = new AbortController().signal;
-/** Completes the sequential invocation-wide barrier before any Check enters the Task graph. */
-export async function prepareChecks(input) {
-    const resolutions = [];
-    for (const check of input.checks) {
-        resolutions.push(await prepareCheck({
-            check,
-            diagnosticLogger: input.diagnosticLogger,
-            signal: input.signal
-        }));
-    }
-    return Object.freeze(resolutions);
-}
-async function prepareCheck(input) {
-    if (input.signal?.aborted) {
-        return observeBlockedPreflight({
-            check: input.check,
-            diagnosticLogger: input.diagnosticLogger,
-            details: {},
-            result: "cancelled-before-callback",
-            reasonCode: "execution-cancelled"
-        });
-    }
-    if (input.check.preflight === undefined) {
-        return resolveAuthoredOptions(input);
-    }
-    return resolvePreflightInvocation(input, await invokePreflight(input.check, input.signal));
-}
-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 resolvePreflightInvocation(input, invocation) {
-    if (invocation.kind === "threw") {
-        return observeBlockedPreflight({
-            check: input.check,
-            diagnosticLogger: input.diagnosticLogger,
-            details: { error: invocation.error },
-            result: input.signal?.aborted ? "cancelled-after-throw" : "threw",
-            reasonCode: input.signal?.aborted ? "execution-cancelled" : "preflight-threw"
-        });
-    }
-    return resolveReturnedPreflight(input, invocation.output);
-}
-function resolveReturnedPreflight(input, preflightOutput) {
-    if (input.signal?.aborted) {
-        return observeBlockedPreflight({
-            check: input.check,
-            diagnosticLogger: input.diagnosticLogger,
-            details: { raw: preflightOutput },
-            result: "cancelled-after-callback",
-            reasonCode: "execution-cancelled"
-        });
-    }
-    const preflightResult = parseCheckPreflightResult(preflightOutput);
-    if (preflightResult === undefined) {
-        return observeBlockedPreflight({
-            check: input.check,
-            diagnosticLogger: input.diagnosticLogger,
-            details: { raw: preflightOutput },
-            result: "malformed",
-            reasonCode: "invalid-preflight-result"
-        });
-    }
-    if (preflightResult.status === "failure" && preflightResult.action === "block") {
-        return resolveBlockedPreflightResult(input, preflightResult);
-    }
-    return resolveReadyPreflightResult(input, preflightOutput, preflightResult);
-}
-function resolveBlockedPreflightResult(input, preflightResult) {
-    const resolution = blockedResolution({
-        check: input.check,
-        messages: preflightResult.messages,
-        reasonCode: preflightResult.reason.code
-    });
-    observePreflightResolution(input.diagnosticLogger, input.check.definition.checkId, resolution, "blocked", {
-        ...(preflightResult.messages.length === 0 ? {} : { messages: preflightResult.messages }),
-        reason: preflightResult.reason
-    });
-    return resolution;
-}
-function resolveReadyPreflightResult(input, preflightOutput, preflightResult) {
-    const checkId = input.check.definition.checkId;
-    const result = preflightResult.status === "success" ? "prepared" : "continued";
-    const resolution = readyResolution({
-        authoredCheck: input.check,
-        messages: preflightResult.messages,
-        preparedOptions: preflightResult.status === "success"
-            ? preflightResult.preparedOptions
-            : preflightResult.fallback
-    });
-    observeReadyOrMalformedResolution(input.diagnosticLogger, checkId, resolution, result, {
-        messages: preflightResult.messages,
-        ...(preflightResult.status === "success" ? {} : { reason: preflightResult.reason }),
-        raw: preflightOutput
-    });
-    return resolution;
-}
-async function invokePreflight(check, signal) {
-    try {
-        return Object.freeze({
-            kind: "returned",
-            output: await check.preflight(check.options, signal ?? INERT_SIGNAL)
-        });
-    }
-    catch (error) {
-        return Object.freeze({ kind: "threw", error });
-    }
-}
-function observeBlockedPreflight(input) {
-    const resolution = blockedResolution({
-        check: input.check,
-        messages: EMPTY_MESSAGES,
-        reasonCode: input.reasonCode
-    });
-    observePreflightResolution(input.diagnosticLogger, input.check.definition.checkId, resolution, input.result, input.details);
-    return resolution;
-}
-function observeReadyOrMalformedResolution(diagnosticLogger, checkId, resolution, result, details) {
-    if (resolution.kind === "blocked") {
-        observePreflightResolution(diagnosticLogger, checkId, resolution, "malformed", {
-            raw: "raw" in details ? details.raw : summarizeDiagnosticValue(details)
-        });
-        return;
-    }
-    const messages = "messages" in details ? details.messages : EMPTY_MESSAGES;
-    observePreflightResolution(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 observePreflightResolution(diagnosticLogger, checkId, resolution, result, details) {
-    diagnosticLogger?.observe({
-        event: "preflight.resolved",
-        tags: diagnosticTags(`CHECK:${checkId}`, "PREFLIGHT", 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: EMPTY_MESSAGES,
-            reasonCode: "invalid-preflight-result"
-        });
-    }
-    const { preflight: _preflight, ...check } = input.authoredCheck;
-    return Object.freeze({
-        kind: "ready",
-        check: Object.freeze({
-            ...check,
-            options: preparedOptions,
-            preflightMessages: input.messages
-        })
-    });
-}
-function blockedResolution(input) {
-    return Object.freeze({
-        kind: "blocked",
-        check: Object.freeze({
-            definition: input.check.definition,
-            preflightMessages: input.messages,
-            visibility: input.check.visibility
-        }),
-        outcome: Object.freeze({
-            status: "unavailable",
-            reason: Object.freeze({ code: input.reasonCode })
-        })
-    });
-}
-//# sourceMappingURL=preflight.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"preflight.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/preflight.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckOutcome } 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 { parseCheckPreflightResult, type ParsedCheckPreflightResult } from \"./preflight-result.ts\";\n\nconst EMPTY_MESSAGES: readonly CheckMessage[] = Object.freeze([]);\nconst INERT_SIGNAL = new AbortController().signal;\n\nexport type PreparedCheck = Omit<NormalizedCheck, \"options\" | \"preflight\"> &\n  Readonly<{ readonly options: object; readonly preflightMessages: readonly CheckMessage[] }>;\n\ntype BlockedCheck = Pick<NormalizedCheck, \"definition\" | \"visibility\"> &\n  Readonly<{ readonly preflightMessages: readonly CheckMessage[] }>;\n\nexport type ReadyCheckPreflightResolution = Readonly<{\n  readonly kind: \"ready\";\n  readonly check: PreparedCheck;\n}>;\n\nexport type BlockedCheckPreflightResolution = Readonly<{\n  readonly kind: \"blocked\";\n  readonly check: BlockedCheck;\n  readonly outcome: CheckOutcome;\n}>;\n\nexport type CheckPreflightResolution =\n  | ReadyCheckPreflightResolution\n  | BlockedCheckPreflightResolution;\n\ntype PreflightResolutionResult =\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 signal: AbortSignal | undefined;\n}>;\n\ntype PreflightInvocation =\n  | Readonly<{ readonly kind: \"returned\"; readonly output: unknown }>\n  | Readonly<{ readonly kind: \"threw\"; readonly error: unknown }>;\n\n/** Completes the sequential invocation-wide barrier before any Check enters the Task graph. */\nexport async function prepareChecks(\n  input: Readonly<{\n    readonly checks: readonly NormalizedCheck[];\n    readonly diagnosticLogger?: DiagnosticLogger;\n    readonly signal: AbortSignal | undefined;\n  }>\n): Promise<readonly CheckPreflightResolution[]> {\n  const resolutions: CheckPreflightResolution[] = [];\n  for (const check of input.checks) {\n    resolutions.push(\n      await prepareCheck({\n        check,\n        diagnosticLogger: input.diagnosticLogger,\n        signal: input.signal\n      })\n    );\n  }\n  return Object.freeze(resolutions);\n}\n\nasync function prepareCheck(input: PrepareCheckInput): Promise<CheckPreflightResolution> {\n  if (input.signal?.aborted) {\n    return observeBlockedPreflight({\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.preflight === undefined) {\n    return resolveAuthoredOptions(input);\n  }\n  return resolvePreflightInvocation(input, await invokePreflight(input.check, input.signal));\n}\n\nfunction resolveAuthoredOptions(input: PrepareCheckInput): CheckPreflightResolution {\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 resolvePreflightInvocation(\n  input: PrepareCheckInput,\n  invocation: PreflightInvocation\n): CheckPreflightResolution {\n  if (invocation.kind === \"threw\") {\n    return observeBlockedPreflight({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { error: invocation.error },\n      result: input.signal?.aborted ? \"cancelled-after-throw\" : \"threw\",\n      reasonCode: input.signal?.aborted ? \"execution-cancelled\" : \"preflight-threw\"\n    });\n  }\n  return resolveReturnedPreflight(input, invocation.output);\n}\n\nfunction resolveReturnedPreflight(\n  input: PrepareCheckInput,\n  preflightOutput: unknown\n): CheckPreflightResolution {\n  if (input.signal?.aborted) {\n    return observeBlockedPreflight({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { raw: preflightOutput },\n      result: \"cancelled-after-callback\",\n      reasonCode: \"execution-cancelled\"\n    });\n  }\n  const preflightResult = parseCheckPreflightResult(preflightOutput);\n  if (preflightResult === undefined) {\n    return observeBlockedPreflight({\n      check: input.check,\n      diagnosticLogger: input.diagnosticLogger,\n      details: { raw: preflightOutput },\n      result: \"malformed\",\n      reasonCode: \"invalid-preflight-result\"\n    });\n  }\n  if (preflightResult.status === \"failure\" && preflightResult.action === \"block\") {\n    return resolveBlockedPreflightResult(input, preflightResult);\n  }\n  return resolveReadyPreflightResult(input, preflightOutput, preflightResult);\n}\n\nfunction resolveBlockedPreflightResult(\n  input: PrepareCheckInput,\n  preflightResult: Extract<ParsedCheckPreflightResult, { readonly action: \"block\" }>\n): CheckPreflightResolution {\n  const resolution = blockedResolution({\n    check: input.check,\n    messages: preflightResult.messages,\n    reasonCode: preflightResult.reason.code\n  });\n  observePreflightResolution(\n    input.diagnosticLogger,\n    input.check.definition.checkId,\n    resolution,\n    \"blocked\",\n    {\n      ...(preflightResult.messages.length === 0 ? {} : { messages: preflightResult.messages }),\n      reason: preflightResult.reason\n    }\n  );\n  return resolution;\n}\n\nfunction resolveReadyPreflightResult(\n  input: PrepareCheckInput,\n  preflightOutput: unknown,\n  preflightResult: Exclude<ParsedCheckPreflightResult, { readonly action: \"block\" }>\n): CheckPreflightResolution {\n  const checkId = input.check.definition.checkId;\n  const result = preflightResult.status === \"success\" ? \"prepared\" : \"continued\";\n  const resolution = readyResolution({\n    authoredCheck: input.check,\n    messages: preflightResult.messages,\n    preparedOptions:\n      preflightResult.status === \"success\"\n        ? preflightResult.preparedOptions\n        : preflightResult.fallback\n  });\n  observeReadyOrMalformedResolution(input.diagnosticLogger, checkId, resolution, result, {\n    messages: preflightResult.messages,\n    ...(preflightResult.status === \"success\" ? {} : { reason: preflightResult.reason }),\n    raw: preflightOutput\n  });\n  return resolution;\n}\n\nasync function invokePreflight(\n  check: NormalizedCheck,\n  signal: AbortSignal | undefined\n): Promise<PreflightInvocation> {\n  try {\n    return Object.freeze({\n      kind: \"returned\",\n      output: await check.preflight!(check.options, signal ?? INERT_SIGNAL)\n    });\n  } catch (error) {\n    return Object.freeze({ kind: \"threw\", error });\n  }\n}\n\nfunction observeBlockedPreflight(\n  input: Readonly<{\n    readonly check: NormalizedCheck;\n    readonly diagnosticLogger: DiagnosticLogger | undefined;\n    readonly details: Readonly<Record<string, unknown>>;\n    readonly result: PreflightResolutionResult;\n    readonly reasonCode: string;\n  }>\n): BlockedCheckPreflightResolution {\n  const resolution = blockedResolution({\n    check: input.check,\n    messages: EMPTY_MESSAGES,\n    reasonCode: input.reasonCode\n  });\n  observePreflightResolution(\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: CheckPreflightResolution,\n  result: \"skipped\" | \"prepared\" | \"continued\",\n  details: Readonly<Record<string, unknown>>\n): void {\n  if (resolution.kind === \"blocked\") {\n    observePreflightResolution(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  observePreflightResolution(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 observePreflightResolution(\n  diagnosticLogger: DiagnosticLogger | undefined,\n  checkId: string,\n  resolution: CheckPreflightResolution,\n  result: PreflightResolutionResult,\n  details: Readonly<Record<string, unknown>>\n): void {\n  diagnosticLogger?.observe({\n    event: \"preflight.resolved\",\n    tags: diagnosticTags(`CHECK:${checkId}`, \"PREFLIGHT\", 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): CheckPreflightResolution {\n  const preparedOptions = snapshotJsonObject(input.preparedOptions);\n  if (preparedOptions === undefined) {\n    return blockedResolution({\n      check: input.authoredCheck,\n      messages: EMPTY_MESSAGES,\n      reasonCode: \"invalid-preflight-result\"\n    });\n  }\n  const { preflight: _preflight, ...check } = input.authoredCheck;\n  return Object.freeze({\n    kind: \"ready\",\n    check: Object.freeze({\n      ...check,\n      options: preparedOptions,\n      preflightMessages: 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): BlockedCheckPreflightResolution {\n  return Object.freeze({\n    kind: \"blocked\",\n    check: Object.freeze({\n      definition: input.check.definition,\n      preflightMessages: input.messages,\n      visibility: input.check.visibility\n    }),\n    outcome: Object.freeze({\n      status: \"unavailable\",\n      reason: Object.freeze({ code: input.reasonCode })\n    })\n  });\n}\n"]}

package/dist/esm/project-run/completion.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"completion.mjs","sourceRoot":"","sources":["../../../src/project-run/completion.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\nimport { failedOutput } from \"./output-status.ts\";\nimport { publishMachineOutput } from \"./machine-publication.ts\";\nimport {\n  outputFailure,\n  type CheckDuration,\n  type CheckRunMessage,\n  type NonConfigurationRunResult,\n  type RunResultFacts\n} from \"./result.ts\";\nimport type { CheckAggregate } from \"./controls/contract.ts\";\nimport { diagnosticTags } from \"./diagnostic-logging/logger.ts\";\nimport type { Invocation } from \"./invocation.ts\";\nimport {\n  createPublicationModelV4,\n  type TrustedPublicationModelV4\n} from \"../machine-output/v4/publication-model.ts\";\nimport type { CoreCheck, CoreSnapshot } from \"../check-settlement/facts.ts\";\n\ntype OutcomeCounts = {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n};\n\n/** Settled Check facts consumed by completion and output publication. */\nexport type CoreExecution = Readonly<{\n  readonly aggregate: CheckAggregate | null;\n  readonly checkDurations: readonly CheckDuration[];\n  readonly checkMessages: readonly CheckRunMessage[];\n  readonly snapshot: CoreSnapshot;\n}>;\n\nexport function completeInvocation(\n  invocation: Invocation,\n  core: CoreExecution\n): NonConfigurationRunResult {\n  const facts = runFacts(core);\n  if (invocation.outputConfiguration.machinePublication.enabled) {\n    const model = createModel(invocation, core.snapshot);\n    if (isExecutionResult(model)) return model;\n    const published = publishMachineOutput({\n      configuration: invocation.outputConfiguration.machinePublication,\n      statuses: invocation.outputs,\n      model,\n      directory: resolve(\n        invocation.projectRoot,\n        invocation.outputConfiguration.machinePublication.directory\n      )\n    });\n    if (!published) return failure(invocation, facts);\n  }\n  const output = failedOutput(invocation.outputs.value());\n  return output === undefined\n    ? Object.freeze({\n        kind: \"completed\",\n        declarativeFingerprint: invocation.declarativeFingerprint,\n        definitionWarnings: invocation.definitionWarnings,\n        outputs: invocation.outputs.value(),\n        ...facts\n      })\n    : failure(invocation, facts);\n}\nfunction failure(invocation: Invocation, facts: RunResultFacts): ReturnType<typeof outputFailure> {\n  const output = failedOutput(invocation.outputs.value());\n  if (output === undefined) throw new Error(\"Run output failed without a failed status\");\n  return outputFailure(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    output,\n    facts\n  );\n}\nfunction runFacts(core: CoreExecution): RunResultFacts {\n  return Object.freeze({\n    aggregate: core.aggregate,\n    checkDurations: core.checkDurations,\n    checkMessages: core.checkMessages,\n    snapshot: core.snapshot\n  });\n}\nfunction createModel(\n  invocation: Invocation,\n  snapshot: CoreExecution[\"snapshot\"]\n): TrustedPublicationModelV4 | Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  try {\n    if (invocation.startedAtUtc === null)\n      throw new Error(\"Machine publication requires an invocation timestamp\");\n    return createPublicationModelV4({\n      invocation: {\n        invocationId: invocation.invocationId,\n        projectRoot: \".\",\n        timestamp: invocation.startedAtUtc\n      },\n      snapshot\n    });\n  } catch {\n    return Object.freeze({\n      kind: \"execution\",\n      declarativeFingerprint: invocation.declarativeFingerprint,\n      definitionWarnings: invocation.definitionWarnings,\n      diagnostic: Object.freeze({ code: \"publication-model-failed\" }),\n      outputs: invocation.outputs.value()\n    });\n  }\n}\nfunction isExecutionResult(\n  value:\n    | TrustedPublicationModelV4\n    | Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }>\n): value is Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return \"kind\" in value;\n}\n\n/** Closes diagnostic logging and applies final output priority to a non-configuration candidate. */\nexport function finalizeInvocation(\n  invocation: Invocation,\n  candidate: NonConfigurationRunResult\n): NonConfigurationRunResult {\n  const preCloseOutputs = invocation.outputs.value();\n  invocation.diagnosticLogger.observe({\n    event: \"run.terminal-before-log-close\",\n    tags: diagnosticTags(\"RUN\", \"TERMINAL\", terminalStatusTag(candidate)),\n    details: {\n      ...closingFacts(candidate),\n      diagnosticLogging: \"close-not-yet-confirmed\",\n      outputs: preCloseOutputDetails(preCloseOutputs)\n    }\n  });\n  const diagnosticLoggingStatus = invocation.diagnosticLogger.close();\n  if (diagnosticLoggingStatus === \"failed\") invocation.outputs.failed(\"diagnosticLogging\");\n  if (diagnosticLoggingStatus === \"succeeded\") invocation.outputs.succeeded(\"diagnosticLogging\");\n\n  const outputs = invocation.outputs.value();\n  switch (candidate.kind) {\n    case \"completed\": {\n      const output = failedOutput(outputs);\n      return output === undefined\n        ? Object.freeze({ ...candidate, outputs })\n        : outputFailure(\n            candidate.declarativeFingerprint,\n            candidate.definitionWarnings,\n            outputs,\n            output,\n            finalSnapshotFacts(candidate)\n          );\n    }\n    case \"output\": {\n      const output = failedOutput(outputs);\n      if (output === undefined) throw new Error(\"Run output failed without a failed status\");\n      return outputFailure(\n        candidate.declarativeFingerprint,\n        candidate.definitionWarnings,\n        outputs,\n        output,\n        finalSnapshotFacts(candidate)\n      );\n    }\n    case \"planning\":\n    case \"cancelled\":\n    case \"execution\":\n      return Object.freeze({ ...candidate, outputs });\n  }\n}\n\nfunction terminalStatusTag(candidate: NonConfigurationRunResult): string {\n  if (\"aggregate\" in candidate && candidate.aggregate !== null)\n    return candidate.aggregate.toUpperCase();\n  if (candidate.kind === \"cancelled\") return \"CANCELLED\";\n  return candidate.kind.toUpperCase();\n}\n\nfunction preCloseOutputDetails(outputs: ReturnType<Invocation[\"outputs\"][\"value\"]>): Readonly<{\n  readonly machinePublication: (typeof outputs)[\"machinePublication\"];\n  readonly progressRendering: (typeof outputs)[\"progressRendering\"];\n}> {\n  return Object.freeze({\n    machinePublication: outputs.machinePublication,\n    progressRendering: outputs.progressRendering\n  });\n}\n\nfunction closingFacts(candidate: NonConfigurationRunResult): Readonly<{\n  readonly aggregate: CheckAggregate | null;\n  readonly candidateKind: NonConfigurationRunResult[\"kind\"];\n  readonly counts: Readonly<{\n    readonly failed: number;\n    readonly notApplicable: number;\n    readonly passed: number;\n    readonly unavailable: number;\n  }> | null;\n  readonly nonPassed: readonly Readonly<{\n    readonly checkId: string;\n    readonly reason: unknown;\n    readonly status: string;\n  }>[];\n}> {\n  if (!(\"snapshot\" in candidate)) {\n    return Object.freeze({\n      aggregate: null,\n      candidateKind: candidate.kind,\n      counts: null,\n      nonPassed: []\n    });\n  }\n  const summary = summarizeSnapshot(candidate.snapshot);\n  return Object.freeze({\n    aggregate: \"aggregate\" in candidate ? candidate.aggregate : null,\n    candidateKind: candidate.kind,\n    ...summary\n  });\n}\n\nfunction summarizeSnapshot(snapshot: CoreSnapshot): Readonly<{\n  readonly counts: OutcomeCounts;\n  readonly nonPassed: readonly Readonly<{\n    readonly checkId: string;\n    readonly reason: unknown;\n    readonly status: string;\n  }>[];\n}> {\n  const counts = { failed: 0, notApplicable: 0, passed: 0, unavailable: 0 };\n  const nonPassed: Array<Readonly<{ checkId: string; reason: unknown; status: string }>> = [];\n  for (const check of snapshot.checks) {\n    counts[statusCountKey(check)] += 1;\n    const fact = nonPassedFact(check);\n    if (fact !== undefined) nonPassed.push(fact);\n  }\n  return Object.freeze({\n    counts: Object.freeze(counts),\n    nonPassed: Object.freeze(nonPassed)\n  });\n}\n\nfunction statusCountKey(check: CoreCheck): keyof OutcomeCounts {\n  return check.outcome.status === \"not-applicable\" ? \"notApplicable\" : check.outcome.status;\n}\n\nfunction nonPassedFact(\n  check: CoreCheck\n):\n  | Readonly<{ readonly checkId: string; readonly reason: unknown; readonly status: string }>\n  | undefined {\n  if (check.outcome.status === \"passed\") return undefined;\n  return Object.freeze({\n    checkId: check.checkId,\n    reason: check.outcome.status === \"failed\" ? null : (check.outcome.reason ?? null),\n    status: check.outcome.status\n  });\n}\n\nfunction finalSnapshotFacts(\n  candidate: Extract<NonConfigurationRunResult, RunResultFacts>\n): RunResultFacts {\n  return Object.freeze({\n    aggregate: candidate.aggregate,\n    checkDurations: candidate.checkDurations,\n    checkMessages: candidate.checkMessages,\n    snapshot: candidate.snapshot\n  });\n}\n"]}

package/dist/esm/project-run/invocation-creation.mjs

@@ -1,111 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { relative, resolve } from "node:path";
-import { createDeclarativeFingerprint } from "../project-definition/project-definition.mjs";
-import { createDiagnosticLogger } from "./diagnostic-logging/logger.mjs";
-import { createOutputStatuses } from "./output-status.mjs";
-import { effectiveOutputs } from "./output-configuration.mjs";
-import { createProgressRendering } from "./progress-rendering/presentation.mjs";
-const SYSTEM_MONOTONIC_CLOCK = Object.freeze({
-    now: () => performance.now()
-});
-/** Creates immutable invocation-owned output state before any planning or execution work. */
-export function createInvocation(input) {
-    const outputConfiguration = effectiveOutputs(input.definition, input.controls);
-    const clock = input.dependencies.clock ?? SYSTEM_MONOTONIC_CLOCK;
-    const projectRoot = resolve(input.controls.projectRoot ?? process.cwd());
-    const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);
-    const identity = createInvocationIdentity();
-    const diagnosticLoggingFile = resolveDiagnosticLoggingFile({
-        identity,
-        outputConfiguration,
-        projectRoot,
-        startedAtUtc
-    });
-    const outputs = createOutputStatuses(outputConfiguration, diagnosticLoggingFile);
-    const diagnosticLogger = createDiagnosticLoggerSafely(input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger, {
-        clock,
-        enabled: outputConfiguration.diagnosticLogging.enabled,
-        file: diagnosticLoggingFile === null ? null : resolve(projectRoot, diagnosticLoggingFile)
-    });
-    return Object.freeze({
-        clock,
-        controls: input.controls,
-        declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),
-        definition: input.definition,
-        definitionWarnings: Object.freeze([...input.definitionWarnings]),
-        diagnosticLogger,
-        outputConfiguration,
-        outputs,
-        invocationId: identity.id,
-        normalized: input.normalized,
-        progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {
-            clock,
-            refreshScheduler: input.dependencies.progressRefreshScheduler,
-            writerFactory: input.dependencies.progressWriterFactory
-        }),
-        projectRoot,
-        startedAtUtc
-    });
-}
-function captureOutputCreationTimestamp(outputConfiguration, dependencies) {
-    if (!outputConfiguration.diagnosticLogging.enabled &&
-        !outputConfiguration.machinePublication.enabled)
-        return null;
-    return (dependencies.wallClock?.now() ?? new Date()).toISOString();
-}
-function createInvocationIdentity() {
-    const uuid = randomUUID();
-    return Object.freeze({ id: `invocation/v1:${uuid}`, uuid });
-}
-function resolveDiagnosticLoggingFile(input) {
-    if (!input.outputConfiguration.diagnosticLogging.enabled)
-        return null;
-    return relative(input.projectRoot, resolve(input.projectRoot, input.outputConfiguration.diagnosticLogging.directory, diagnosticLogFileName(requireStartedAtUtc(input.startedAtUtc), input.identity.uuid)));
-}
-function createDiagnosticLoggerSafely(factory, input) {
-    let delegate;
-    try {
-        delegate = factory(input);
-    }
-    catch {
-        return failedDiagnosticLogger();
-    }
-    let failed = false;
-    return Object.freeze({
-        close: () => {
-            try {
-                const status = delegate.close();
-                return failed ? "failed" : status;
-            }
-            catch {
-                return "failed";
-            }
-        },
-        observe: (observation) => {
-            if (failed)
-                return;
-            try {
-                delegate.observe(observation);
-            }
-            catch {
-                failed = true;
-            }
-        }
-    });
-}
-function failedDiagnosticLogger() {
-    return Object.freeze({
-        close: () => "failed",
-        observe: () => undefined
-    });
-}
-function diagnosticLogFileName(startedAtUtc, invocationUuid) {
-    const compactUtc = startedAtUtc.replaceAll("-", "").replaceAll(":", "");
-    return `run-${compactUtc}-${invocationUuid}.log`;
-}
-function requireStartedAtUtc(startedAtUtc) {
-    if (startedAtUtc === null)
-        throw new Error("Enabled output requires an invocation timestamp");
-    return startedAtUtc;
-}
-//# sourceMappingURL=invocation-creation.mjs.map

package/dist/esm/project-run/invocation-creation.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"invocation-creation.mjs","sourceRoot":"","sources":["../../../src/project-run/invocation-creation.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { relative, resolve } from \"node:path\";\n\nimport {\n  createDeclarativeFingerprint,\n  type DefinitionWarning,\n  type NormalizedProjectDefinition,\n  type ProjectDefinition\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport {\n  createDiagnosticLogger,\n  type DiagnosticLogger,\n  type DiagnosticLoggerFactory,\n  type DiagnosticObservation\n} from \"./diagnostic-logging/logger.ts\";\nimport type { Invocation, RunInvocationDependencies } from \"./invocation.ts\";\nimport { createOutputStatuses } from \"./output-status.ts\";\nimport { effectiveOutputs } from \"./output-configuration.ts\";\nimport { createProgressRendering } from \"./progress-rendering/presentation.ts\";\n\nconst SYSTEM_MONOTONIC_CLOCK: Invocation[\"clock\"] = Object.freeze({\n  now: () => performance.now()\n});\n\nexport interface InvocationCreationInput {\n  readonly controls: RunControls;\n  readonly definition: ProjectDefinition;\n  readonly definitionWarnings: readonly DefinitionWarning[];\n  readonly dependencies: RunInvocationDependencies;\n  readonly normalized: NormalizedProjectDefinition;\n}\n\n/** Creates immutable invocation-owned output state before any planning or execution work. */\nexport function createInvocation(input: InvocationCreationInput): Invocation {\n  const outputConfiguration = effectiveOutputs(input.definition, input.controls);\n  const clock = input.dependencies.clock ?? SYSTEM_MONOTONIC_CLOCK;\n  const projectRoot = resolve(input.controls.projectRoot ?? process.cwd());\n  const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);\n  const identity = createInvocationIdentity();\n  const diagnosticLoggingFile = resolveDiagnosticLoggingFile({\n    identity,\n    outputConfiguration,\n    projectRoot,\n    startedAtUtc\n  });\n  const outputs = createOutputStatuses(outputConfiguration, diagnosticLoggingFile);\n  const diagnosticLogger = createDiagnosticLoggerSafely(\n    input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger,\n    {\n      clock,\n      enabled: outputConfiguration.diagnosticLogging.enabled,\n      file: diagnosticLoggingFile === null ? null : resolve(projectRoot, diagnosticLoggingFile)\n    }\n  );\n\n  return Object.freeze({\n    clock,\n    controls: input.controls,\n    declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),\n    definition: input.definition,\n    definitionWarnings: Object.freeze([...input.definitionWarnings]),\n    diagnosticLogger,\n    outputConfiguration,\n    outputs,\n    invocationId: identity.id,\n    normalized: input.normalized,\n    progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {\n      clock,\n      refreshScheduler: input.dependencies.progressRefreshScheduler,\n      writerFactory: input.dependencies.progressWriterFactory\n    }),\n    projectRoot,\n    startedAtUtc\n  });\n}\n\nfunction captureOutputCreationTimestamp(\n  outputConfiguration: ProjectDefinition[\"outputs\"],\n  dependencies: RunInvocationDependencies\n): string | null {\n  if (\n    !outputConfiguration.diagnosticLogging.enabled &&\n    !outputConfiguration.machinePublication.enabled\n  )\n    return null;\n  return (dependencies.wallClock?.now() ?? new Date()).toISOString();\n}\n\nfunction createInvocationIdentity(): Readonly<{ readonly id: string; readonly uuid: string }> {\n  const uuid = randomUUID();\n  return Object.freeze({ id: `invocation/v1:${uuid}`, uuid });\n}\n\nfunction resolveDiagnosticLoggingFile(\n  input: Readonly<{\n    readonly identity: Readonly<{ readonly uuid: string }>;\n    readonly outputConfiguration: ProjectDefinition[\"outputs\"];\n    readonly projectRoot: string;\n    readonly startedAtUtc: string | null;\n  }>\n): string | null {\n  if (!input.outputConfiguration.diagnosticLogging.enabled) return null;\n  return relative(\n    input.projectRoot,\n    resolve(\n      input.projectRoot,\n      input.outputConfiguration.diagnosticLogging.directory,\n      diagnosticLogFileName(requireStartedAtUtc(input.startedAtUtc), input.identity.uuid)\n    )\n  );\n}\n\nfunction createDiagnosticLoggerSafely(\n  factory: DiagnosticLoggerFactory,\n  input: Parameters<DiagnosticLoggerFactory>[0]\n): DiagnosticLogger {\n  let delegate: DiagnosticLogger;\n  try {\n    delegate = factory(input);\n  } catch {\n    return failedDiagnosticLogger();\n  }\n  let failed = false;\n  return Object.freeze({\n    close: () => {\n      try {\n        const status = delegate.close();\n        return failed ? \"failed\" : status;\n      } catch {\n        return \"failed\";\n      }\n    },\n    observe: (observation: DiagnosticObservation) => {\n      if (failed) return;\n      try {\n        delegate.observe(observation);\n      } catch {\n        failed = true;\n      }\n    }\n  });\n}\n\nfunction failedDiagnosticLogger(): DiagnosticLogger {\n  return Object.freeze({\n    close: () => \"failed\" as const,\n    observe: () => undefined\n  });\n}\n\nfunction diagnosticLogFileName(startedAtUtc: string, invocationUuid: string): string {\n  const compactUtc = startedAtUtc.replaceAll(\"-\", \"\").replaceAll(\":\", \"\");\n  return `run-${compactUtc}-${invocationUuid}.log`;\n}\n\nfunction requireStartedAtUtc(startedAtUtc: string | null): string {\n  if (startedAtUtc === null) throw new Error(\"Enabled output requires an invocation timestamp\");\n  return startedAtUtc;\n}\n"]}

package/dist/esm/project-run/invocation.mjs

@@ -1,195 +0,0 @@
-import { normalizeProjectDefinition } from "../project-definition/project-definition.mjs";
-import { prepareTaskGraph } from "./task-scheduler/graph.mjs";
-import { aggregateCheckOutcomes, validateCheckAggregationSelection } from "./aggregation.mjs";
-import { executeResolvedChecks } from "./check-execution/resolved-checks.mjs";
-import { planStaticCheckGraph } from "./check-execution/plan.mjs";
-import {} from "./progress-rendering/presentation.mjs";
-import { completeInvocation, finalizeInvocation } from "./completion.mjs";
-import { createProjectContext } from "./project-context.mjs";
-import { executionCancellation, isCancelled, planning, preExecutionCancellation } from "./result.mjs";
-import { diagnosticTags } from "./diagnostic-logging/logger.mjs";
-import { createInvocation } from "./invocation-creation.mjs";
-export async function executeValidatedRun(definition, controls, definitionWarnings, dependencies = {}) {
-    const normalized = normalizeProjectDefinition(definition);
-    const aggregation = validateCheckAggregationSelection(controls.checkAggregation, normalized.checks.map((check) => check.definition.checkId));
-    if (!aggregation.ok)
-        return Object.freeze({
-            kind: "configuration",
-            definitionWarnings: Object.freeze([...definitionWarnings]),
-            diagnostic: aggregation.error
-        });
-    const invocation = createInvocation({
-        controls,
-        definition,
-        definitionWarnings,
-        dependencies,
-        normalized
-    });
-    let candidate;
-    try {
-        observeInvocationStarted(invocation, aggregation.value);
-        if (isCancelled(controls)) {
-            candidate = cancelledBeforeExecution(invocation, "pre-work");
-        }
-        else if (!validateTaskGraph(invocation)) {
-            candidate = planningResult(invocation, "task-graph-invalid");
-        }
-        else {
-            candidate = await executePlannedInvocation(invocation, aggregation.value);
-        }
-    }
-    catch {
-        candidate = executionResult(invocation, "task-engine-failed");
-    }
-    return finalizeInvocation(invocation, candidate);
-}
-function observeInvocationStarted(invocation, aggregation) {
-    invocation.diagnosticLogger.observe({
-        event: "run.started",
-        tags: diagnosticTags("RUN", "STARTED"),
-        details: {
-            aggregation: aggregation ?? null,
-            checkCount: invocation.normalized.checks.length,
-            flags: invocation.controls.flags ?? [],
-            invocationId: invocation.invocationId,
-            outputs: invocation.outputConfiguration,
-            scheduler: invocation.normalized.declarative.scheduler
-        }
-    });
-}
-function validateTaskGraph(invocation) {
-    try {
-        prepareTaskGraph(planStaticCheckGraph(invocation.normalized.checks), invocation.normalized.declarative.scheduler.maxParallel);
-        invocation.diagnosticLogger.observe({
-            event: "run.planning.succeeded",
-            tags: diagnosticTags("RUN", "PLANNING", "SUCCEEDED"),
-            details: {
-                checkCount: invocation.normalized.checks.length,
-                maxParallel: invocation.normalized.declarative.scheduler.maxParallel
-            }
-        });
-        return true;
-    }
-    catch {
-        invocation.diagnosticLogger.observe({
-            event: "run.planning.failed",
-            tags: diagnosticTags("RUN", "PLANNING", "FAILED"),
-            details: {
-                checkCount: invocation.normalized.checks.length,
-                maxParallel: invocation.normalized.declarative.scheduler.maxParallel
-            }
-        });
-        return false;
-    }
-}
-async function executePlannedInvocation(invocation, aggregation) {
-    if (isCancelled(invocation.controls))
-        return cancelledBeforeExecution(invocation, "pre-work");
-    return executePreparedInvocation(invocation, aggregation, createProjectContext({ controls: invocation.controls, root: invocation.projectRoot }));
-}
-async function executePreparedInvocation(invocation, aggregation, project) {
-    if (isCancelled(invocation.controls))
-        return cancelledBeforeExecution(invocation, "planning");
-    invocation.progressRendering.prepared(invocation.normalized.checks.length);
-    const executionStartedAt = invocation.clock.now();
-    const executed = await executeChecks(invocation, project, invocation.clock);
-    if (isExecutionRunResult(executed))
-        return executed;
-    invocation.progressRendering.final({
-        counts: outcomeCounts(executed.snapshot),
-        elapsedMs: elapsedSince(executionStartedAt, invocation.clock),
-        execution: executed.kind
-    });
-    if (executed.kind === "cancelled") {
-        invocation.diagnosticLogger.observe({
-            event: "run.execution.cancelled",
-            tags: diagnosticTags("RUN", "EXECUTION", "CANCELLED"),
-            details: { checkCount: executed.snapshot.checks.length }
-        });
-        return executionCancellation({
-            checkDurations: executed.checkDurations,
-            checkMessages: executed.checkMessages,
-            declarativeFingerprint: invocation.declarativeFingerprint,
-            definitionWarnings: invocation.definitionWarnings,
-            outputs: invocation.outputs.value(),
-            snapshot: executed.snapshot
-        });
-    }
-    const aggregate = aggregation === undefined ? null : aggregateCheckOutcomes(executed.snapshot, aggregation);
-    invocation.diagnosticLogger.observe({
-        event: "run.aggregation.completed",
-        tags: diagnosticTags("RUN", "AGGREGATION", "COMPLETED"),
-        details: { aggregate, selection: aggregation ?? null }
-    });
-    const core = Object.freeze({
-        aggregate,
-        checkDurations: executed.checkDurations,
-        checkMessages: executed.checkMessages,
-        snapshot: executed.snapshot
-    });
-    return completeInvocation(invocation, core);
-}
-function cancelledBeforeExecution(invocation, phase) {
-    invocation.diagnosticLogger.observe({
-        event: "run.cancelled",
-        tags: diagnosticTags("RUN", "CANCELLED"),
-        details: { phase }
-    });
-    return preExecutionCancellation(invocation.declarativeFingerprint, invocation.definitionWarnings, invocation.outputs.value(), phase);
-}
-async function executeChecks(invocation, project, clock) {
-    try {
-        return await executeResolvedChecks({
-            checks: invocation.normalized.checks,
-            clock,
-            diagnosticLogger: invocation.diagnosticLogger,
-            maxParallel: invocation.normalized.declarative.scheduler.maxParallel,
-            lifecycle: invocation.progressRendering.lifecycle,
-            project,
-            signal: invocation.controls.signal
-        });
-    }
-    catch {
-        return executionResult(invocation, "task-engine-failed");
-    }
-}
-function outcomeCounts(snapshot) {
-    let failed = 0, notApplicable = 0, passed = 0, unavailable = 0;
-    for (const check of snapshot.checks) {
-        switch (check.outcome.status) {
-            case "passed":
-                passed += 1;
-                break;
-            case "failed":
-                failed += 1;
-                break;
-            case "not-applicable":
-                notApplicable += 1;
-                break;
-            case "unavailable":
-                unavailable += 1;
-                break;
-        }
-    }
-    return Object.freeze({ failed, notApplicable, passed, unavailable });
-}
-function elapsedSince(startedAt, clock) {
-    const elapsed = clock.now() - startedAt;
-    return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;
-}
-function planningResult(invocation, code) {
-    return planning(invocation.declarativeFingerprint, invocation.definitionWarnings, invocation.outputs.value(), code);
-}
-function executionResult(invocation, code) {
-    return Object.freeze({
-        kind: "execution",
-        declarativeFingerprint: invocation.declarativeFingerprint,
-        definitionWarnings: invocation.definitionWarnings,
-        diagnostic: Object.freeze({ code }),
-        outputs: invocation.outputs.value()
-    });
-}
-function isExecutionRunResult(value) {
-    return "declarativeFingerprint" in value;
-}
-//# sourceMappingURL=invocation.mjs.map

package/dist/esm/project-run/invocation.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"invocation.mjs","sourceRoot":"","sources":["../../../src/project-run/invocation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckProjectContext } from \"../check/check.ts\";\nimport type { CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport {\n  normalizeProjectDefinition,\n  type DefinitionWarning,\n  type NormalizedProjectDefinition,\n  type ProjectDefinition\n} from \"../project-definition/project-definition.ts\";\nimport type { CheckAggregation, RunControls } from \"./controls/contract.ts\";\nimport { prepareTaskGraph } from \"./task-scheduler/graph.ts\";\nimport { aggregateCheckOutcomes, validateCheckAggregationSelection } from \"./aggregation.ts\";\nimport {\n  executeResolvedChecks,\n  type CheckExecutionClock,\n  type ResolvedCheckExecution\n} from \"./check-execution/resolved-checks.ts\";\nimport { planStaticCheckGraph } from \"./check-execution/plan.ts\";\nimport {\n  type ProgressRefreshScheduler,\n  type ProgressRendering,\n  type ProgressWriterFactory\n} from \"./progress-rendering/presentation.ts\";\nimport { completeInvocation, finalizeInvocation, type CoreExecution } from \"./completion.ts\";\nimport { createProjectContext } from \"./project-context.ts\";\nimport {\n  executionCancellation,\n  isCancelled,\n  planning,\n  preExecutionCancellation,\n  type NonConfigurationRunResult,\n  type RunDiagnostic,\n  type RunResult\n} from \"./result.ts\";\nimport {\n  diagnosticTags,\n  type DiagnosticLogger,\n  type DiagnosticLoggerFactory\n} from \"./diagnostic-logging/logger.ts\";\nimport { createInvocation } from \"./invocation-creation.ts\";\nimport type { OutputStatuses } from \"./output-status.ts\";\nexport type Invocation = Readonly<{\n  readonly clock: CheckExecutionClock;\n  readonly controls: RunControls;\n  readonly declarativeFingerprint: string;\n  readonly definition: ProjectDefinition;\n  readonly definitionWarnings: readonly DefinitionWarning[];\n  readonly diagnosticLogger: DiagnosticLogger;\n  readonly outputConfiguration: ProjectDefinition[\"outputs\"];\n  readonly outputs: OutputStatuses;\n  readonly invocationId: string;\n  readonly normalized: NormalizedProjectDefinition;\n  readonly progressRendering: ProgressRendering;\n  readonly projectRoot: string;\n  /** Immutable UTC instant captured for enabled diagnostic or machine output, otherwise `null`. */\n  readonly startedAtUtc: string | null;\n}>;\nexport interface RunInvocationDependencies {\n  readonly clock?: CheckExecutionClock;\n  readonly progressRefreshScheduler?: ProgressRefreshScheduler;\n  readonly progressWriterFactory?: ProgressWriterFactory;\n  readonly diagnosticLoggerFactory?: DiagnosticLoggerFactory;\n  /** Test seam for the invocation's machine-readable wall-clock timestamp. */\n  readonly wallClock?: Readonly<{ now(): Date }>;\n}\nexport async function executeValidatedRun(\n  definition: ProjectDefinition,\n  controls: RunControls,\n  definitionWarnings: readonly DefinitionWarning[],\n  dependencies: RunInvocationDependencies = {}\n): Promise<RunResult> {\n  const normalized = normalizeProjectDefinition(definition);\n  const aggregation = validateCheckAggregationSelection(\n    controls.checkAggregation,\n    normalized.checks.map((check) => check.definition.checkId)\n  );\n  if (!aggregation.ok)\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([...definitionWarnings]),\n      diagnostic: aggregation.error\n    });\n\n  const invocation = createInvocation({\n    controls,\n    definition,\n    definitionWarnings,\n    dependencies,\n    normalized\n  });\n  let candidate: NonConfigurationRunResult;\n  try {\n    observeInvocationStarted(invocation, aggregation.value);\n    if (isCancelled(controls)) {\n      candidate = cancelledBeforeExecution(invocation, \"pre-work\");\n    } else if (!validateTaskGraph(invocation)) {\n      candidate = planningResult(invocation, \"task-graph-invalid\");\n    } else {\n      candidate = await executePlannedInvocation(invocation, aggregation.value);\n    }\n  } catch {\n    candidate = executionResult(invocation, \"task-engine-failed\");\n  }\n  return finalizeInvocation(invocation, candidate);\n}\n\nfunction observeInvocationStarted(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined\n): void {\n  invocation.diagnosticLogger.observe({\n    event: \"run.started\",\n    tags: diagnosticTags(\"RUN\", \"STARTED\"),\n    details: {\n      aggregation: aggregation ?? null,\n      checkCount: invocation.normalized.checks.length,\n      flags: invocation.controls.flags ?? [],\n      invocationId: invocation.invocationId,\n      outputs: invocation.outputConfiguration,\n      scheduler: invocation.normalized.declarative.scheduler\n    }\n  });\n}\n\nfunction validateTaskGraph(invocation: Invocation): boolean {\n  try {\n    prepareTaskGraph(\n      planStaticCheckGraph(invocation.normalized.checks),\n      invocation.normalized.declarative.scheduler.maxParallel\n    );\n    invocation.diagnosticLogger.observe({\n      event: \"run.planning.succeeded\",\n      tags: diagnosticTags(\"RUN\", \"PLANNING\", \"SUCCEEDED\"),\n      details: {\n        checkCount: invocation.normalized.checks.length,\n        maxParallel: invocation.normalized.declarative.scheduler.maxParallel\n      }\n    });\n    return true;\n  } catch {\n    invocation.diagnosticLogger.observe({\n      event: \"run.planning.failed\",\n      tags: diagnosticTags(\"RUN\", \"PLANNING\", \"FAILED\"),\n      details: {\n        checkCount: invocation.normalized.checks.length,\n        maxParallel: invocation.normalized.declarative.scheduler.maxParallel\n      }\n    });\n    return false;\n  }\n}\nasync function executePlannedInvocation(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined\n): Promise<NonConfigurationRunResult> {\n  if (isCancelled(invocation.controls)) return cancelledBeforeExecution(invocation, \"pre-work\");\n  return executePreparedInvocation(\n    invocation,\n    aggregation,\n    createProjectContext({ controls: invocation.controls, root: invocation.projectRoot })\n  );\n}\nasync function executePreparedInvocation(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined,\n  project: CheckProjectContext\n): Promise<NonConfigurationRunResult> {\n  if (isCancelled(invocation.controls)) return cancelledBeforeExecution(invocation, \"planning\");\n  invocation.progressRendering.prepared(invocation.normalized.checks.length);\n  const executionStartedAt = invocation.clock.now();\n  const executed = await executeChecks(invocation, project, invocation.clock);\n  if (isExecutionRunResult(executed)) return executed;\n  invocation.progressRendering.final({\n    counts: outcomeCounts(executed.snapshot),\n    elapsedMs: elapsedSince(executionStartedAt, invocation.clock),\n    execution: executed.kind\n  });\n  if (executed.kind === \"cancelled\") {\n    invocation.diagnosticLogger.observe({\n      event: \"run.execution.cancelled\",\n      tags: diagnosticTags(\"RUN\", \"EXECUTION\", \"CANCELLED\"),\n      details: { checkCount: executed.snapshot.checks.length }\n    });\n    return executionCancellation({\n      checkDurations: executed.checkDurations,\n      checkMessages: executed.checkMessages,\n      declarativeFingerprint: invocation.declarativeFingerprint,\n      definitionWarnings: invocation.definitionWarnings,\n      outputs: invocation.outputs.value(),\n      snapshot: executed.snapshot\n    });\n  }\n  const aggregate =\n    aggregation === undefined ? null : aggregateCheckOutcomes(executed.snapshot, aggregation);\n  invocation.diagnosticLogger.observe({\n    event: \"run.aggregation.completed\",\n    tags: diagnosticTags(\"RUN\", \"AGGREGATION\", \"COMPLETED\"),\n    details: { aggregate, selection: aggregation ?? null }\n  });\n  const core: CoreExecution = Object.freeze({\n    aggregate,\n    checkDurations: executed.checkDurations,\n    checkMessages: executed.checkMessages,\n    snapshot: executed.snapshot\n  });\n  return completeInvocation(invocation, core);\n}\n\nfunction cancelledBeforeExecution(\n  invocation: Invocation,\n  phase: \"pre-work\" | \"planning\"\n): NonConfigurationRunResult {\n  invocation.diagnosticLogger.observe({\n    event: \"run.cancelled\",\n    tags: diagnosticTags(\"RUN\", \"CANCELLED\"),\n    details: { phase }\n  });\n  return preExecutionCancellation(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    phase\n  );\n}\n\nasync function executeChecks(\n  invocation: Invocation,\n  project: CheckProjectContext,\n  clock: CheckExecutionClock\n): Promise<ResolvedCheckExecution | NonConfigurationRunResult> {\n  try {\n    return await executeResolvedChecks({\n      checks: invocation.normalized.checks,\n      clock,\n      diagnosticLogger: invocation.diagnosticLogger,\n      maxParallel: invocation.normalized.declarative.scheduler.maxParallel,\n      lifecycle: invocation.progressRendering.lifecycle,\n      project,\n      signal: invocation.controls.signal\n    });\n  } catch {\n    return executionResult(invocation, \"task-engine-failed\");\n  }\n}\nfunction outcomeCounts(snapshot: CoreSnapshot): Readonly<{\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n}> {\n  let failed = 0,\n    notApplicable = 0,\n    passed = 0,\n    unavailable = 0;\n  for (const check of snapshot.checks) {\n    switch (check.outcome.status) {\n      case \"passed\":\n        passed += 1;\n        break;\n      case \"failed\":\n        failed += 1;\n        break;\n      case \"not-applicable\":\n        notApplicable += 1;\n        break;\n      case \"unavailable\":\n        unavailable += 1;\n        break;\n    }\n  }\n  return Object.freeze({ failed, notApplicable, passed, unavailable });\n}\nfunction elapsedSince(startedAt: number, clock: CheckExecutionClock): number {\n  const elapsed = clock.now() - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\nfunction planningResult(\n  invocation: Invocation,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): NonConfigurationRunResult {\n  return planning(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    code\n  );\n}\nfunction executionResult(\n  invocation: Invocation,\n  code: Extract<RunDiagnostic[\"code\"], \"publication-model-failed\" | \"task-engine-failed\">\n): NonConfigurationRunResult {\n  return Object.freeze({\n    kind: \"execution\",\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    definitionWarnings: invocation.definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs: invocation.outputs.value()\n  });\n}\nfunction isExecutionRunResult(\n  value: ResolvedCheckExecution | NonConfigurationRunResult\n): value is NonConfigurationRunResult {\n  return \"declarativeFingerprint\" in value;\n}\n"]}

package/dist/esm/project-run/machine-publication.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"machine-publication.mjs","sourceRoot":"","sources":["../../../src/project-run/machine-publication.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAClC,KAKE;IAEF,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,CAAC;QACH,aAAa,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACpE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["import type { ProjectOutputs } from \"../project-definition/project-definition.ts\";\nimport type { TrustedPublicationModelV4 } from \"../machine-output/v4/publication-model.ts\";\nimport { publishScanV4 } from \"../machine-output/v4/publish.ts\";\nimport type { OutputStatuses } from \"./output-status.ts\";\n/** Publishes an already-trusted v4 model as the Run-owned machine output. */\nexport function publishMachineOutput(\n  input: Readonly<{\n    readonly configuration: ProjectOutputs[\"machinePublication\"];\n    readonly statuses: OutputStatuses;\n    readonly model: TrustedPublicationModelV4;\n    readonly directory: string;\n  }>\n): boolean {\n  if (!input.configuration.enabled) return true;\n  try {\n    publishScanV4({ artifactDir: input.directory, model: input.model });\n    input.statuses.succeeded(\"machinePublication\");\n    return true;\n  } catch {\n    input.statuses.failed(\"machinePublication\");\n    return false;\n  }\n}\n"]}

package/dist/esm/project-run/output-configuration.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-configuration.mjs","sourceRoot":"","sources":["../../../src/project-run/output-configuration.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,QAAqB;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC;YAChC,GAAG,UAAU,CAAC,OAAO,CAAC,kBAAkB;YACxC,GAAG,QAAQ,CAAC,OAAO,EAAE,kBAAkB;SACxC,CAAC;QACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;YAC/B,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB;YACvC,GAAG,QAAQ,CAAC,OAAO,EAAE,iBAAiB;SACvC,CAAC;QACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;YAC/B,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB;YACvC,GAAG,QAAQ,CAAC,OAAO,EAAE,iBAAiB;SACvC,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  ProjectDefinition,\n  ProjectOutputs\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nexport function effectiveOutputs(\n  definition: ProjectDefinition,\n  controls: RunControls\n): ProjectOutputs {\n  return Object.freeze({\n    machinePublication: Object.freeze({\n      ...definition.outputs.machinePublication,\n      ...controls.outputs?.machinePublication\n    }),\n    progressRendering: Object.freeze({\n      ...definition.outputs.progressRendering,\n      ...controls.outputs?.progressRendering\n    }),\n    diagnosticLogging: Object.freeze({\n      ...definition.outputs.diagnosticLogging,\n      ...controls.outputs?.diagnosticLogging\n    })\n  });\n}\n"]}