@zxyycom/vibe-check 0.0.1 → 0.0.3

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/run.mjs

@@ -0,0 +1,82 @@
+import { normalizeProjectDefinition } from "../../project-definition/project-definition.mjs";
+import { prepareTaskGraph } from "../task-scheduler/graph.mjs";
+import { CheckAggregationFailure } from "../aggregation.mjs";
+import {} from "../check-execution/resolved-checks.mjs";
+import { planStaticCheckGraph } from "../check-execution/plan.mjs";
+import {} from "../progress-rendering/presentation.mjs";
+import { closeAggregationFailure, finalizeInvocation } from "../completion/completion.mjs";
+import { isCancelled } from "../result.mjs";
+import { diagnosticTags, summarizeDiagnosticValue } from "../diagnostic-logging/logger.mjs";
+import { createInvocation } from "./creation.mjs";
+import { cancelledBeforeExecution, executionResult, planningResult } from "./candidates.mjs";
+import { executePlannedInvocation } from "./execution.mjs";
+export async function executeValidatedRun(definition, controls, definitionWarnings, dependencies = {}) {
+    const normalized = normalizeProjectDefinition(definition);
+    const invocation = createInvocation({
+        controls,
+        definition,
+        definitionWarnings,
+        dependencies,
+        normalized
+    });
+    let candidate;
+    try {
+        observeInvocationStarted(invocation, controls.checkAggregation);
+        if (isCancelled(controls)) {
+            candidate = cancelledBeforeExecution(invocation, "pre-work");
+        }
+        else if (!validateTaskGraph(invocation)) {
+            candidate = planningResult(invocation, "task-graph-invalid");
+        }
+        else {
+            candidate = await executePlannedInvocation(invocation, controls.checkAggregation);
+        }
+    }
+    catch (error) {
+        if (error instanceof CheckAggregationFailure) {
+            closeAggregationFailure(invocation);
+            throw error.originalError;
+        }
+        candidate = executionResult(invocation, "task-engine-failed");
+    }
+    return finalizeInvocation(invocation, candidate);
+}
+function observeInvocationStarted(invocation, aggregation) {
+    invocation.diagnosticLogging.core.observe({
+        event: "run.started",
+        tags: diagnosticTags("RUN", "STARTED"),
+        details: {
+            aggregation: aggregation === undefined ? "default" : "custom",
+            checkCount: invocation.normalized.checks.length,
+            flags: summarizeDiagnosticValue(invocation.controls.flags ?? []),
+            outputs: invocation.outputConfiguration,
+            scheduler: invocation.normalized.declarative.scheduler
+        }
+    });
+}
+function validateTaskGraph(invocation) {
+    try {
+        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: {
+                checkCount: invocation.normalized.checks.length,
+                maxParallel: invocation.normalized.declarative.scheduler.maxParallel
+            }
+        });
+        return true;
+    }
+    catch {
+        invocation.diagnosticLogging.core.observe({
+            event: "run.planning.failed",
+            tags: diagnosticTags("RUN", "PLANNING", "FAILED"),
+            details: {
+                checkCount: invocation.normalized.checks.length,
+                maxParallel: invocation.normalized.declarative.scheduler.maxParallel
+            }
+        });
+        return false;
+    }
+}
+//# 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 {\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 type { AdmissionStrategyProviderFactory } from \"../admission-strategy-provider/provider.ts\";\nimport { prepareTaskGraph } from \"../task-scheduler/graph.ts\";\nimport { CheckAggregationFailure } from \"../aggregation.ts\";\nimport { type CheckExecutionClock } 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 { closeAggregationFailure, finalizeInvocation } from \"../completion/completion.ts\";\nimport type { ResolvedInvocationPaths } from \"./paths.ts\";\nimport type { OutputStatuses } from \"../outputs/status.ts\";\nimport { isCancelled, type NonConfigurationRunResult, type RunResult } 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 { cancelledBeforeExecution, executionResult, planningResult } from \"./candidates.ts\";\nimport { executePlannedInvocation } from \"./execution.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 invocation = createInvocation({\n    controls,\n    definition,\n    definitionWarnings,\n    dependencies,\n    normalized\n  });\n  let candidate: NonConfigurationRunResult;\n  try {\n    observeInvocationStarted(invocation, controls.checkAggregation);\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, controls.checkAggregation);\n    }\n  } catch (error) {\n    if (error instanceof CheckAggregationFailure) {\n      closeAggregationFailure(invocation);\n      throw error.originalError;\n    }\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 === undefined ? \"default\" : \"custom\",\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}\n"]}

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

