@zxyycom/vibe-check 0.0.1 → 0.0.2

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

@@ -0,0 +1,79 @@
+import { randomUUID } from "node:crypto";
+import { createDeclarativeFingerprint } from "../../project-definition/project-definition.mjs";
+import { createDiagnosticLogger, createDiagnosticLoggingRouter } from "../diagnostic-logging/logger.mjs";
+import { createOutputStatuses } from "../outputs/status.mjs";
+import { effectiveOutputs } from "../outputs/configuration.mjs";
+import { resolveInvocationPaths } from "./paths.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 diagnosticLoggingEnabled = outputConfiguration.diagnosticLogging.enabled;
+    const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);
+    const identity = createInvocationIdentity();
+    const paths = resolveInvocationPaths({
+        checkArtifactBaseDirectory: input.controls.checkArtifactBaseDirectory,
+        checkIds: input.normalized.checks.map((check) => check.definition.checkId),
+        diagnosticLogFileNaming: input.controls.diagnosticLogFileNaming ?? "unique",
+        diagnosticLogSuffix: diagnosticLoggingEnabled
+            ? diagnosticLogSuffix(requireStartedAtUtc(startedAtUtc), identity.uuid)
+            : undefined,
+        outputConfiguration,
+        progressLogFile: input.controls.progressLogFile,
+        projectRoot: input.controls.projectRoot ?? process.cwd()
+    });
+    const outputs = createOutputStatuses(outputConfiguration, paths.diagnosticLoggingReadbackFiles, input.normalized.scheduler.measurementHooks.length > 0);
+    const diagnosticLogging = createDiagnosticLoggingRouter({
+        clock,
+        coreFile: paths.diagnosticLoggingFiles.core,
+        factory: input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger,
+        invocationId: identity.id,
+        schedulerFile: paths.diagnosticLoggingFiles.scheduler
+    });
+    return Object.freeze({
+        admissionStrategyProviderFactory: input.dependencies.admissionStrategyProviderFactory,
+        clock,
+        controls: input.controls,
+        declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),
+        definition: input.definition,
+        definitionWarnings: Object.freeze([...input.definitionWarnings]),
+        diagnosticLogging,
+        diagnosticLoggingEnabled,
+        outputConfiguration,
+        outputs,
+        invocationId: identity.id,
+        paths,
+        normalized: input.normalized,
+        progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {
+            clock,
+            refreshScheduler: input.dependencies.progressRefreshScheduler,
+            writerFactory: input.dependencies.progressWriterFactory,
+            file: paths.progressLogFile
+        }),
+        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 diagnosticLogSuffix(startedAtUtc, invocationUuid) {
+    const compactUtc = startedAtUtc.replaceAll("-", "").replaceAll(":", "");
+    return `${compactUtc}-${invocationUuid}`;
+}
+function requireStartedAtUtc(startedAtUtc) {
+    if (startedAtUtc === null)
+        throw new Error("Enabled output requires an invocation timestamp");
+    return startedAtUtc;
+}
+//# sourceMappingURL=creation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creation.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/creation.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nimport {\n  createDeclarativeFingerprint,\n  type DefinitionWarning,\n  type NormalizedProjectDefinition,\n  type ProjectDefinition,\n  type ResolvedProjectOutputs\n} from \"../../project-definition/project-definition.ts\";\nimport type { RunControls } from \"../controls/contract.ts\";\nimport {\n  createDiagnosticLogger,\n  createDiagnosticLoggingRouter\n} from \"../diagnostic-logging/logger.ts\";\nimport type { Invocation, RunInvocationDependencies } from \"./run.ts\";\nimport { createOutputStatuses } from \"../outputs/status.ts\";\nimport { effectiveOutputs } from \"../outputs/configuration.ts\";\nimport { resolveInvocationPaths } from \"./paths.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 diagnosticLoggingEnabled = outputConfiguration.diagnosticLogging.enabled;\n  const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);\n  const identity = createInvocationIdentity();\n  const paths = resolveInvocationPaths({\n    checkArtifactBaseDirectory: input.controls.checkArtifactBaseDirectory,\n    checkIds: input.normalized.checks.map((check) => check.definition.checkId),\n    diagnosticLogFileNaming: input.controls.diagnosticLogFileNaming ?? \"unique\",\n    diagnosticLogSuffix: diagnosticLoggingEnabled\n      ? diagnosticLogSuffix(requireStartedAtUtc(startedAtUtc), identity.uuid)\n      : undefined,\n    outputConfiguration,\n    progressLogFile: input.controls.progressLogFile,\n    projectRoot: input.controls.projectRoot ?? process.cwd()\n  });\n  const outputs = createOutputStatuses(\n    outputConfiguration,\n    paths.diagnosticLoggingReadbackFiles,\n    input.normalized.scheduler.measurementHooks.length > 0\n  );\n  const diagnosticLogging = createDiagnosticLoggingRouter({\n    clock,\n    coreFile: paths.diagnosticLoggingFiles.core,\n    factory: input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger,\n    invocationId: identity.id,\n    schedulerFile: paths.diagnosticLoggingFiles.scheduler\n  });\n\n  return Object.freeze({\n    admissionStrategyProviderFactory: input.dependencies.admissionStrategyProviderFactory,\n    clock,\n    controls: input.controls,\n    declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),\n    definition: input.definition,\n    definitionWarnings: Object.freeze([...input.definitionWarnings]),\n    diagnosticLogging,\n    diagnosticLoggingEnabled,\n    outputConfiguration,\n    outputs,\n    invocationId: identity.id,\n    paths,\n    normalized: input.normalized,\n    progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {\n      clock,\n      refreshScheduler: input.dependencies.progressRefreshScheduler,\n      writerFactory: input.dependencies.progressWriterFactory,\n      file: paths.progressLogFile\n    }),\n    startedAtUtc\n  });\n}\n\nfunction captureOutputCreationTimestamp(\n  outputConfiguration: ResolvedProjectOutputs,\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<{\n  readonly id: string;\n  readonly uuid: string;\n}> {\n  const uuid = randomUUID();\n  return Object.freeze({ id: `invocation/v1:${uuid}`, uuid });\n}\n\nfunction diagnosticLogSuffix(startedAtUtc: string, invocationUuid: string): string {\n  const compactUtc = startedAtUtc.replaceAll(\"-\", \"\").replaceAll(\":\", \"\");\n  return `${compactUtc}-${invocationUuid}`;\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/paths.mjs

