@zxyycom/vibe-check 0.0.1

package/dist/esm/project-run/diagnostic-logging/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../../../src/project-run/diagnostic-logging/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, mkdirSync, openSync, writeSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport type { CheckExecutionClock } from \"../check-execution/resolved-checks.ts\";\nimport { renderSafeDiagnosticDetail } from \"./diagnostic-detail-rendering.ts\";\nexport { summarizeDiagnosticValue } from \"./diagnostic-detail-rendering.ts\";\n\n/** Product-private observation written synchronously at the fact owner. */\nexport interface DiagnosticObservation {\n  readonly details?: unknown;\n  readonly event: string;\n  readonly tags: readonly string[];\n}\n\n/** Product-private invocation logger; its failures never escape lifecycle owners. */\nexport interface DiagnosticLogger {\n  close(): \"disabled\" | \"failed\" | \"succeeded\";\n  observe(observation: DiagnosticObservation): void;\n}\n\n/** A bounded, descriptor-safe description for normal diagnostic payloads. */\nexport type DiagnosticValueSummary =\n  | Readonly<{\n      readonly availability: \"available\";\n      readonly bytes: number;\n      readonly items?: number;\n      readonly keys?: number;\n      readonly shape: \"array\" | \"boolean\" | \"null\" | \"number\" | \"object\" | \"string\";\n    }>\n  | Readonly<{ readonly availability: \"unavailable\"; readonly reason: string }>;\n\n/** Test-only construction seam; Product invocation owns its lifecycle and output mapping. */\nexport type DiagnosticLoggerFactory = (\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly enabled: boolean;\n    readonly file: string | null;\n  }>\n) => DiagnosticLogger;\n\nexport const createDiagnosticLogger: DiagnosticLoggerFactory = (input) => {\n  if (!input.enabled || input.file === null) return disabledLogger();\n  return createEnabledLogger({ clock: input.clock, file: input.file });\n};\n\n/** Builds one immutable set of human-filterable diagnostic labels. */\nexport function diagnosticTags(...tags: readonly string[]): readonly string[] {\n  return Object.freeze([...tags]);\n}\n\nfunction disabledLogger(): DiagnosticLogger {\n  return Object.freeze({\n    close: () => \"disabled\" as const,\n    observe: () => undefined\n  });\n}\n\nfunction createEnabledLogger(\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly file: string;\n  }>\n): DiagnosticLogger {\n  let descriptor: number | undefined;\n  let failed = false;\n  let sequence = 0;\n  const startedAt = safeNow(input.clock);\n\n  try {\n    mkdirSync(dirname(input.file), { recursive: true });\n    descriptor = openSync(input.file, \"wx\");\n  } catch {\n    failed = true;\n  }\n\n  return Object.freeze({\n    close: () => {\n      if (descriptor !== undefined) {\n        try {\n          closeSync(descriptor);\n        } catch {\n          failed = true;\n        }\n        descriptor = undefined;\n      }\n      return failed ? \"failed\" : \"succeeded\";\n    },\n    observe: (observation: DiagnosticObservation) => {\n      if (failed || descriptor === undefined) return;\n      try {\n        const buffer = renderObservation({\n          elapsedMs: elapsedSince(startedAt, input.clock),\n          observation,\n          sequence: sequence + 1\n        });\n        sequence += 1;\n        writeBuffer(descriptor, buffer);\n      } catch {\n        failed = true;\n      }\n    }\n  });\n}\n\nfunction writeBuffer(descriptor: number, buffer: string): void {\n  const bytes = Buffer.from(buffer, \"utf8\");\n  let offset = 0;\n  while (offset < bytes.length) {\n    const written = writeSync(descriptor, bytes, offset, bytes.length - offset, null);\n    if (written <= 0) throw new Error(\"Diagnostic log append made no progress\");\n    offset += written;\n  }\n}\n\nfunction renderObservation(\n  input: Readonly<{\n    readonly elapsedMs: number;\n    readonly observation: DiagnosticObservation;\n    readonly sequence: number;\n  }>\n): string {\n  const tags = input.observation.tags.map((tag) => `[${escapeLogHeaderField(tag)}]`).join(\" \");\n  const header = `#${String(input.sequence).padStart(6, \"0\")} +${formatElapsed(input.elapsedMs)} ${tags} ${escapeLogHeaderField(input.observation.event)}`;\n  return renderFactLines(header, diagnosticFacts(input.observation));\n}\n\n/** Keeps author-controlled header fields on one physical header line. */\nfunction escapeLogHeaderField(text: string): string {\n  let escaped = \"\";\n  for (const character of text) {\n    if (character === \"\\\\\") {\n      escaped += \"\\\\\\\\\";\n      continue;\n    }\n    const codeUnit = character.charCodeAt(0);\n    escaped +=\n      codeUnit <= 0x1f ||\n      (codeUnit >= 0x7f && codeUnit <= 0x9f) ||\n      codeUnit === 0x5b ||\n      codeUnit === 0x5d ||\n      codeUnit === 0x2028 ||\n      codeUnit === 0x2029\n        ? `\\\\u${codeUnit.toString(16).padStart(4, \"0\")}`\n        : character;\n  }\n  return escaped;\n}\n\nfunction diagnosticFacts(observation: DiagnosticObservation): readonly string[] {\n  if (observation.details === undefined) return Object.freeze([]);\n  const rendered = renderSafeDiagnosticDetail(observation.details);\n  if (!rendered.ok)\n    return Object.freeze([`details=unavailable:${escapeLogHeaderField(rendered.reason)}`]);\n\n  const value: unknown = JSON.parse(rendered.text);\n  const facts: string[] = [];\n  flattenDiagnosticFacts(value, [], facts, observation);\n  return Object.freeze(facts);\n}\n\nfunction flattenDiagnosticFacts(\n  value: unknown,\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  if (Array.isArray(value)) {\n    flattenDiagnosticArrayFacts(value, path, facts, observation);\n    return;\n  }\n\n  if (value !== null && typeof value === \"object\") {\n    flattenDiagnosticRecordFacts(value, path, facts, observation);\n    return;\n  }\n\n  facts.push(`${factKey(path)}=${factValue(path, value)}`);\n}\n\nfunction flattenDiagnosticArrayFacts(\n  value: readonly unknown[],\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  const inline = JSON.stringify(value);\n  if (inline.length <= MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS) {\n    facts.push(`${factKey(path)}=${inline}`);\n    return;\n  }\n  const arrayPath = path.length === 0 ? [\"details\"] : path;\n  for (let index = 0; index < value.length; index += 1) {\n    flattenDiagnosticFacts(value[index], [...arrayPath, String(index)], facts, observation);\n  }\n}\n\nfunction flattenDiagnosticRecordFacts(\n  value: object,\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  const entries = Object.entries(value);\n  if (entries.length === 0) {\n    facts.push(`${factKey(path)}={}`);\n    return;\n  }\n  for (const [key, nested] of entries) {\n    if (path.length === 0 && isTopLevelFactRepresentedByTag(observation, key, nested)) continue;\n    flattenDiagnosticFacts(nested, [...path, key], facts, observation);\n  }\n}\n\n/** Omits only exact producer facts already visible in the observation's filter tags. */\nfunction isTopLevelFactRepresentedByTag(\n  observation: DiagnosticObservation,\n  key: string,\n  value: unknown\n): boolean {\n  if (typeof value !== \"string\") return false;\n  if (observation.event === \"scheduler.decision\") {\n    if (key === \"kind\") return observation.tags.includes(value.toUpperCase());\n    return key === \"taskId\" && observation.tags.includes(`TASK:${value}`);\n  }\n  return (\n    observation.event === \"record.reported\" &&\n    key === \"result\" &&\n    observation.tags.includes(value.toUpperCase())\n  );\n}\n\nconst MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS = 120;\n\nfunction factKey(path: readonly string[]): string {\n  if (path.length === 0) return \"details\";\n  const joined = path.join(\".\");\n  return /^[A-Za-z_][A-Za-z0-9_.-]*$/u.test(joined) ? joined : JSON.stringify(joined);\n}\n\nfunction factValue(path: readonly string[], value: unknown): string {\n  const key = path.at(-1);\n  if (typeof value === \"number\" && key?.endsWith(\"Ms\")) {\n    return String(Math.round(value * 1_000) / 1_000);\n  }\n  return JSON.stringify(value);\n}\n\nconst MAX_DIAGNOSTIC_LINE_CHARACTERS = 200;\n\nfunction renderFactLines(header: string, facts: readonly string[]): string {\n  if (facts.length === 0) return `${header}\\n`;\n\n  const lines: string[] = [];\n  let current = header;\n  for (const fact of facts) {\n    if (current.length + 1 + fact.length <= MAX_DIAGNOSTIC_LINE_CHARACTERS) {\n      current += ` ${fact}`;\n      continue;\n    }\n\n    lines.push(current);\n    const firstCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - \"│ \".length;\n    const continuationCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - \"│   \".length;\n    let offset = 0;\n    let prefix = \"│ \";\n    while (fact.length - offset > (prefix === \"│ \" ? firstCapacity : continuationCapacity)) {\n      const capacity = prefix === \"│ \" ? firstCapacity : continuationCapacity;\n      const end = diagnosticChunkEnd(fact, offset, capacity);\n      lines.push(`${prefix}${fact.slice(offset, end)}`);\n      offset = end;\n      prefix = \"│   \";\n    }\n    current = `${prefix}${fact.slice(offset)}`;\n  }\n  lines.push(current);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction diagnosticChunkEnd(text: string, offset: number, capacity: number): number {\n  let end = offset + capacity;\n  const preferredMinimum = offset + Math.floor(capacity * 0.6);\n  for (let index = end - 1; index >= preferredMinimum; index -= 1) {\n    if (text[index] === \" \") {\n      end = index;\n      break;\n    }\n    if (text[index] === \",\") {\n      end = index + 1;\n      break;\n    }\n  }\n  if (\n    end < text.length &&\n    text.charCodeAt(end - 1) >= 0xd800 &&\n    text.charCodeAt(end - 1) <= 0xdbff &&\n    text.charCodeAt(end) >= 0xdc00 &&\n    text.charCodeAt(end) <= 0xdfff\n  ) {\n    end -= 1;\n  }\n  return end;\n}\n\nfunction formatElapsed(elapsedMs: number): string {\n  const totalMilliseconds = Math.round(elapsedMs);\n  const hours = Math.floor(totalMilliseconds / 3_600_000);\n  const minutes = Math.floor((totalMilliseconds % 3_600_000) / 60_000);\n  const seconds = Math.floor((totalMilliseconds % 60_000) / 1_000);\n  const milliseconds = totalMilliseconds % 1_000;\n  return `${String(hours).padStart(2, \"0\")}:${String(minutes).padStart(2, \"0\")}:${String(seconds).padStart(2, \"0\")}.${String(milliseconds).padStart(3, \"0\")}`;\n}\n\nfunction safeNow(clock: CheckExecutionClock): number {\n  try {\n    const now = clock.now();\n    return Number.isFinite(now) ? now : 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction elapsedSince(startedAt: number, clock: CheckExecutionClock): number {\n  const elapsed = safeNow(clock) - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\n"]}

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