@@ -0,0 +1,64 @@
+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 }
+                : {}),
+            ...(performanceDiagnostics === undefined
+                ? {}
+                : { schedulerPerformanceDiagnostics: performanceDiagnostics }),
+            schedulerTerminalEffects: invocation.normalized.scheduler.terminalEffects,
+            onSchedulerTerminalEffectFailure: () => {
+                invocation.outputs.failed("terminalEffects");
+            },
+            onSchedulerTerminalEffectsSettled: () => {
+                invocation.outputs.succeeded("terminalEffects");
+            },
+            maxParallel: invocation.normalized.declarative.scheduler.maxParallel,
+            resourceCapacities: invocation.normalized.declarative.scheduler.resourceCapacities,
+            invocationId: invocation.invocationId,
+            checkLifecycle: invocation.progressRendering.checkLifecycle,
+            invocationLifecycle: invocation.progressRendering.invocationLifecycle,
+            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.terminalEffects.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":"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","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      ...(performanceDiagnostics === undefined\n        ? {}\n        : { schedulerPerformanceDiagnostics: performanceDiagnostics }),\n      schedulerTerminalEffects: invocation.normalized.scheduler.terminalEffects,\n      onSchedulerTerminalEffectFailure: () => {\n        invocation.outputs.failed(\"terminalEffects\");\n      },\n      onSchedulerTerminalEffectsSettled: () => {\n        invocation.outputs.succeeded(\"terminalEffects\");\n      },\n      maxParallel: invocation.normalized.declarative.scheduler.maxParallel,\n      resourceCapacities: invocation.normalized.declarative.scheduler.resourceCapacities,\n      invocationId: invocation.invocationId,\n      checkLifecycle: invocation.progressRendering.checkLifecycle,\n      invocationLifecycle: invocation.progressRendering.invocationLifecycle,\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.terminalEffects.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"]}

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