@@ -0,0 +1,77 @@
+import { createHash } from "node:crypto";
+import { join, relative, resolve } from "node:path";
+/** 在任何 author callback 前恰好一次解析全部 Product-owned invocation target。 */
+export function resolveInvocationPaths(input) {
+    const projectRoot = resolve(input.projectRoot);
+    const checkArtifactBaseDirectory = input.checkArtifactBaseDirectory === undefined
+        ? null
+        : resolve(projectRoot, input.checkArtifactBaseDirectory);
+    const diagnosticDirectory = resolve(projectRoot, input.outputConfiguration.diagnosticLogging.directory);
+    const diagnosticLoggingFiles = diagnosticFilesFor({
+        diagnosticDirectory,
+        diagnosticLogFileNaming: input.diagnosticLogFileNaming,
+        diagnosticLogSuffix: input.diagnosticLogSuffix
+    });
+    const machinePublicationDirectory = resolve(projectRoot, input.outputConfiguration.machinePublication.directory);
+    return Object.freeze({
+        checkArtifactDirectories: resolveCheckArtifactDirectories(checkArtifactBaseDirectory, input.checkIds),
+        checkArtifactBaseDirectory,
+        diagnosticLoggingFiles,
+        diagnosticLoggingReadbackFiles: diagnosticReadbackFiles(projectRoot, diagnosticLoggingFiles),
+        machinePublicationDirectory,
+        progressLogFile: input.progressLogFile === undefined ? null : resolve(projectRoot, input.progressLogFile),
+        projectRoot
+    });
+}
+function diagnosticFilesFor(input) {
+    const file = (channel) => {
+        if (input.diagnosticLogSuffix === undefined)
+            return null;
+        const basename = input.diagnosticLogFileNaming === "channel"
+            ? `${channel}.log`
+            : `${channel}-${input.diagnosticLogSuffix}.log`;
+        return join(input.diagnosticDirectory, basename);
+    };
+    return Object.freeze({
+        core: file("core"),
+        scheduler: file("scheduler")
+    });
+}
+function diagnosticReadbackFiles(projectRoot, files) {
+    const readback = (channel) => {
+        const file = files[channel];
+        return file === null ? null : relative(projectRoot, file);
+    };
+    return Object.freeze({
+        core: readback("core"),
+        scheduler: readback("scheduler")
+    });
+}
+/** 只返回当前 Check-local artifact directory，不向 callback 暴露 sibling directories。 */
+export function artifactDirectoryForCheck(paths, checkId) {
+    return (paths.checkArtifactDirectories.find((entry) => entry.checkId === checkId)?.directory ?? null);
+}
+function resolveCheckArtifactDirectories(checkArtifactBaseDirectory, checkIds) {
+    if (checkArtifactBaseDirectory === null)
+        return Object.freeze([]);
+    const directories = [];
+    const checkIdByEncodedDirectory = new Map();
+    for (const checkId of checkIds) {
+        const encodedDirectory = encodeCheckArtifactDirectory(checkId);
+        const priorCheckId = checkIdByEncodedDirectory.get(encodedDirectory);
+        if (priorCheckId !== undefined && priorCheckId !== checkId) {
+            throw new Error("Distinct Check IDs resolved to one artifact directory");
+        }
+        checkIdByEncodedDirectory.set(encodedDirectory, checkId);
+        directories.push(Object.freeze({ checkId, directory: join(checkArtifactBaseDirectory, encodedDirectory) }));
+    }
+    return Object.freeze(directories);
+}
+/**
+ * SHA-256 base64url component 不包含分隔符或 traversal token，且远低于常规 filesystem component length。
+ * raw Check ID 仍由既有 facts 保存。
+ */
+function encodeCheckArtifactDirectory(checkId) {
+    return `check-${createHash("sha256").update(checkId, "utf8").digest("base64url")}`;
+}
+//# sourceMappingURL=paths.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/paths.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { join, relative, resolve } from \"node:path\";\n\nimport type { DiagnosticChannel } from \"../diagnostic-logging/logger.ts\";\nimport type { DiagnosticLogFileNaming } from \"../controls/contract.ts\";\n\nimport type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\n\n/**\n * Invocation owner 的 absolute paths；刻意排除 caller-owned cross-Run state、cache storage 和\n * external-tool workspace。\n */\nexport type ResolvedInvocationPaths = Readonly<{\n  /** Check-local absolute directories；保持私有，避免披露 sibling capability。 */\n  readonly checkArtifactDirectories: readonly ResolvedCheckArtifactDirectory[];\n  /** caller 选择的 Check-owned invocation artifact absolute base；未配置时为 `null`。 */\n  readonly checkArtifactBaseDirectory: string | null;\n  /** 按 owner channel 分开的 diagnostic absolute targets。 */\n  readonly diagnosticLoggingFiles: Readonly<Record<DiagnosticChannel, string | null>>;\n  /** 按既有 RunResult-relative contract 投影的 diagnostic channel files。 */\n  readonly diagnosticLoggingReadbackFiles: Readonly<Record<DiagnosticChannel, string | null>>;\n  /** 本次 invocation 的 machine publisher absolute target。 */\n  readonly machinePublicationDirectory: string;\n  /** caller 为本 Run 指定的 progress transcript target；不设置则只保留 terminal。 */\n  readonly progressLogFile: string | null;\n  /** 每个 callback 共享的 absolute effective project root。 */\n  readonly projectRoot: string;\n}>;\n\n/** 在任何 author callback 前恰好一次解析全部 Product-owned invocation target。 */\nexport function resolveInvocationPaths(\n  input: Readonly<{\n    readonly checkArtifactBaseDirectory: string | undefined;\n    readonly checkIds: readonly string[];\n    readonly diagnosticLogFileNaming: DiagnosticLogFileNaming;\n    readonly diagnosticLogSuffix: string | undefined;\n    readonly outputConfiguration: ProjectOutputs;\n    readonly progressLogFile: string | undefined;\n    readonly projectRoot: string;\n  }>\n): ResolvedInvocationPaths {\n  const projectRoot = resolve(input.projectRoot);\n  const checkArtifactBaseDirectory =\n    input.checkArtifactBaseDirectory === undefined\n      ? null\n      : resolve(projectRoot, input.checkArtifactBaseDirectory);\n  const diagnosticDirectory = resolve(\n    projectRoot,\n    input.outputConfiguration.diagnosticLogging.directory\n  );\n  const diagnosticLoggingFiles = diagnosticFilesFor({\n    diagnosticDirectory,\n    diagnosticLogFileNaming: input.diagnosticLogFileNaming,\n    diagnosticLogSuffix: input.diagnosticLogSuffix\n  });\n  const machinePublicationDirectory = resolve(\n    projectRoot,\n    input.outputConfiguration.machinePublication.directory\n  );\n\n  return Object.freeze({\n    checkArtifactDirectories: resolveCheckArtifactDirectories(\n      checkArtifactBaseDirectory,\n      input.checkIds\n    ),\n    checkArtifactBaseDirectory,\n    diagnosticLoggingFiles,\n    diagnosticLoggingReadbackFiles: diagnosticReadbackFiles(projectRoot, diagnosticLoggingFiles),\n    machinePublicationDirectory,\n    progressLogFile:\n      input.progressLogFile === undefined ? null : resolve(projectRoot, input.progressLogFile),\n    projectRoot\n  });\n}\n\nfunction diagnosticFilesFor(\n  input: Readonly<{\n    readonly diagnosticDirectory: string;\n    readonly diagnosticLogFileNaming: DiagnosticLogFileNaming;\n    readonly diagnosticLogSuffix: string | undefined;\n  }>\n): Readonly<Record<DiagnosticChannel, string | null>> {\n  const file = (channel: DiagnosticChannel): string | null => {\n    if (input.diagnosticLogSuffix === undefined) return null;\n    const basename =\n      input.diagnosticLogFileNaming === \"channel\"\n        ? `${channel}.log`\n        : `${channel}-${input.diagnosticLogSuffix}.log`;\n    return join(input.diagnosticDirectory, basename);\n  };\n  return Object.freeze({\n    core: file(\"core\"),\n    scheduler: file(\"scheduler\")\n  });\n}\n\nfunction diagnosticReadbackFiles(\n  projectRoot: string,\n  files: Readonly<Record<DiagnosticChannel, string | null>>\n): Readonly<Record<DiagnosticChannel, string | null>> {\n  const readback = (channel: DiagnosticChannel): string | null => {\n    const file = files[channel];\n    return file === null ? null : relative(projectRoot, file);\n  };\n  return Object.freeze({\n    core: readback(\"core\"),\n    scheduler: readback(\"scheduler\")\n  });\n}\n\ntype ResolvedCheckArtifactDirectory = Readonly<{\n  readonly checkId: string;\n  readonly directory: string;\n}>;\n\n/** 只返回当前 Check-local artifact directory，不向 callback 暴露 sibling directories。 */\nexport function artifactDirectoryForCheck(\n  paths: ResolvedInvocationPaths,\n  checkId: string\n): string | null {\n  return (\n    paths.checkArtifactDirectories.find((entry) => entry.checkId === checkId)?.directory ?? null\n  );\n}\n\nfunction resolveCheckArtifactDirectories(\n  checkArtifactBaseDirectory: string | null,\n  checkIds: readonly string[]\n): readonly ResolvedCheckArtifactDirectory[] {\n  if (checkArtifactBaseDirectory === null) return Object.freeze([]);\n\n  const directories: ResolvedCheckArtifactDirectory[] = [];\n  const checkIdByEncodedDirectory = new Map<string, string>();\n  for (const checkId of checkIds) {\n    const encodedDirectory = encodeCheckArtifactDirectory(checkId);\n    const priorCheckId = checkIdByEncodedDirectory.get(encodedDirectory);\n    if (priorCheckId !== undefined && priorCheckId !== checkId) {\n      throw new Error(\"Distinct Check IDs resolved to one artifact directory\");\n    }\n    checkIdByEncodedDirectory.set(encodedDirectory, checkId);\n    directories.push(\n      Object.freeze({ checkId, directory: join(checkArtifactBaseDirectory, encodedDirectory) })\n    );\n  }\n  return Object.freeze(directories);\n}\n\n/**\n * SHA-256 base64url component 不包含分隔符或 traversal token，且远低于常规 filesystem component length。\n * raw Check ID 仍由既有 facts 保存。\n */\nfunction encodeCheckArtifactDirectory(checkId: string): string {\n  return `check-${createHash(\"sha256\").update(checkId, \"utf8\").digest(\"base64url\")}`;\n}\n"]}

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