@@ -0,0 +1,111 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,195 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,16 @@
+import { publishScanV4 } from "../machine-output/v4/publish.mjs";
+/** Publishes an already-trusted v4 model as the Run-owned machine output. */
+export function publishMachineOutput(input) {
+    if (!input.configuration.enabled)
+        return true;
+    try {
+        publishScanV4({ artifactDir: input.directory, model: input.model });
+        input.statuses.succeeded("machinePublication");
+        return true;
+    }
+    catch {
+        input.statuses.failed("machinePublication");
+        return false;
+    }
+}
+//# sourceMappingURL=machine-publication.mjs.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,17 @@
+export function effectiveOutputs(definition, controls) {
+    return Object.freeze({
+        machinePublication: Object.freeze({
+            ...definition.outputs.machinePublication,
+            ...controls.outputs?.machinePublication
+        }),
+        progressRendering: Object.freeze({
+            ...definition.outputs.progressRendering,
+            ...controls.outputs?.progressRendering
+        }),
+        diagnosticLogging: Object.freeze({
+            ...definition.outputs.diagnosticLogging,
+            ...controls.outputs?.diagnosticLogging
+        })
+    });
+}
+//# sourceMappingURL=output-configuration.mjs.map

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

@@ -0,0 +1 @@
+{"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"]}