@@ -0,0 +1,105 @@
+import { DIAGNOSTIC_CHANNELS } from "../diagnostic-logging/logger.mjs";
+export function createOutputStatuses(configuration, diagnosticLoggingFiles, initialTerminalEffectsEnabled) {
+    let terminalEffectsEnabled = initialTerminalEffectsEnabled;
+    const diagnosticChannelEnabled = Object.freeze({
+        core: configuration.diagnosticLogging.enabled,
+        scheduler: configuration.diagnosticLogging.enabled
+    });
+    const statuses = {
+        machinePublication: initialStatus(configuration.machinePublication.enabled),
+        progressRendering: initialStatus(configuration.progressRendering.enabled),
+        diagnosticLogging: initialStatus(configuration.diagnosticLogging.enabled),
+        terminalEffects: initialStatus(terminalEffectsEnabled)
+    };
+    const diagnosticChannelStatuses = {
+        core: initialStatus(diagnosticChannelEnabled.core),
+        scheduler: initialStatus(diagnosticChannelEnabled.scheduler)
+    };
+    const enabled = (output) => output === "terminalEffects" ? terminalEffectsEnabled : configuration[output].enabled;
+    const refreshDiagnosticAggregate = () => {
+        const enabledStatuses = DIAGNOSTIC_CHANNELS.filter((channel) => diagnosticChannelEnabled[channel]).map((channel) => diagnosticChannelStatuses[channel]);
+        if (enabledStatuses.includes("failed")) {
+            statuses.diagnosticLogging = "failed";
+            return;
+        }
+        if (enabledStatuses.every((status) => status === "succeeded")) {
+            statuses.diagnosticLogging = "succeeded";
+            return;
+        }
+        statuses.diagnosticLogging = enabledStatuses.every((status) => status === "disabled")
+            ? "disabled"
+            : "not-run";
+    };
+    return Object.freeze({
+        enableTerminalEffects: () => {
+            if (terminalEffectsEnabled)
+                return;
+            terminalEffectsEnabled = true;
+            statuses.terminalEffects = "not-run";
+        },
+        failedDiagnosticChannel: (channel) => {
+            if (!diagnosticChannelEnabled[channel])
+                return;
+            diagnosticChannelStatuses[channel] = "failed";
+            refreshDiagnosticAggregate();
+        },
+        failed: (output) => {
+            if (enabled(output))
+                statuses[output] = "failed";
+        },
+        succeededDiagnosticChannel: (channel) => {
+            if (!diagnosticChannelEnabled[channel] || diagnosticChannelStatuses[channel] === "failed")
+                return;
+            diagnosticChannelStatuses[channel] = "succeeded";
+            refreshDiagnosticAggregate();
+        },
+        succeeded: (output) => {
+            if (enabled(output) && statuses[output] !== "failed")
+                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({
+                channels: Object.freeze({
+                    core: diagnosticChannelValue("core"),
+                    scheduler: diagnosticChannelValue("scheduler")
+                }),
+                enabled: configuration.diagnosticLogging.enabled,
+                status: statuses.diagnosticLogging
+            }),
+            terminalEffects: Object.freeze({
+                enabled: terminalEffectsEnabled,
+                status: statuses.terminalEffects
+            })
+        })
+    });
+    function diagnosticChannelValue(channel) {
+        return Object.freeze({
+            enabled: diagnosticChannelEnabled[channel],
+            file: diagnosticLoggingFiles[channel],
+            status: diagnosticChannelStatuses[channel]
+        });
+    }
+}
+export function failedOutput(statuses) {
+    for (const output of [
+        "progressRendering",
+        "machinePublication",
+        "diagnosticLogging",
+        "terminalEffects"
+    ])
+        if (statuses[output].status === "failed")
+            return output;
+    return undefined;
+}
+function initialStatus(enabled) {
+    return enabled ? "not-run" : "disabled";
+}
+//# sourceMappingURL=status.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.mjs","sourceRoot":"","sources":["../../../../src/project-run/outputs/status.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport { DIAGNOSTIC_CHANNELS, type DiagnosticChannel } from \"../diagnostic-logging/logger.ts\";\n\n/** 一项 Run-owned terminal output 或 measurement participant 的最终状态 readback。 */\nexport interface RunOutputStatus {\n  /** effective configuration 是否启用该 participant；`false` 时 status 必为 `disabled`。 */\n  readonly enabled: boolean;\n  /** `disabled` 为未启用；`not-run` 为启用但未到达完成；`succeeded` 为完成，`failed` 为其 own I/O 或 hook failure。 */\n  readonly status: \"disabled\" | \"failed\" | \"not-run\" | \"succeeded\";\n}\n\n/** Product-owned 人读 diagnostic channel；即使 setup 失败也保留其 file readback。 */\nexport interface RunDiagnosticLoggingChannelStatus extends RunOutputStatus {\n  /**\n   * 相对 effective project root 的 target readback；跨卷时可为 absolute path。disabled channel 为 `null`，\n   * enabled channel 即使 setup 失败也保留预先计算的 path。\n   */\n  readonly file: string | null;\n}\n\n/** diagnostic logging aggregate 及其各 owner channel 的最终状态 readback。 */\nexport interface RunDiagnosticLoggingOutputStatus extends RunOutputStatus {\n  /** aggregate status 及每个 owner channel 的独立 readback；partial failure 可由此定位。 */\n  readonly channels: Readonly<Record<DiagnosticChannel, RunDiagnosticLoggingChannelStatus>>;\n}\n\n/** 配置有效后四个 terminal output participant 的独立最终状态。 */\nexport interface RunOutputStatuses {\n  /** `run.json` 与 `records.ndjson` canonical publication 的状态。 */\n  readonly machinePublication: RunOutputStatus;\n  /** terminal progress 与可选 progress log tee 的状态。 */\n  readonly progressRendering: RunOutputStatus;\n  /** core 与 scheduler diagnostic channels 的 aggregate 状态。 */\n  readonly diagnosticLogging: RunDiagnosticLoggingOutputStatus;\n  /**\n   * Definition generic effects 与 prepared custom strategy 的 optional `terminalEffect` 所形成的 terminal participant\n   * 状态；它不能由 RunControls 注入或覆盖。\n   */\n  readonly terminalEffects: RunOutputStatus;\n}\n\nexport interface OutputStatuses {\n  /** Enables a runtime-only terminal participant after successful preparation. */\n  readonly enableTerminalEffects: () => void;\n  /** A diagnostic channel failure is isolated but updates the aggregate diagnostic output. */\n  readonly failedDiagnosticChannel: (channel: DiagnosticChannel) => void;\n  readonly failed: (output: keyof RunOutputStatuses) => void;\n  readonly succeededDiagnosticChannel: (channel: DiagnosticChannel) => void;\n  readonly succeeded: (output: keyof RunOutputStatuses) => void;\n  readonly value: () => RunOutputStatuses;\n}\n\nexport function createOutputStatuses(\n  configuration: ProjectOutputs,\n  diagnosticLoggingFiles: Readonly<Record<DiagnosticChannel, string | null>>,\n  initialTerminalEffectsEnabled: boolean\n): OutputStatuses {\n  let terminalEffectsEnabled = initialTerminalEffectsEnabled;\n  const diagnosticChannelEnabled: Readonly<Record<DiagnosticChannel, boolean>> = Object.freeze({\n    core: configuration.diagnosticLogging.enabled,\n    scheduler: configuration.diagnosticLogging.enabled\n  });\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    terminalEffects: initialStatus(terminalEffectsEnabled)\n  };\n  const diagnosticChannelStatuses: Record<DiagnosticChannel, RunOutputStatus[\"status\"]> = {\n    core: initialStatus(diagnosticChannelEnabled.core),\n    scheduler: initialStatus(diagnosticChannelEnabled.scheduler)\n  };\n  const enabled = (output: keyof RunOutputStatuses): boolean =>\n    output === \"terminalEffects\" ? terminalEffectsEnabled : configuration[output].enabled;\n  const refreshDiagnosticAggregate = (): void => {\n    const enabledStatuses = DIAGNOSTIC_CHANNELS.filter(\n      (channel) => diagnosticChannelEnabled[channel]\n    ).map((channel) => diagnosticChannelStatuses[channel]);\n    if (enabledStatuses.includes(\"failed\")) {\n      statuses.diagnosticLogging = \"failed\";\n      return;\n    }\n    if (enabledStatuses.every((status) => status === \"succeeded\")) {\n      statuses.diagnosticLogging = \"succeeded\";\n      return;\n    }\n    statuses.diagnosticLogging = enabledStatuses.every((status) => status === \"disabled\")\n      ? \"disabled\"\n      : \"not-run\";\n  };\n  return Object.freeze({\n    enableTerminalEffects: () => {\n      if (terminalEffectsEnabled) return;\n      terminalEffectsEnabled = true;\n      statuses.terminalEffects = \"not-run\";\n    },\n    failedDiagnosticChannel: (channel: DiagnosticChannel) => {\n      if (!diagnosticChannelEnabled[channel]) return;\n      diagnosticChannelStatuses[channel] = \"failed\";\n      refreshDiagnosticAggregate();\n    },\n    failed: (output: keyof RunOutputStatuses) => {\n      if (enabled(output)) statuses[output] = \"failed\";\n    },\n    succeededDiagnosticChannel: (channel: DiagnosticChannel) => {\n      if (!diagnosticChannelEnabled[channel] || diagnosticChannelStatuses[channel] === \"failed\")\n        return;\n      diagnosticChannelStatuses[channel] = \"succeeded\";\n      refreshDiagnosticAggregate();\n    },\n    succeeded: (output: keyof RunOutputStatuses) => {\n      if (enabled(output) && statuses[output] !== \"failed\") 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          channels: Object.freeze({\n            core: diagnosticChannelValue(\"core\"),\n            scheduler: diagnosticChannelValue(\"scheduler\")\n          }),\n          enabled: configuration.diagnosticLogging.enabled,\n          status: statuses.diagnosticLogging\n        }),\n        terminalEffects: Object.freeze({\n          enabled: terminalEffectsEnabled,\n          status: statuses.terminalEffects\n        })\n      })\n  });\n\n  function diagnosticChannelValue(channel: DiagnosticChannel): RunDiagnosticLoggingChannelStatus {\n    return Object.freeze({\n      enabled: diagnosticChannelEnabled[channel],\n      file: diagnosticLoggingFiles[channel],\n      status: diagnosticChannelStatuses[channel]\n    });\n  }\n}\n\nexport function failedOutput(statuses: RunOutputStatuses): keyof RunOutputStatuses | undefined {\n  for (const output of [\n    \"progressRendering\",\n    \"machinePublication\",\n    \"diagnosticLogging\",\n    \"terminalEffects\"\n  ] 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"]}