@@ -0,0 +1,30 @@
+/** Forms the terminal progress counters without changing Core Check facts. */
+export function outcomeCounts(snapshot) {
+    let failed = 0;
+    let notApplicable = 0;
+    let passed = 0;
+    let 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 });
+}
+/** Converts the invocation monotonic clock into a safe progress duration. */
+export function elapsedSince(startedAt, clock) {
+    const elapsed = clock.now() - startedAt;
+    return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;
+}
+//# sourceMappingURL=progress.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/progress.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,QAAsB;IAMlD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,QAAQ,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7B,KAAK,QAAQ;gBACX,MAAM,IAAI,CAAC,CAAC;gBACZ,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,IAAI,CAAC,CAAC;gBACZ,MAAM;YACR,KAAK,gBAAgB;gBACnB,aAAa,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR,KAAK,aAAa;gBAChB,WAAW,IAAI,CAAC,CAAC;gBACjB,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,KAA0B;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import type { CoreSnapshot } from \"../../check-settlement/facts.ts\";\nimport type { CheckExecutionClock } from \"../check-execution/resolved-checks.ts\";\n\n/** Forms the terminal progress counters without changing Core Check facts. */\nexport function 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  let notApplicable = 0;\n  let passed = 0;\n  let 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}\n\n/** Converts the invocation monotonic clock into a safe progress duration. */\nexport function elapsedSince(startedAt: number, clock: CheckExecutionClock): number {\n  const elapsed = clock.now() - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\n"]}