package/dist/esm/project-run/output-status.mjs

@@ -0,0 +1,43 @@
+export function createOutputStatuses(configuration, diagnosticLoggingFile) {
+    const statuses = {
+        machinePublication: initialStatus(configuration.machinePublication.enabled),
+        progressRendering: initialStatus(configuration.progressRendering.enabled),
+        diagnosticLogging: initialStatus(configuration.diagnosticLogging.enabled)
+    };
+    const enabled = (output) => configuration[output].enabled;
+    return Object.freeze({
+        failed: (output) => {
+            if (enabled(output))
+                statuses[output] = "failed";
+        },
+        succeeded: (output) => {
+            if (enabled(output))
+                statuses[output] = "succeeded";
+        },
+        value: () => Object.freeze({
+            machinePublication: Object.freeze({
+                enabled: configuration.machinePublication.enabled,
+                status: statuses.machinePublication
+            }),
+            progressRendering: Object.freeze({
+                enabled: configuration.progressRendering.enabled,
+                status: statuses.progressRendering
+            }),
+            diagnosticLogging: Object.freeze({
+                enabled: configuration.diagnosticLogging.enabled,
+                file: diagnosticLoggingFile,
+                status: statuses.diagnosticLogging
+            })
+        })
+    });
+}
+export function failedOutput(statuses) {
+    for (const output of ["progressRendering", "machinePublication", "diagnosticLogging"])
+        if (statuses[output].status === "failed")
+            return output;
+    return undefined;
+}
+function initialStatus(enabled) {
+    return enabled ? "not-run" : "disabled";
+}
+//# sourceMappingURL=output-status.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output-status.mjs","sourceRoot":"","sources":["../../../src/project-run/output-status.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,oBAAoB,CAClC,aAA6B,EAC7B,qBAAoC;IAEpC,MAAM,QAAQ,GAA+D;QAC3E,kBAAkB,EAAE,aAAa,CAAC,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC;QAC3E,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC;QACzE,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC;KAC1E,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,MAA+B,EAAW,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,MAA+B,EAAE,EAAE;YAC1C,IAAI,OAAO,CAAC,MAAM,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;QACnD,CAAC;QACD,SAAS,EAAE,CAAC,MAA+B,EAAE,EAAE;YAC7C,IAAI,OAAO,CAAC,MAAM,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;QACtD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CACV,MAAM,CAAC,MAAM,CAAC;YACZ,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC;gBAChC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,OAAO;gBACjD,MAAM,EAAE,QAAQ,CAAC,kBAAkB;aACpC,CAAC;YACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC/B,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,OAAO;gBAChD,MAAM,EAAE,QAAQ,CAAC,iBAAiB;aACnC,CAAC;YACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC/B,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,OAAO;gBAChD,IAAI,EAAE,qBAAqB;gBAC3B,MAAM,EAAE,QAAQ,CAAC,iBAAiB;aACnC,CAAC;SACH,CAAC;KACL,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAA2B;IACtD,KAAK,MAAM,MAAM,IAAI,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,CAAU;QAC5F,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,OAAO,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC1C,CAAC","sourcesContent":["import type { ProjectOutputs } from \"../project-definition/project-definition.ts\";\n\nexport interface RunOutputStatus {\n  readonly enabled: boolean;\n  readonly status: \"disabled\" | \"failed\" | \"not-run\" | \"succeeded\";\n}\n\nexport interface RunDiagnosticLoggingOutputStatus extends RunOutputStatus {\n  /** Project-root-relative target when enabled, otherwise `null`. */\n  readonly file: string | null;\n}\n\nexport interface RunOutputStatuses {\n  readonly machinePublication: RunOutputStatus;\n  readonly progressRendering: RunOutputStatus;\n  readonly diagnosticLogging: RunDiagnosticLoggingOutputStatus;\n}\n\nexport interface OutputStatuses {\n  readonly failed: (output: keyof RunOutputStatuses) => void;\n  readonly succeeded: (output: keyof RunOutputStatuses) => void;\n  readonly value: () => RunOutputStatuses;\n}\n\nexport function createOutputStatuses(\n  configuration: ProjectOutputs,\n  diagnosticLoggingFile: string | null\n): OutputStatuses {\n  const statuses: Record<keyof RunOutputStatuses, RunOutputStatus[\"status\"]> = {\n    machinePublication: initialStatus(configuration.machinePublication.enabled),\n    progressRendering: initialStatus(configuration.progressRendering.enabled),\n    diagnosticLogging: initialStatus(configuration.diagnosticLogging.enabled)\n  };\n  const enabled = (output: keyof RunOutputStatuses): boolean => configuration[output].enabled;\n  return Object.freeze({\n    failed: (output: keyof RunOutputStatuses) => {\n      if (enabled(output)) statuses[output] = \"failed\";\n    },\n    succeeded: (output: keyof RunOutputStatuses) => {\n      if (enabled(output)) statuses[output] = \"succeeded\";\n    },\n    value: () =>\n      Object.freeze({\n        machinePublication: Object.freeze({\n          enabled: configuration.machinePublication.enabled,\n          status: statuses.machinePublication\n        }),\n        progressRendering: Object.freeze({\n          enabled: configuration.progressRendering.enabled,\n          status: statuses.progressRendering\n        }),\n        diagnosticLogging: Object.freeze({\n          enabled: configuration.diagnosticLogging.enabled,\n          file: diagnosticLoggingFile,\n          status: statuses.diagnosticLogging\n        })\n      })\n  });\n}\n\nexport function failedOutput(statuses: RunOutputStatuses): keyof RunOutputStatuses | undefined {\n  for (const output of [\"progressRendering\", \"machinePublication\", \"diagnosticLogging\"] as const)\n    if (statuses[output].status === \"failed\") return output;\n  return undefined;\n}\n\nfunction initialStatus(enabled: boolean): RunOutputStatus[\"status\"] {\n  return enabled ? \"not-run\" : \"disabled\";\n}\n"]}