package/dist/esm/project-run/progress-rendering/presentation.mjs

@@ -1,24 +1,32 @@
+import { closeSync, mkdirSync, openSync, writeSync } from "node:fs";
+import { dirname } from "node:path";
 import { createProgressRenderer } from "./renderer.mjs";
 const PROGRESS_REFRESH_INTERVAL_MS = 5_000;
 const defaultProgressRefreshScheduler = Object.freeze({
     schedule: (refresh, intervalMs) => {
         const interval = setInterval(refresh, intervalMs);
         interval.unref();
-        return Object.freeze({ cancel: () => clearInterval(interval) });
+        return Object.freeze({
+            cancel: () => {
+                clearInterval(interval);
+            }
+        });
     }
 });
-/** Owns progress writer lifecycle and rendering; failed writers are permanently muted. */
+/** Owns terminal progress and its optional file tee; terminal output survives a file-only failure. */
 export function createProgressRendering(configuration, statuses, dependencies = {}) {
     if (!configuration.enabled)
         return inertProgressRendering();
-    let failed = false;
+    let terminalFailed = false;
+    let closed = false;
     const runningCheckIds = new Set();
     let renderer;
+    let writer;
     let refreshSchedule;
-    const failRendering = () => {
-        if (failed)
+    const failTerminalRendering = () => {
+        if (terminalFailed)
             return;
-        failed = true;
+        terminalFailed = true;
         const activeSchedule = refreshSchedule;
         refreshSchedule = undefined;
         try {
@@ -36,35 +44,46 @@ export function createProgressRendering(configuration, statuses, dependencies =
             activeSchedule?.cancel();
         }
         catch {
-            failRendering();
+            failTerminalRendering();
         }
     };
+    const createRenderer = () => {
+        if (renderer !== undefined)
+            return renderer;
+        writer = createProgressTee({
+            file: dependencies.file ?? null,
+            onFileFailure: () => {
+                statuses.failed("progressRendering");
+            },
+            terminal: (dependencies.writerFactory ?? defaultProgressWriter)()
+        });
+        renderer = createProgressRenderer(writer, dependencies.clock, configuration);
+        return renderer;
+    };
     const render = (feedback) => {
-        if (failed)
+        if (terminalFailed)
             return;
         try {
-            renderer ??= createProgressRenderer((dependencies.writerFactory ?? defaultProgressWriter)(), dependencies.clock);
-            renderer.render(feedback);
-            if (feedback.kind === "final") {
+            createRenderer().render(feedback);
+            if (feedback.kind === "final")
                 statuses.succeeded("progressRendering");
-            }
         }
         catch {
-            failRendering();
+            failTerminalRendering();
         }
     };
     const refresh = () => {
-        if (failed)
+        if (terminalFailed)
             return;
         try {
             renderer?.refresh();
         }
         catch {
-            failRendering();
+            failTerminalRendering();
         }
     };
     const startRefresh = () => {
-        if (failed ||
+        if (terminalFailed ||
             refreshSchedule !== undefined ||
             runningCheckIds.size === 0 ||
             renderer?.refreshesRunningRegion !== true) {
@@ -74,12 +93,35 @@ export function createProgressRendering(configuration, statuses, dependencies =
             refreshSchedule = (dependencies.refreshScheduler ?? defaultProgressRefreshScheduler).schedule(refresh, PROGRESS_REFRESH_INTERVAL_MS);
         }
         catch {
-            failRendering();
+            failTerminalRendering();
+        }
+    };
+    const close = () => {
+        if (closed)
+            return;
+        closed = true;
+        stopRefresh();
+        if (writer === undefined)
+            return;
+        try {
+            writer.close?.();
+        }
+        catch {
+            // A terminal writer close is an output failure; a tee contains file-only failures itself.
+            statuses.failed("progressRendering");
         }
     };
     return Object.freeze({
-        prepared: (totalChecks) => render(Object.freeze({ kind: "prepared", totalChecks })),
-        lifecycle: Object.freeze({
+        close,
+        prepared: (totalChecks, quietPassOmissionConfiguredCount) => {
+            render(Object.freeze({ kind: "prepared", quietPassOmissionConfiguredCount, totalChecks }));
+        },
+        invocationLifecycle: Object.freeze({
+            selectionSettled: () => {
+                render(Object.freeze({ kind: "flag-control-completed" }));
+            }
+        }),
+        checkLifecycle: Object.freeze({
             settled: (fact) => {
                 render(Object.freeze({
                     kind: "settled",
@@ -88,7 +130,8 @@ export function createProgressRendering(configuration, statuses, dependencies =
                     durationMs: fact.durationMs,
                     messages: fact.messages,
                     outcome: fact.outcome,
-                    visibility: fact.visibility
+                    records: fact.records,
+                    omitQuietPassedRow: fact.omitQuietPassedRow
                 }));
                 runningCheckIds.delete(fact.checkId);
                 if (runningCheckIds.size === 0)
@@ -96,29 +139,40 @@ export function createProgressRendering(configuration, statuses, dependencies =
             },
             started: (fact) => {
                 runningCheckIds.add(fact.checkId);
-                render(Object.freeze({ kind: "started", checkId: fact.checkId, displayName: fact.displayName }));
+                render(Object.freeze({
+                    kind: "started",
+                    checkId: fact.checkId,
+                    displayName: fact.displayName,
+                    omitQuietPassedRow: fact.omitQuietPassedRow
+                }));
                 startRefresh();
             }
         }),
         final: (input) => {
             stopRefresh();
             render(Object.freeze({
-                kind: "final",
                 counts: input.counts,
                 elapsedMs: input.elapsedMs,
-                execution: input.execution
+                execution: input.execution,
+                kind: "final"
             }));
+            close();
         }
     });
 }
 function inertProgressRendering() {
-    const lifecycle = Object.freeze({
+    const invocationLifecycle = Object.freeze({
+        selectionSettled: () => undefined
+    });
+    const checkLifecycle = Object.freeze({
         settled: (_fact) => undefined,
         started: (_fact) => undefined
     });
     return Object.freeze({
-        prepared: (_totalChecks) => undefined,
-        lifecycle,
+        close: () => undefined,
+        prepared: (_totalChecks, _quietPassOmissionConfiguredCount) => undefined,
+        checkLifecycle,
+        invocationLifecycle,
         final: (_input) => undefined
     });
 }
@@ -132,4 +186,64 @@ function defaultProgressWriter() {
         }
     });
 }
+function createProgressTee(input) {
+    if (input.file === null)
+        return input.terminal;
+    let descriptor;
+    let fileFailed = false;
+    let closed = false;
+    const failFile = () => {
+        if (fileFailed)
+            return;
+        fileFailed = true;
+        input.onFileFailure();
+    };
+    try {
+        mkdirSync(dirname(input.file), { recursive: true });
+        descriptor = openSync(input.file, "wx");
+    }
+    catch {
+        failFile();
+    }
+    return Object.freeze({
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            if (descriptor === undefined)
+                return;
+            try {
+                closeSync(descriptor);
+            }
+            catch {
+                failFile();
+            }
+            descriptor = undefined;
+        },
+        color: input.terminal.color,
+        isTTY: input.terminal.isTTY,
+        term: input.terminal.term,
+        write: (content) => {
+            input.terminal.write(content);
+            if (fileFailed || descriptor === undefined)
+                return;
+            try {
+                writeFileBuffer(descriptor, content);
+            }
+            catch {
+                failFile();
+            }
+        }
+    });
+}
+function writeFileBuffer(descriptor, content) {
+    const bytes = Buffer.from(content, "utf8");
+    let offset = 0;
+    while (offset < bytes.length) {
+        const written = writeSync(descriptor, bytes, offset, bytes.length - offset, null);
+        if (written <= 0)
+            throw new Error("Progress log append made no progress");
+        offset += written;
+    }
+}
 //# sourceMappingURL=presentation.mjs.map