package/dist/esm/project-run/{invocation.mjs → invocation/run.mjs}

@@ -1,14 +1,18 @@
-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";
+import { normalizeProjectDefinition } from "../../project-definition/project-definition.mjs";
+import { createAdmissionStrategyProvider } from "../admission-strategy-provider/provider.mjs";
+import { AdmissionStrategyPreparationFailure } from "../admission-strategy-provider/custom-strategy-preparation.mjs";
+import { prepareTaskGraph } from "../task-scheduler/graph.mjs";
+import { validateCheckAggregationSelection } from "../aggregation.mjs";
+import {} from "../check-execution/resolved-checks.mjs";
+import { planStaticCheckGraph } from "../check-execution/plan.mjs";
+import {} from "../progress-rendering/presentation.mjs";
+import { finalizeInvocation } from "../completion/completion.mjs";
+import { createProjectContext } from "../project-context.mjs";
+import { isCancelled, planning, preExecutionCancellation } from "../result.mjs";
+import { diagnosticTags, summarizeDiagnosticValue } from "../diagnostic-logging/logger.mjs";
+import { createInvocation } from "./creation.mjs";
+import { executeScheduler } from "./scheduler.mjs";
+import { mapResolvedExecutionToRunCandidate } from "./candidate.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));
@@ -44,14 +48,13 @@ export async function executeValidatedRun(definition, controls, definitionWarnin
     return finalizeInvocation(invocation, candidate);
 }
 function observeInvocationStarted(invocation, aggregation) {
-    invocation.diagnosticLogger.observe({
+    invocation.diagnosticLogging.core.observe({
         event: "run.started",
         tags: diagnosticTags("RUN", "STARTED"),
         details: {
             aggregation: aggregation ?? null,
             checkCount: invocation.normalized.checks.length,
-            flags: invocation.controls.flags ?? [],
-            invocationId: invocation.invocationId,
+            flags: summarizeDiagnosticValue(invocation.controls.flags ?? []),
             outputs: invocation.outputConfiguration,
             scheduler: invocation.normalized.declarative.scheduler
         }
@@ -59,8 +62,8 @@ function observeInvocationStarted(invocation, aggregation) {
 }
 function validateTaskGraph(invocation) {
     try {
-        prepareTaskGraph(planStaticCheckGraph(invocation.normalized.checks), invocation.normalized.declarative.scheduler.maxParallel);
-        invocation.diagnosticLogger.observe({
+        prepareTaskGraph(planStaticCheckGraph(invocation.normalized.checks, invocation.normalized.declarative.scheduler.resourceCapacities), invocation.normalized.declarative.scheduler.maxParallel);
+        invocation.diagnosticLogging.core.observe({
             event: "run.planning.succeeded",
             tags: diagnosticTags("RUN", "PLANNING", "SUCCEEDED"),
             details: {
@@ -71,7 +74,7 @@ function validateTaskGraph(invocation) {
         return true;
     }
     catch {
-        invocation.diagnosticLogger.observe({
+        invocation.diagnosticLogging.core.observe({
             event: "run.planning.failed",
             tags: diagnosticTags("RUN", "PLANNING", "FAILED"),
             details: {
@@ -85,98 +88,81 @@ function validateTaskGraph(invocation) {
 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 }));
+    return executePreparedInvocation(invocation, aggregation, createProjectContext({ controls: invocation.controls, paths: invocation.paths }));
 }
 async function executePreparedInvocation(invocation, aggregation, project) {
     if (isCancelled(invocation.controls))
         return cancelledBeforeExecution(invocation, "planning");
+    let preparedStrategy;
+    try {
+        preparedStrategy = await prepareAdmissionStrategy(invocation);
+    }
+    catch (error) {
+        if (error instanceof AdmissionStrategyPreparationFailure) {
+            return executionResult(invocation, "admission-strategy-preparation-failed");
+        }
+        throw error;
+    }
+    if (preparedStrategy.completion.kind === "measurement-hook") {
+        invocation.outputs.enableMeasurementHooks();
+    }
     invocation.progressRendering.prepared(invocation.normalized.checks.length);
     const executionStartedAt = invocation.clock.now();
-    const executed = await executeChecks(invocation, project, invocation.clock);
+    const executed = await executeScheduler({ invocation, preparedStrategy, project });
     if (isExecutionRunResult(executed))
         return executed;
-    invocation.progressRendering.final({
-        counts: outcomeCounts(executed.snapshot),
-        elapsedMs: elapsedSince(executionStartedAt, invocation.clock),
-        execution: executed.kind
+    await completeAdmissionStrategyAfterTerminalMeasurement(preparedStrategy, executed, invocation.outputs);
+    return mapResolvedExecutionToRunCandidate({
+        aggregation,
+        executed,
+        executionStartedAt,
+        invocation
     });
-    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
+}
+/** Composes one invocation-local strategy only after the static Task graph is valid. */
+async function prepareAdmissionStrategy(invocation) {
+    const graph = prepareTaskGraph(planStaticCheckGraph(invocation.normalized.checks, invocation.normalized.declarative.scheduler.resourceCapacities), invocation.normalized.declarative.scheduler.maxParallel);
+    const admissionStrategyProviderFactory = invocation.admissionStrategyProviderFactory ?? createAdmissionStrategyProvider;
+    const provider = admissionStrategyProviderFactory({
+        admissionPolicy: invocation.normalized.scheduler.admissionPolicy,
+        graph: graph.schedulerGraphSnapshot
     });
-    return completeInvocation(invocation, core);
+    return provider.prepare();
+}
+/** The prepared provider closes only after Scheduler terminal measurement and Hooks have settled. */
+async function completeAdmissionStrategyAfterTerminalMeasurement(preparedStrategy, executed, outputs) {
+    const terminalMeasurement = executed.terminalSchedulerMeasurement;
+    if (terminalMeasurement === undefined)
+        return;
+    switch (preparedStrategy.completion.kind) {
+        case "none":
+            return;
+        case "internal":
+            try {
+                await preparedStrategy.completion.complete(Object.freeze({ terminalMeasurement }));
+            }
+            catch {
+                // Private learned lifecycle cannot revise sealed execution or public output facts.
+            }
+            return;
+        case "measurement-hook":
+            try {
+                await preparedStrategy.completion.complete(terminalMeasurement);
+                outputs.succeeded("measurementHooks");
+            }
+            catch {
+                outputs.failed("measurementHooks");
+            }
+    }
 }
 function cancelledBeforeExecution(invocation, phase) {
-    invocation.diagnosticLogger.observe({
+    invocation.diagnosticLogging.core.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);
 }
@@ -192,4 +178,4 @@ function executionResult(invocation, code) {
 function isExecutionRunResult(value) {
     return "declarativeFingerprint" in value;
 }
-//# sourceMappingURL=invocation.mjs.map
+//# sourceMappingURL=run.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/run.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckProjectContext } from \"../../check/check.ts\";\nimport {\n  normalizeProjectDefinition,\n  type DefinitionWarning,\n  type NormalizedProjectDefinition,\n  type ProjectDefinition,\n  type ResolvedProjectOutputs\n} from \"../../project-definition/project-definition.ts\";\nimport type { CheckAggregation, RunControls } from \"../controls/contract.ts\";\nimport {\n  createAdmissionStrategyProvider,\n  type AdmissionStrategyProviderFactory\n} from \"../admission-strategy-provider/provider.ts\";\nimport { AdmissionStrategyPreparationFailure } from \"../admission-strategy-provider/custom-strategy-preparation.ts\";\nimport type { PreparedAdmissionStrategy } from \"../admission-strategy-provider/prepared-admission-strategy.ts\";\nimport { prepareTaskGraph } from \"../task-scheduler/graph.ts\";\nimport { validateCheckAggregationSelection } from \"../aggregation.ts\";\nimport { type CheckExecutionClock } from \"../check-execution/resolved-checks.ts\";\nimport type { ResolvedCheckExecution } from \"../check-execution/resolved-execution-result.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 { finalizeInvocation } from \"../completion/completion.ts\";\nimport { createProjectContext } from \"../project-context.ts\";\nimport type { ResolvedInvocationPaths } from \"./paths.ts\";\nimport {\n  isCancelled,\n  planning,\n  preExecutionCancellation,\n  type NonConfigurationRunResult,\n  type RunDiagnostic,\n  type RunResult\n} from \"../result.ts\";\nimport {\n  diagnosticTags,\n  summarizeDiagnosticValue,\n  type DiagnosticLoggerFactory,\n  type DiagnosticLoggingRouter\n} from \"../diagnostic-logging/logger.ts\";\nimport { createInvocation } from \"./creation.ts\";\nimport type { OutputStatuses } from \"../outputs/status.ts\";\nimport { executeScheduler, type SchedulerExecution } from \"./scheduler.ts\";\nimport { mapResolvedExecutionToRunCandidate } from \"./candidate.ts\";\nexport type Invocation = Readonly<{\n  /** Product-private test seam; package `run` never accepts a provider factory. */\n  readonly admissionStrategyProviderFactory: AdmissionStrategyProviderFactory | undefined;\n  readonly clock: CheckExecutionClock;\n  readonly controls: RunControls;\n  readonly declarativeFingerprint: string;\n  readonly definition: ProjectDefinition;\n  readonly definitionWarnings: readonly DefinitionWarning[];\n  readonly diagnosticLogging: DiagnosticLoggingRouter;\n  /** Effective output selection, retained privately for enabled-only Scheduler diagnostics. */\n  readonly diagnosticLoggingEnabled: boolean;\n  readonly outputConfiguration: ResolvedProjectOutputs;\n  readonly outputs: OutputStatuses;\n  readonly invocationId: string;\n  readonly normalized: NormalizedProjectDefinition;\n  /** 本次 invocation 冻结的 Product-private output 与 Check artifact paths。 */\n  readonly paths: ResolvedInvocationPaths;\n  readonly progressRendering: ProgressRendering;\n  /** Immutable UTC instant captured for enabled diagnostic or machine output, otherwise `null`. */\n  readonly startedAtUtc: string | null;\n}>;\nexport interface RunInvocationDependencies {\n  /** Product-private test seam for proving invocation lifecycle sequencing. */\n  readonly admissionStrategyProviderFactory?: AdmissionStrategyProviderFactory;\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}\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.diagnosticLogging.core.observe({\n    event: \"run.started\",\n    tags: diagnosticTags(\"RUN\", \"STARTED\"),\n    details: {\n      aggregation: aggregation ?? null,\n      checkCount: invocation.normalized.checks.length,\n      flags: summarizeDiagnosticValue(invocation.controls.flags ?? []),\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(\n        invocation.normalized.checks,\n        invocation.normalized.declarative.scheduler.resourceCapacities\n      ),\n      invocation.normalized.declarative.scheduler.maxParallel\n    );\n    invocation.diagnosticLogging.core.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.diagnosticLogging.core.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, paths: invocation.paths })\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  let preparedStrategy: PreparedAdmissionStrategy;\n  try {\n    preparedStrategy = await prepareAdmissionStrategy(invocation);\n  } catch (error) {\n    if (error instanceof AdmissionStrategyPreparationFailure) {\n      return executionResult(invocation, \"admission-strategy-preparation-failed\");\n    }\n    throw error;\n  }\n  if (preparedStrategy.completion.kind === \"measurement-hook\") {\n    invocation.outputs.enableMeasurementHooks();\n  }\n  invocation.progressRendering.prepared(invocation.normalized.checks.length);\n  const executionStartedAt = invocation.clock.now();\n  const executed = await executeScheduler({ invocation, preparedStrategy, project });\n  if (isExecutionRunResult(executed)) return executed;\n  await completeAdmissionStrategyAfterTerminalMeasurement(\n    preparedStrategy,\n    executed,\n    invocation.outputs\n  );\n  return mapResolvedExecutionToRunCandidate({\n    aggregation,\n    executed,\n    executionStartedAt,\n    invocation\n  });\n}\n\n/** Composes one invocation-local strategy only after the static Task graph is valid. */\nasync function prepareAdmissionStrategy(\n  invocation: Invocation\n): Promise<PreparedAdmissionStrategy> {\n  const graph = prepareTaskGraph(\n    planStaticCheckGraph(\n      invocation.normalized.checks,\n      invocation.normalized.declarative.scheduler.resourceCapacities\n    ),\n    invocation.normalized.declarative.scheduler.maxParallel\n  );\n  const admissionStrategyProviderFactory =\n    invocation.admissionStrategyProviderFactory ?? createAdmissionStrategyProvider;\n  const provider = admissionStrategyProviderFactory({\n    admissionPolicy: invocation.normalized.scheduler.admissionPolicy,\n    graph: graph.schedulerGraphSnapshot\n  });\n  return provider.prepare();\n}\n\n/** The prepared provider closes only after Scheduler terminal measurement and Hooks have settled. */\nasync function completeAdmissionStrategyAfterTerminalMeasurement(\n  preparedStrategy: PreparedAdmissionStrategy,\n  executed: ResolvedCheckExecution,\n  outputs: OutputStatuses\n): Promise<void> {\n  const terminalMeasurement = executed.terminalSchedulerMeasurement;\n  if (terminalMeasurement === undefined) return;\n  switch (preparedStrategy.completion.kind) {\n    case \"none\":\n      return;\n    case \"internal\":\n      try {\n        await preparedStrategy.completion.complete(Object.freeze({ terminalMeasurement }));\n      } catch {\n        // Private learned lifecycle cannot revise sealed execution or public output facts.\n      }\n      return;\n    case \"measurement-hook\":\n      try {\n        await preparedStrategy.completion.complete(terminalMeasurement);\n        outputs.succeeded(\"measurementHooks\");\n      } catch {\n        outputs.failed(\"measurementHooks\");\n      }\n  }\n}\n\nfunction cancelledBeforeExecution(\n  invocation: Invocation,\n  phase: \"pre-work\" | \"planning\"\n): NonConfigurationRunResult {\n  invocation.diagnosticLogging.core.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\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<\n    RunDiagnostic[\"code\"],\n    \"admission-strategy-preparation-failed\" | \"task-engine-failed\"\n  >\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: SchedulerExecution\n): value is Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return \"declarativeFingerprint\" in value;\n}\n"]}

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

@@ -0,0 +1,57 @@
+import { executeResolvedChecks } from "../check-execution/resolved-checks.mjs";
+/** Bridges one prepared invocation to resolved Check execution and contains task-engine faults. */
+export async function executeScheduler(input) {
+    const { invocation, preparedStrategy } = input;
+    try {
+        const performanceDiagnostics = schedulerPerformanceDiagnostics(input);
+        return await executeResolvedChecks({
+            admissionPolicy: preparedStrategy.admissionPolicy,
+            checks: invocation.normalized.checks,
+            clock: invocation.clock,
+            diagnosticLogger: invocation.diagnosticLogging.core,
+            ...(invocation.diagnosticLoggingEnabled
+                ? { schedulerDiagnosticLogger: invocation.diagnosticLogging.scheduler }
+                : {}),
+            schedulerPerformanceDiagnostics: performanceDiagnostics,
+            schedulerMeasurementHooks: invocation.normalized.scheduler.measurementHooks,
+            onSchedulerMeasurementHookFailure: () => invocation.outputs.failed("measurementHooks"),
+            onSchedulerMeasurementHooksSettled: () => invocation.outputs.succeeded("measurementHooks"),
+            maxParallel: invocation.normalized.declarative.scheduler.maxParallel,
+            resourceCapacities: invocation.normalized.declarative.scheduler.resourceCapacities,
+            invocationId: invocation.invocationId,
+            lifecycle: invocation.progressRendering.lifecycle,
+            paths: invocation.paths,
+            project: input.project,
+            signal: invocation.controls.signal
+        });
+    }
+    catch {
+        return taskEngineFailure(invocation);
+    }
+}
+function schedulerPerformanceDiagnostics(input) {
+    const { invocation, preparedStrategy } = input;
+    const shouldCollectSchedulerPerformanceDiagnostics = invocation.diagnosticLoggingEnabled ||
+        invocation.normalized.scheduler.measurementHooks.length > 0 ||
+        preparedStrategy.admissionPolicy.requiresMeasurement === true ||
+        preparedStrategy.requiresTerminalMeasurement;
+    if (!shouldCollectSchedulerPerformanceDiagnostics)
+        return undefined;
+    return Object.freeze({
+        clock: invocation.clock,
+        declarativeFingerprint: invocation.declarativeFingerprint,
+        ...(invocation.diagnosticLoggingEnabled
+            ? { logger: invocation.diagnosticLogging.scheduler }
+            : {})
+    });
+}
+function taskEngineFailure(invocation) {
+    return Object.freeze({
+        kind: "execution",
+        declarativeFingerprint: invocation.declarativeFingerprint,
+        definitionWarnings: invocation.definitionWarnings,
+        diagnostic: Object.freeze({ code: "task-engine-failed" }),
+        outputs: invocation.outputs.value()
+    });
+}
+//# sourceMappingURL=scheduler.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAe9E,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA4B;IACjE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,sBAAsB,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,MAAM,qBAAqB,CAAC;YACjC,eAAe,EAAE,gBAAgB,CAAC,eAAe;YACjD,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM;YACpC,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,gBAAgB,EAAE,UAAU,CAAC,iBAAiB,CAAC,IAAI;YACnD,GAAG,CAAC,UAAU,CAAC,wBAAwB;gBACrC,CAAC,CAAC,EAAE,yBAAyB,EAAE,UAAU,CAAC,iBAAiB,CAAC,SAAS,EAAE;gBACvE,CAAC,CAAC,EAAE,CAAC;YACP,+BAA+B,EAAE,sBAAsB;YACvD,yBAAyB,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB;YAC3E,iCAAiC,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;YACtF,kCAAkC,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC;YAC1F,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW;YACpE,kBAAkB,EAAE,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,kBAAkB;YAClF,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,SAAS,EAAE,UAAU,CAAC,iBAAiB,CAAC,SAAS;YACjD,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;SACnC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,+BAA+B,CAAC,KAA4B;IACnE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,4CAA4C,GAChD,UAAU,CAAC,wBAAwB;QACnC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC3D,gBAAgB,CAAC,eAAe,CAAC,mBAAmB,KAAK,IAAI;QAC7D,gBAAgB,CAAC,2BAA2B,CAAC;IAC/C,IAAI,CAAC,4CAA4C;QAAE,OAAO,SAAS,CAAC;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,GAAG,CAAC,UAAU,CAAC,wBAAwB;YACrC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,iBAAiB,CAAC,SAAS,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,UAAsB;IAEtB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;QACjD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACzD,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE;KACpC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext } from \"../../check/check.ts\";\nimport type { PreparedAdmissionStrategy } from \"../admission-strategy-provider/prepared-admission-strategy.ts\";\nimport { executeResolvedChecks } from \"../check-execution/resolved-checks.ts\";\nimport type { ResolvedCheckExecution } from \"../check-execution/resolved-execution-result.ts\";\nimport type { Invocation } from \"./run.ts\";\nimport type { NonConfigurationRunResult } from \"../result.ts\";\n\nexport type SchedulerExecution =\n  | ResolvedCheckExecution\n  | Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }>;\n\ntype SchedulerAdapterInput = Readonly<{\n  readonly invocation: Invocation;\n  readonly preparedStrategy: PreparedAdmissionStrategy;\n  readonly project: CheckProjectContext;\n}>;\n\n/** Bridges one prepared invocation to resolved Check execution and contains task-engine faults. */\nexport async function executeScheduler(input: SchedulerAdapterInput): Promise<SchedulerExecution> {\n  const { invocation, preparedStrategy } = input;\n  try {\n    const performanceDiagnostics = schedulerPerformanceDiagnostics(input);\n    return await executeResolvedChecks({\n      admissionPolicy: preparedStrategy.admissionPolicy,\n      checks: invocation.normalized.checks,\n      clock: invocation.clock,\n      diagnosticLogger: invocation.diagnosticLogging.core,\n      ...(invocation.diagnosticLoggingEnabled\n        ? { schedulerDiagnosticLogger: invocation.diagnosticLogging.scheduler }\n        : {}),\n      schedulerPerformanceDiagnostics: performanceDiagnostics,\n      schedulerMeasurementHooks: invocation.normalized.scheduler.measurementHooks,\n      onSchedulerMeasurementHookFailure: () => invocation.outputs.failed(\"measurementHooks\"),\n      onSchedulerMeasurementHooksSettled: () => invocation.outputs.succeeded(\"measurementHooks\"),\n      maxParallel: invocation.normalized.declarative.scheduler.maxParallel,\n      resourceCapacities: invocation.normalized.declarative.scheduler.resourceCapacities,\n      invocationId: invocation.invocationId,\n      lifecycle: invocation.progressRendering.lifecycle,\n      paths: invocation.paths,\n      project: input.project,\n      signal: invocation.controls.signal\n    });\n  } catch {\n    return taskEngineFailure(invocation);\n  }\n}\n\nfunction schedulerPerformanceDiagnostics(input: SchedulerAdapterInput) {\n  const { invocation, preparedStrategy } = input;\n  const shouldCollectSchedulerPerformanceDiagnostics =\n    invocation.diagnosticLoggingEnabled ||\n    invocation.normalized.scheduler.measurementHooks.length > 0 ||\n    preparedStrategy.admissionPolicy.requiresMeasurement === true ||\n    preparedStrategy.requiresTerminalMeasurement;\n  if (!shouldCollectSchedulerPerformanceDiagnostics) return undefined;\n  return Object.freeze({\n    clock: invocation.clock,\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    ...(invocation.diagnosticLoggingEnabled\n      ? { logger: invocation.diagnosticLogging.scheduler }\n      : {})\n  });\n}\n\nfunction taskEngineFailure(\n  invocation: Invocation\n): Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return Object.freeze({\n    kind: \"execution\",\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    definitionWarnings: invocation.definitionWarnings,\n    diagnostic: Object.freeze({ code: \"task-engine-failed\" }),\n    outputs: invocation.outputs.value()\n  });\n}\n"]}

package/dist/esm/project-run/{output-configuration.mjs → outputs/configuration.mjs}

@@ -1,10 +1,11 @@
+import { resolveProgressRenderingOutput } from "../../project-definition/output-defaults.mjs";
 export function effectiveOutputs(definition, controls) {
     return Object.freeze({
         machinePublication: Object.freeze({
             ...definition.outputs.machinePublication,
             ...controls.outputs?.machinePublication
         }),
-        progressRendering: Object.freeze({
+        progressRendering: resolveProgressRenderingOutput({
             ...definition.outputs.progressRendering,
             ...controls.outputs?.progressRendering
         }),
@@ -14,4 +15,4 @@ export function effectiveOutputs(definition, controls) {
         })
     });
 }
-//# sourceMappingURL=output-configuration.mjs.map
+//# sourceMappingURL=configuration.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.mjs","sourceRoot":"","sources":["../../../../src/project-run/outputs/configuration.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAE7F,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,8BAA8B,CAAC;YAChD,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  ResolvedProjectOutputs\n} from \"../../project-definition/project-definition.ts\";\nimport { resolveProgressRenderingOutput } from \"../../project-definition/output-defaults.ts\";\nimport type { RunControls } from \"../controls/contract.ts\";\nexport function effectiveOutputs(\n  definition: ProjectDefinition,\n  controls: RunControls\n): ResolvedProjectOutputs {\n  return Object.freeze({\n    machinePublication: Object.freeze({\n      ...definition.outputs.machinePublication,\n      ...controls.outputs?.machinePublication\n    }),\n    progressRendering: resolveProgressRenderingOutput({\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"]}