@zxyycom/vibe-check 0.0.1 → 0.0.2

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, initialMeasurementHooksEnabled) {
+    let measurementHooksEnabled = initialMeasurementHooksEnabled;
+    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),
+        measurementHooks: initialStatus(measurementHooksEnabled)
+    };
+    const diagnosticChannelStatuses = {
+        core: initialStatus(diagnosticChannelEnabled.core),
+        scheduler: initialStatus(diagnosticChannelEnabled.scheduler)
+    };
+    const enabled = (output) => output === "measurementHooks" ? measurementHooksEnabled : 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({
+        enableMeasurementHooks: () => {
+            if (measurementHooksEnabled)
+                return;
+            measurementHooksEnabled = true;
+            statuses.measurementHooks = "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
+            }),
+            measurementHooks: Object.freeze({
+                enabled: measurementHooksEnabled,
+                status: statuses.measurementHooks
+            })
+        })
+    });
+    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",
+        "measurementHooks"
+    ])
+        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 Hooks 与 prepared custom strategy 的 optional `complete` 所形成的 terminal participant\n   * 状态；它不能由 RunControls 注入或覆盖。\n   */\n  readonly measurementHooks: RunOutputStatus;\n}\n\nexport interface OutputStatuses {\n  /** Enables a runtime-only terminal participant after successful preparation. */\n  readonly enableMeasurementHooks: () => 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  initialMeasurementHooksEnabled: boolean\n): OutputStatuses {\n  let measurementHooksEnabled = initialMeasurementHooksEnabled;\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    measurementHooks: initialStatus(measurementHooksEnabled)\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 === \"measurementHooks\" ? measurementHooksEnabled : 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    enableMeasurementHooks: () => {\n      if (measurementHooksEnabled) return;\n      measurementHooksEnabled = true;\n      statuses.measurementHooks = \"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        measurementHooks: Object.freeze({\n          enabled: measurementHooksEnabled,\n          status: statuses.measurementHooks\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    \"measurementHooks\"\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,3 +1,5 @@
+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({
@@ -7,18 +9,20 @@ const defaultProgressRefreshScheduler = Object.freeze({
         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 +40,44 @@ 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 +87,29 @@ 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({
+        close,
         prepared: (totalChecks) => render(Object.freeze({ kind: "prepared", totalChecks })),
         lifecycle: Object.freeze({
+            flagControlCompleted: () => render(Object.freeze({ kind: "flag-control-completed" })),
             settled: (fact) => {
                 render(Object.freeze({
                     kind: "settled",
@@ -88,6 +118,7 @@ export function createProgressRendering(configuration, statuses, dependencies =
                     durationMs: fact.durationMs,
                     messages: fact.messages,
                     outcome: fact.outcome,
+                    records: fact.records,
                     visibility: fact.visibility
                 }));
                 runningCheckIds.delete(fact.checkId);
@@ -103,20 +134,23 @@ export function createProgressRendering(configuration, statuses, dependencies =
         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({
+        flagControlCompleted: () => undefined,
         settled: (_fact) => undefined,
         started: (_fact) => undefined
     });
     return Object.freeze({
+        close: () => undefined,
         prepared: (_totalChecks) => undefined,
         lifecycle,
         final: (_input) => undefined
@@ -132,4 +166,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

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

@@ -1 +1 @@
-{"version":3,"file":"presentation.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CheckExecutionLifecycle,\n  CheckSettledFact,\n  CheckStartedFact\n} from \"../check-execution/resolved-checks.ts\";\nimport {\n  createProgressRenderer,\n  type ProgressClock,\n  type ProgressFeedback,\n  type ProgressOutcomeCounts,\n  type ProgressWriter\n} from \"./renderer.ts\";\nimport type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport type { OutputStatuses } from \"../output-status.ts\";\nexport interface ProgressRendering {\n  readonly final: (input: ProgressFinalFeedback) => void;\n  readonly lifecycle: CheckExecutionLifecycle;\n  readonly prepared: (totalChecks: number) => void;\n}\nexport interface ProgressFinalFeedback {\n  readonly counts: ProgressOutcomeCounts;\n  readonly elapsedMs: number;\n  readonly execution: \"cancelled\" | \"completed\";\n}\nexport type ProgressWriterFactory = () => ProgressWriter;\n\nexport interface ProgressRefreshSchedule {\n  cancel(): void;\n}\n\nexport interface ProgressRefreshScheduler {\n  schedule(refresh: () => void, intervalMs: number): ProgressRefreshSchedule;\n}\n\nexport interface ProgressRenderingDependencies {\n  readonly clock?: ProgressClock;\n  readonly refreshScheduler?: ProgressRefreshScheduler;\n  readonly writerFactory?: ProgressWriterFactory;\n}\n\nconst PROGRESS_REFRESH_INTERVAL_MS = 5_000;\n\nconst defaultProgressRefreshScheduler: ProgressRefreshScheduler = Object.freeze({\n  schedule: (refresh: () => void, intervalMs: number) => {\n    const interval = setInterval(refresh, intervalMs);\n    interval.unref();\n    return Object.freeze({ cancel: () => clearInterval(interval) });\n  }\n});\n\n/** Owns progress writer lifecycle and rendering; failed writers are permanently muted. */\nexport function createProgressRendering(\n  configuration: ProjectOutputs[\"progressRendering\"],\n  statuses: OutputStatuses,\n  dependencies: ProgressRenderingDependencies = {}\n): ProgressRendering {\n  if (!configuration.enabled) return inertProgressRendering();\n  let failed = false;\n  const runningCheckIds = new Set<string>();\n  let renderer: ReturnType<typeof createProgressRenderer> | undefined;\n  let refreshSchedule: ProgressRefreshSchedule | undefined;\n\n  const failRendering = (): void => {\n    if (failed) return;\n    failed = true;\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      // The output is already failed; a scheduler cleanup fault must not reach Check execution.\n    }\n    statuses.failed(\"progressRendering\");\n  };\n\n  const stopRefresh = (): void => {\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      failRendering();\n    }\n  };\n\n  const render = (feedback: ProgressFeedback): void => {\n    if (failed) return;\n    try {\n      renderer ??= createProgressRenderer(\n        (dependencies.writerFactory ?? defaultProgressWriter)(),\n        dependencies.clock\n      );\n      renderer.render(feedback);\n      if (feedback.kind === \"final\") {\n        statuses.succeeded(\"progressRendering\");\n      }\n    } catch {\n      failRendering();\n    }\n  };\n\n  const refresh = (): void => {\n    if (failed) return;\n    try {\n      renderer?.refresh();\n    } catch {\n      failRendering();\n    }\n  };\n\n  const startRefresh = (): void => {\n    if (\n      failed ||\n      refreshSchedule !== undefined ||\n      runningCheckIds.size === 0 ||\n      renderer?.refreshesRunningRegion !== true\n    ) {\n      return;\n    }\n    try {\n      refreshSchedule = (dependencies.refreshScheduler ?? defaultProgressRefreshScheduler).schedule(\n        refresh,\n        PROGRESS_REFRESH_INTERVAL_MS\n      );\n    } catch {\n      failRendering();\n    }\n  };\n\n  return Object.freeze({\n    prepared: (totalChecks: number) => render(Object.freeze({ kind: \"prepared\", totalChecks })),\n    lifecycle: Object.freeze({\n      settled: (fact: CheckSettledFact) => {\n        render(\n          Object.freeze({\n            kind: \"settled\",\n            checkId: fact.checkId,\n            displayName: fact.displayName,\n            durationMs: fact.durationMs,\n            messages: fact.messages,\n            outcome: fact.outcome,\n            visibility: fact.visibility\n          })\n        );\n        runningCheckIds.delete(fact.checkId);\n        if (runningCheckIds.size === 0) stopRefresh();\n      },\n      started: (fact: CheckStartedFact) => {\n        runningCheckIds.add(fact.checkId);\n        render(\n          Object.freeze({ kind: \"started\", checkId: fact.checkId, displayName: fact.displayName })\n        );\n        startRefresh();\n      }\n    }),\n    final: (input: ProgressFinalFeedback) => {\n      stopRefresh();\n      render(\n        Object.freeze({\n          kind: \"final\",\n          counts: input.counts,\n          elapsedMs: input.elapsedMs,\n          execution: input.execution\n        })\n      );\n    }\n  });\n}\nfunction inertProgressRendering(): ProgressRendering {\n  const lifecycle = Object.freeze({\n    settled: (_fact: CheckSettledFact): void => undefined,\n    started: (_fact: CheckStartedFact): void => undefined\n  });\n  return Object.freeze({\n    prepared: (_totalChecks: number): void => undefined,\n    lifecycle,\n    final: (_input: ProgressFinalFeedback): void => undefined\n  });\n}\nfunction defaultProgressWriter(): ProgressWriter {\n  return Object.freeze({\n    color: process.stdout.isTTY === true && process.env.NO_COLOR === undefined,\n    isTTY: process.stdout.isTTY === true,\n    term: process.env.TERM,\n    write: (content: string) => {\n      process.stdout.write(content);\n    }\n  });\n}\n"]}
+{"version":3,"file":"presentation.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, mkdirSync, openSync, writeSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport type {\n  CheckExecutionLifecycle,\n  CheckSettledFact,\n  CheckStartedFact\n} from \"../check-execution/lifecycle.ts\";\nimport {\n  createProgressRenderer,\n  type ProgressClock,\n  type ProgressFeedback,\n  type ProgressOutcomeCounts,\n  type ProgressWriter\n} from \"./renderer.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport type { OutputStatuses } from \"../outputs/status.ts\";\nexport interface ProgressRendering {\n  /** Closes only an already-created file tee; it never creates a writer after pre-work termination. */\n  readonly close: () => void;\n  readonly final: (input: ProgressFinalFeedback) => void;\n  readonly lifecycle: CheckExecutionLifecycle;\n  readonly prepared: (totalChecks: number) => void;\n}\nexport interface ProgressFinalFeedback {\n  readonly counts: ProgressOutcomeCounts;\n  readonly elapsedMs: number;\n  readonly execution: \"cancelled\" | \"completed\";\n}\nexport type ProgressWriterFactory = () => ProgressWriter;\n\nexport interface ProgressRefreshSchedule {\n  cancel(): void;\n}\n\nexport interface ProgressRefreshScheduler {\n  schedule(refresh: () => void, intervalMs: number): ProgressRefreshSchedule;\n}\n\nexport interface ProgressRenderingDependencies {\n  readonly clock?: ProgressClock;\n  /** Caller-owned exact progress transcript target for this invocation; `null` keeps terminal-only output. */\n  readonly file?: string | null;\n  readonly refreshScheduler?: ProgressRefreshScheduler;\n  readonly writerFactory?: ProgressWriterFactory;\n}\n\nconst PROGRESS_REFRESH_INTERVAL_MS = 5_000;\n\nconst defaultProgressRefreshScheduler: ProgressRefreshScheduler = Object.freeze({\n  schedule: (refresh: () => void, intervalMs: number) => {\n    const interval = setInterval(refresh, intervalMs);\n    interval.unref();\n    return Object.freeze({ cancel: () => clearInterval(interval) });\n  }\n});\n\n/** Owns terminal progress and its optional file tee; terminal output survives a file-only failure. */\nexport function createProgressRendering(\n  configuration: ResolvedProgressRenderingOutput,\n  statuses: OutputStatuses,\n  dependencies: ProgressRenderingDependencies = {}\n): ProgressRendering {\n  if (!configuration.enabled) return inertProgressRendering();\n  let terminalFailed = false;\n  let closed = false;\n  const runningCheckIds = new Set<string>();\n  let renderer: ReturnType<typeof createProgressRenderer> | undefined;\n  let writer: ProgressWriter | undefined;\n  let refreshSchedule: ProgressRefreshSchedule | undefined;\n\n  const failTerminalRendering = (): void => {\n    if (terminalFailed) return;\n    terminalFailed = true;\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      // The output is already failed; a scheduler cleanup fault must not reach Check execution.\n    }\n    statuses.failed(\"progressRendering\");\n  };\n\n  const stopRefresh = (): void => {\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      failTerminalRendering();\n    }\n  };\n\n  const createRenderer = (): ReturnType<typeof createProgressRenderer> => {\n    if (renderer !== undefined) return renderer;\n    writer = createProgressTee({\n      file: dependencies.file ?? null,\n      onFileFailure: () => statuses.failed(\"progressRendering\"),\n      terminal: (dependencies.writerFactory ?? defaultProgressWriter)()\n    });\n    renderer = createProgressRenderer(writer, dependencies.clock, configuration);\n    return renderer;\n  };\n\n  const render = (feedback: ProgressFeedback): void => {\n    if (terminalFailed) return;\n    try {\n      createRenderer().render(feedback);\n      if (feedback.kind === \"final\") statuses.succeeded(\"progressRendering\");\n    } catch {\n      failTerminalRendering();\n    }\n  };\n\n  const refresh = (): void => {\n    if (terminalFailed) return;\n    try {\n      renderer?.refresh();\n    } catch {\n      failTerminalRendering();\n    }\n  };\n\n  const startRefresh = (): void => {\n    if (\n      terminalFailed ||\n      refreshSchedule !== undefined ||\n      runningCheckIds.size === 0 ||\n      renderer?.refreshesRunningRegion !== true\n    ) {\n      return;\n    }\n    try {\n      refreshSchedule = (dependencies.refreshScheduler ?? defaultProgressRefreshScheduler).schedule(\n        refresh,\n        PROGRESS_REFRESH_INTERVAL_MS\n      );\n    } catch {\n      failTerminalRendering();\n    }\n  };\n\n  const close = (): void => {\n    if (closed) return;\n    closed = true;\n    stopRefresh();\n    if (writer === undefined) return;\n    try {\n      writer.close?.();\n    } catch {\n      // A terminal writer close is an output failure; a tee contains file-only failures itself.\n      statuses.failed(\"progressRendering\");\n    }\n  };\n\n  return Object.freeze({\n    close,\n    prepared: (totalChecks: number) => render(Object.freeze({ kind: \"prepared\", totalChecks })),\n    lifecycle: Object.freeze({\n      flagControlCompleted: () => render(Object.freeze({ kind: \"flag-control-completed\" })),\n      settled: (fact: CheckSettledFact) => {\n        render(\n          Object.freeze({\n            kind: \"settled\",\n            checkId: fact.checkId,\n            displayName: fact.displayName,\n            durationMs: fact.durationMs,\n            messages: fact.messages,\n            outcome: fact.outcome,\n            records: fact.records,\n            visibility: fact.visibility\n          })\n        );\n        runningCheckIds.delete(fact.checkId);\n        if (runningCheckIds.size === 0) stopRefresh();\n      },\n      started: (fact: CheckStartedFact) => {\n        runningCheckIds.add(fact.checkId);\n        render(\n          Object.freeze({ kind: \"started\", checkId: fact.checkId, displayName: fact.displayName })\n        );\n        startRefresh();\n      }\n    }),\n    final: (input: ProgressFinalFeedback) => {\n      stopRefresh();\n      render(\n        Object.freeze({\n          counts: input.counts,\n          elapsedMs: input.elapsedMs,\n          execution: input.execution,\n          kind: \"final\"\n        })\n      );\n      close();\n    }\n  });\n}\nfunction inertProgressRendering(): ProgressRendering {\n  const lifecycle = Object.freeze({\n    flagControlCompleted: (): void => undefined,\n    settled: (_fact: CheckSettledFact): void => undefined,\n    started: (_fact: CheckStartedFact): void => undefined\n  });\n  return Object.freeze({\n    close: (): void => undefined,\n    prepared: (_totalChecks: number): void => undefined,\n    lifecycle,\n    final: (_input: ProgressFinalFeedback): void => undefined\n  });\n}\nfunction defaultProgressWriter(): ProgressWriter {\n  return Object.freeze({\n    color: process.stdout.isTTY === true && process.env.NO_COLOR === undefined,\n    isTTY: process.stdout.isTTY === true,\n    term: process.env.TERM,\n    write: (content: string) => {\n      process.stdout.write(content);\n    }\n  });\n}\n\nfunction createProgressTee(\n  input: Readonly<{\n    readonly file: string | null;\n    readonly onFileFailure: () => void;\n    readonly terminal: ProgressWriter;\n  }>\n): ProgressWriter {\n  if (input.file === null) return input.terminal;\n  let descriptor: number | undefined;\n  let fileFailed = false;\n  let closed = false;\n  const failFile = (): void => {\n    if (fileFailed) return;\n    fileFailed = true;\n    input.onFileFailure();\n  };\n  try {\n    mkdirSync(dirname(input.file), { recursive: true });\n    descriptor = openSync(input.file, \"wx\");\n  } catch {\n    failFile();\n  }\n  return Object.freeze({\n    close: (): void => {\n      if (closed) return;\n      closed = true;\n      if (descriptor === undefined) return;\n      try {\n        closeSync(descriptor);\n      } catch {\n        failFile();\n      }\n      descriptor = undefined;\n    },\n    color: input.terminal.color,\n    isTTY: input.terminal.isTTY,\n    term: input.terminal.term,\n    write: (content: string): void => {\n      input.terminal.write(content);\n      if (fileFailed || descriptor === undefined) return;\n      try {\n        writeFileBuffer(descriptor, content);\n      } catch {\n        failFile();\n      }\n    }\n  });\n}\n\nfunction writeFileBuffer(descriptor: number, content: string): void {\n  const bytes = Buffer.from(content, \"utf8\");\n  let offset = 0;\n  while (offset < bytes.length) {\n    const written = writeSync(descriptor, bytes, offset, bytes.length - offset, null);\n    if (written <= 0) throw new Error(\"Progress log append made no progress\");\n    offset += written;\n  }\n}\n"]}

package/dist/esm/project-run/progress-rendering/renderer-formatting.mjs

@@ -1,9 +1,13 @@
+import { types } from "node:util";
+import { canonicalJsonText } from "../../data-boundary/canonical-data.mjs";
+import { FLAG_CONDITION_NOT_MATCHED_CODE } from "../check-execution/flag-controls.mjs";
 const COLOR = Object.freeze({
     error: "\u001B[31m",
     info: "\u001B[36m",
     reset: "\u001B[0m",
     warning: "\u001B[33m"
 });
+const TRUNCATION_MARKER = "… [truncated]";
 const NAMED_CONTROL_ESCAPES = Object.freeze({
     "\n": "\\n",
     "\r": "\\r",
@@ -16,7 +20,23 @@ export function formatRunningRow(input) {
 export function shouldPresentSettledFeedback(feedback) {
     return (feedback.visibility !== "attention" ||
         feedback.outcome.status !== "passed" ||
-        feedback.messages.length > 0);
+        feedback.messages.length > 0 ||
+        feedback.records.length > 0);
+}
+export function isFlagConditionNotMatchedFeedback(feedback) {
+    return (feedback.durationMs === null &&
+        feedback.messages.length === 0 &&
+        feedback.records.length === 0 &&
+        feedback.outcome.status === "not-applicable" &&
+        feedback.outcome.reason?.code === FLAG_CONDITION_NOT_MATCHED_CODE);
+}
+export function formatFlagConditionNotMatchedBlock(displayNames) {
+    const subject = displayNames.length === 1
+        ? "The following check did not run because the run flags did not match its condition:"
+        : `The following ${displayNames.length} checks did not run because the run flags did not match their conditions:`;
+    return `  ${subject}\n${displayNames
+        .map((displayName) => `    - ${escapeTerminalText(displayName)}\n`)
+        .join("")}`;
 }
 export function formatSettledBlock(input) {
     const status = statusForOutcome(input.outcome);
@@ -24,7 +44,9 @@ export function formatSettledBlock(input) {
     const duration = input.durationMs === null ? "not run" : formatDuration(input.durationMs);
     const reasonSuffix = reason === undefined ? "" : ` | ${escapeTerminalText(reason)}`;
     const row = `  [${input.completionOrdinal}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | ${status} | ${duration}${reasonSuffix}\n`;
-    return `${row}${input.messages.map((message) => formatMessage(message, input.usesColor)).join("")}`;
+    const recordPreview = formatRecords(input.records, input.progressRendering);
+    const messagePreview = formatMessages(input.messages, input.usesColor, input.progressRendering);
+    return `${row}${recordPreview}${messagePreview}`;
 }
 export function formatFinalSummary(input) {
     return [
@@ -40,28 +62,59 @@ export function formatFinalSummary(input) {
         ""
     ].join("\n");
 }
-function formatMessage(message, usesColor) {
+function formatRecords(records, progressRendering) {
+    return formatPreview(records, (record) => formatRecord(record, progressRendering), "record", progressRendering.recordPreviewLimit);
+}
+function formatMessages(messages, usesColor, progressRendering) {
+    return formatPreview(messages, (message) => formatMessage(message, usesColor, progressRendering), "message", progressRendering.messagePreviewLimit);
+}
+function formatPreview(items, formatItem, previewKind, limit) {
+    const preview = items.slice(0, limit);
+    const omittedCount = items.length - preview.length;
+    let renderedPreview = "";
+    // Caller formatters run once in selection order; a throw stops the current block.
+    for (const item of preview)
+        renderedPreview += formatItem(item);
+    if (omittedCount === 0)
+        return renderedPreview;
+    return `${renderedPreview}    [${previewKind}s] ${omittedCount} additional ${previewKind}(s) were omitted from terminal preview.\n`;
+}
+function formatRecord(record, progressRendering) {
+    const defaultText = `${record.id} | ${canonicalJsonText(record.data)}`;
+    const formattedText = formattedPreviewText("record", defaultText, progressRendering);
+    const previewText = boundedTerminalText(formattedText, progressRendering.textPreviewCodePointLimit);
+    return `    [record] ${previewText}\n`;
+}
+function formatMessage(message, usesColor, progressRendering) {
     const label = colorMessageLevel(message.level, usesColor);
-    return `    [${label}] ${escapeTerminalText(message.message)}\n`;
+    const formattedText = formattedPreviewText("message", message.message, progressRendering);
+    const previewText = boundedTerminalText(formattedText, progressRendering.textPreviewCodePointLimit);
+    return `    [${label}] ${previewText}\n`;
 }
-function totalChecks(counts) {
-    return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;
+function formattedPreviewText(kind, text, progressRendering) {
+    const formatter = progressRendering.formatter;
+    if (formatter === null)
+        return text;
+    const formatted = formatter(Object.freeze({ kind, maxCodePoints: progressRendering.textPreviewCodePointLimit, text }));
+    if (typeof formatted === "string")
+        return formatted;
+    observeRejectedPromise(formatted);
+    throw new TypeError("Progress preview formatter must synchronously return a string");
 }
-function statusForOutcome(outcome) {
-    switch (outcome.status) {
-        case "passed":
-        case "failed":
-            return outcome.status;
-        case "not-applicable":
-            return "not-applicable";
-        case "unavailable":
-            return "unavailable";
+function observeRejectedPromise(value) {
+    if (types.isPromise(value)) {
+        // The intrinsic call observes a real Promise without reading a caller-controlled `.then`.
+        // eslint-disable-next-line typescript/no-floating-promises -- rendering must not await formatter misuse.
+        void Promise.prototype.then.call(value, undefined, () => undefined);
     }
 }
-function reasonForOutcome(outcome) {
-    return outcome.status === "passed" || outcome.status === "failed"
-        ? undefined
-        : outcome.reason?.code;
+function boundedTerminalText(value, maximumCodePoints) {
+    const escaped = escapeTerminalText(value);
+    if (codePointLength(escaped) <= maximumCodePoints)
+        return escaped;
+    const marker = prefixByCodePoints(TRUNCATION_MARKER, maximumCodePoints);
+    const textBudget = maximumCodePoints - codePointLength(marker);
+    return `${prefixByCodePoints(escaped, textBudget)}${marker}`;
 }
 /** Human-only fields must not control the terminal that presents them. */
 function escapeTerminalText(value) {
@@ -79,6 +132,23 @@ function escapeTerminalText(value) {
     }
     return escaped;
 }
+function codePointLength(value) {
+    let length = 0;
+    for (const _character of value)
+        length += 1;
+    return length;
+}
+function prefixByCodePoints(value, limit) {
+    let prefix = "";
+    let length = 0;
+    for (const character of value) {
+        if (length === limit)
+            break;
+        prefix += character;
+        length += 1;
+    }
+    return prefix;
+}
 function isTerminalControl(codePoint) {
     return (codePoint <= 0x1f ||
         (codePoint >= 0x7f && codePoint <= 0x9f) ||
@@ -90,6 +160,25 @@ function colorMessageLevel(level, usesColor) {
         return level;
     return `${COLOR[level]}${level}${COLOR.reset}`;
 }
+function statusForOutcome(outcome) {
+    switch (outcome.status) {
+        case "passed":
+        case "failed":
+            return outcome.status;
+        case "not-applicable":
+            return "not-applicable";
+        case "unavailable":
+            return "unavailable";
+    }
+}
+function reasonForOutcome(outcome) {
+    return outcome.status === "passed" || outcome.status === "failed"
+        ? undefined
+        : outcome.reason?.code;
+}
+function totalChecks(counts) {
+    return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;
+}
 function formatDuration(durationMs) {
     if (durationMs < 1_000) {
         return `${Number.isInteger(durationMs) ? durationMs : Number(durationMs.toFixed(1))}ms`;

package/dist/esm/project-run/progress-rendering/renderer-formatting.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-formatting.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-formatting.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckOutcome } from \"../../check/check.ts\";\nimport type { ProgressFeedback, ProgressOutcomeCounts } from \"./renderer.ts\";\n\nconst COLOR = Object.freeze({\n  error: \"\\u001B[31m\",\n  info: \"\\u001B[36m\",\n  reset: \"\\u001B[0m\",\n  warning: \"\\u001B[33m\"\n});\n\nconst NAMED_CONTROL_ESCAPES: Readonly<Partial<Record<string, string>>> = Object.freeze({\n  \"\\n\": \"\\\\n\",\n  \"\\r\": \"\\\\r\",\n  \"\\t\": \"\\\\t\"\n});\n\nexport function formatRunningRow(\n  input: Readonly<{\n    readonly displayIndex: number;\n    readonly displayName: string;\n    readonly elapsedMs: number | null;\n    readonly totalChecks: number;\n  }>\n): string {\n  const elapsed = input.elapsedMs === null ? \"\" : ` | ${formatDuration(input.elapsedMs)}`;\n  return `  [${input.displayIndex}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | running${elapsed}\\n`;\n}\n\nexport function shouldPresentSettledFeedback(\n  feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>\n): boolean {\n  return (\n    feedback.visibility !== \"attention\" ||\n    feedback.outcome.status !== \"passed\" ||\n    feedback.messages.length > 0\n  );\n}\n\nexport function formatSettledBlock(\n  input: Readonly<{\n    readonly completionOrdinal: number;\n    readonly displayName: string;\n    readonly durationMs: number | null;\n    readonly messages: readonly CheckMessage[];\n    readonly outcome: CheckOutcome;\n    readonly totalChecks: number;\n    readonly usesColor: boolean;\n  }>\n): string {\n  const status = statusForOutcome(input.outcome);\n  const reason = reasonForOutcome(input.outcome);\n  const duration = input.durationMs === null ? \"not run\" : formatDuration(input.durationMs);\n  const reasonSuffix = reason === undefined ? \"\" : ` | ${escapeTerminalText(reason)}`;\n  const row = `  [${input.completionOrdinal}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | ${status} | ${duration}${reasonSuffix}\\n`;\n  return `${row}${input.messages.map((message) => formatMessage(message, input.usesColor)).join(\"\")}`;\n}\n\nexport function formatFinalSummary(\n  input: Extract<ProgressFeedback, { readonly kind: \"final\" }>\n): string {\n  return [\n    \"\",\n    \"Execution summary:\",\n    `  execution: ${input.execution}`,\n    `  total checks: ${totalChecks(input.counts)}`,\n    `  passed: ${input.counts.passed}`,\n    `  failed: ${input.counts.failed}`,\n    `  not applicable: ${input.counts.notApplicable}`,\n    `  unavailable: ${input.counts.unavailable}`,\n    `  elapsed: ${formatDuration(input.elapsedMs)}`,\n    \"\"\n  ].join(\"\\n\");\n}\n\nfunction formatMessage(message: CheckMessage, usesColor: boolean): string {\n  const label = colorMessageLevel(message.level, usesColor);\n  return `    [${label}] ${escapeTerminalText(message.message)}\\n`;\n}\n\nfunction totalChecks(counts: ProgressOutcomeCounts): number {\n  return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;\n}\n\nfunction statusForOutcome(outcome: CheckOutcome): ProgressStatus {\n  switch (outcome.status) {\n    case \"passed\":\n    case \"failed\":\n      return outcome.status;\n    case \"not-applicable\":\n      return \"not-applicable\";\n    case \"unavailable\":\n      return \"unavailable\";\n  }\n}\n\nfunction reasonForOutcome(outcome: CheckOutcome): string | undefined {\n  return outcome.status === \"passed\" || outcome.status === \"failed\"\n    ? undefined\n    : outcome.reason?.code;\n}\n\n/** Human-only fields must not control the terminal that presents them. */\nfunction escapeTerminalText(value: string): string {\n  let escaped = \"\";\n  for (const character of value) {\n    const codePoint = character.codePointAt(0) ?? 0;\n    const namedEscape = NAMED_CONTROL_ESCAPES[character];\n    if (namedEscape !== undefined) {\n      escaped += namedEscape;\n      continue;\n    }\n    escaped += isTerminalControl(codePoint)\n      ? `\\\\u${codePoint.toString(16).padStart(4, \"0\").toUpperCase()}`\n      : character;\n  }\n  return escaped;\n}\n\nfunction isTerminalControl(codePoint: number): boolean {\n  return (\n    codePoint <= 0x1f ||\n    (codePoint >= 0x7f && codePoint <= 0x9f) ||\n    codePoint === 0x2028 ||\n    codePoint === 0x2029\n  );\n}\n\nfunction colorMessageLevel(level: CheckMessage[\"level\"], usesColor: boolean): string {\n  if (!usesColor) return level;\n  return `${COLOR[level]}${level}${COLOR.reset}`;\n}\n\ntype ProgressStatus = CheckOutcome[\"status\"];\n\nfunction formatDuration(durationMs: number): string {\n  if (durationMs < 1_000) {\n    return `${Number.isInteger(durationMs) ? durationMs : Number(durationMs.toFixed(1))}ms`;\n  }\n  const seconds = durationMs / 1_000;\n  return `${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(1))}s`;\n}\n"]}
+{"version":3,"file":"renderer-formatting.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-formatting.ts"],"names":[],"mappings":"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","sourcesContent":["import { types } from \"node:util\";\n\nimport type { CheckMessage, CheckOutcome } from \"../../check/check.ts\";\nimport type { CoreRecord } from \"../../check-settlement/facts.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport { FLAG_CONDITION_NOT_MATCHED_CODE } from \"../check-execution/flag-controls.ts\";\nimport type { ProgressFeedback, ProgressOutcomeCounts } from \"./renderer.ts\";\n\nconst COLOR = Object.freeze({\n  error: \"\\u001B[31m\",\n  info: \"\\u001B[36m\",\n  reset: \"\\u001B[0m\",\n  warning: \"\\u001B[33m\"\n});\n\nconst TRUNCATION_MARKER = \"… [truncated]\";\n\nconst NAMED_CONTROL_ESCAPES: Readonly<Partial<Record<string, string>>> = Object.freeze({\n  \"\\n\": \"\\\\n\",\n  \"\\r\": \"\\\\r\",\n  \"\\t\": \"\\\\t\"\n});\n\nexport function formatRunningRow(\n  input: Readonly<{\n    readonly displayIndex: number;\n    readonly displayName: string;\n    readonly elapsedMs: number | null;\n    readonly totalChecks: number;\n  }>\n): string {\n  const elapsed = input.elapsedMs === null ? \"\" : ` | ${formatDuration(input.elapsedMs)}`;\n  return `  [${input.displayIndex}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | running${elapsed}\\n`;\n}\n\nexport function shouldPresentSettledFeedback(\n  feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>\n): boolean {\n  return (\n    feedback.visibility !== \"attention\" ||\n    feedback.outcome.status !== \"passed\" ||\n    feedback.messages.length > 0 ||\n    feedback.records.length > 0\n  );\n}\n\nexport function isFlagConditionNotMatchedFeedback(\n  feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>\n): boolean {\n  return (\n    feedback.durationMs === null &&\n    feedback.messages.length === 0 &&\n    feedback.records.length === 0 &&\n    feedback.outcome.status === \"not-applicable\" &&\n    feedback.outcome.reason?.code === FLAG_CONDITION_NOT_MATCHED_CODE\n  );\n}\n\nexport function formatFlagConditionNotMatchedBlock(\n  displayNames: readonly [string, ...string[]]\n): string {\n  const subject =\n    displayNames.length === 1\n      ? \"The following check did not run because the run flags did not match its condition:\"\n      : `The following ${displayNames.length} checks did not run because the run flags did not match their conditions:`;\n  return `  ${subject}\\n${displayNames\n    .map((displayName) => `    - ${escapeTerminalText(displayName)}\\n`)\n    .join(\"\")}`;\n}\n\nexport function formatSettledBlock(\n  input: Readonly<{\n    readonly completionOrdinal: number;\n    readonly displayName: string;\n    readonly durationMs: number | null;\n    readonly messages: readonly CheckMessage[];\n    readonly outcome: CheckOutcome;\n    readonly records: readonly CoreRecord[];\n    readonly totalChecks: number;\n    readonly usesColor: boolean;\n    readonly progressRendering: ResolvedProgressRenderingOutput;\n  }>\n): string {\n  const status = statusForOutcome(input.outcome);\n  const reason = reasonForOutcome(input.outcome);\n  const duration = input.durationMs === null ? \"not run\" : formatDuration(input.durationMs);\n  const reasonSuffix = reason === undefined ? \"\" : ` | ${escapeTerminalText(reason)}`;\n  const row = `  [${input.completionOrdinal}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | ${status} | ${duration}${reasonSuffix}\\n`;\n  const recordPreview = formatRecords(input.records, input.progressRendering);\n  const messagePreview = formatMessages(input.messages, input.usesColor, input.progressRendering);\n  return `${row}${recordPreview}${messagePreview}`;\n}\n\nexport function formatFinalSummary(\n  input: Extract<ProgressFeedback, { readonly kind: \"final\" }>\n): string {\n  return [\n    \"\",\n    \"Execution summary:\",\n    `  execution: ${input.execution}`,\n    `  total checks: ${totalChecks(input.counts)}`,\n    `  passed: ${input.counts.passed}`,\n    `  failed: ${input.counts.failed}`,\n    `  not applicable: ${input.counts.notApplicable}`,\n    `  unavailable: ${input.counts.unavailable}`,\n    `  elapsed: ${formatDuration(input.elapsedMs)}`,\n    \"\"\n  ].join(\"\\n\");\n}\n\nfunction formatRecords(\n  records: readonly CoreRecord[],\n  progressRendering: ResolvedProgressRenderingOutput\n): string {\n  return formatPreview(\n    records,\n    (record) => formatRecord(record, progressRendering),\n    \"record\",\n    progressRendering.recordPreviewLimit\n  );\n}\n\nfunction formatMessages(\n  messages: readonly CheckMessage[],\n  usesColor: boolean,\n  progressRendering: ResolvedProgressRenderingOutput\n): string {\n  return formatPreview(\n    messages,\n    (message) => formatMessage(message, usesColor, progressRendering),\n    \"message\",\n    progressRendering.messagePreviewLimit\n  );\n}\n\nfunction formatPreview<Item>(\n  items: readonly Item[],\n  formatItem: (item: Item) => string,\n  previewKind: \"message\" | \"record\",\n  limit: number\n): string {\n  const preview = items.slice(0, limit);\n  const omittedCount = items.length - preview.length;\n  let renderedPreview = \"\";\n  // Caller formatters run once in selection order; a throw stops the current block.\n  for (const item of preview) renderedPreview += formatItem(item);\n  if (omittedCount === 0) return renderedPreview;\n  return `${renderedPreview}    [${previewKind}s] ${omittedCount} additional ${previewKind}(s) were omitted from terminal preview.\\n`;\n}\n\nfunction formatRecord(\n  record: CoreRecord,\n  progressRendering: ResolvedProgressRenderingOutput\n): string {\n  const defaultText = `${record.id} | ${canonicalJsonText(record.data)}`;\n  const formattedText = formattedPreviewText(\"record\", defaultText, progressRendering);\n  const previewText = boundedTerminalText(\n    formattedText,\n    progressRendering.textPreviewCodePointLimit\n  );\n  return `    [record] ${previewText}\\n`;\n}\n\nfunction formatMessage(\n  message: CheckMessage,\n  usesColor: boolean,\n  progressRendering: ResolvedProgressRenderingOutput\n): string {\n  const label = colorMessageLevel(message.level, usesColor);\n  const formattedText = formattedPreviewText(\"message\", message.message, progressRendering);\n  const previewText = boundedTerminalText(\n    formattedText,\n    progressRendering.textPreviewCodePointLimit\n  );\n  return `    [${label}] ${previewText}\\n`;\n}\n\nfunction formattedPreviewText(\n  kind: \"record\" | \"message\",\n  text: string,\n  progressRendering: ResolvedProgressRenderingOutput\n): string {\n  const formatter = progressRendering.formatter;\n  if (formatter === null) return text;\n  const formatted: unknown = formatter(\n    Object.freeze({ kind, maxCodePoints: progressRendering.textPreviewCodePointLimit, text })\n  );\n  if (typeof formatted === \"string\") return formatted;\n  observeRejectedPromise(formatted);\n  throw new TypeError(\"Progress preview formatter must synchronously return a string\");\n}\n\nfunction observeRejectedPromise(value: unknown): void {\n  if (types.isPromise(value)) {\n    // The intrinsic call observes a real Promise without reading a caller-controlled `.then`.\n    // eslint-disable-next-line typescript/no-floating-promises -- rendering must not await formatter misuse.\n    void Promise.prototype.then.call(value, undefined, () => undefined);\n  }\n}\n\nfunction boundedTerminalText(value: string, maximumCodePoints: number): string {\n  const escaped = escapeTerminalText(value);\n  if (codePointLength(escaped) <= maximumCodePoints) return escaped;\n  const marker = prefixByCodePoints(TRUNCATION_MARKER, maximumCodePoints);\n  const textBudget = maximumCodePoints - codePointLength(marker);\n  return `${prefixByCodePoints(escaped, textBudget)}${marker}`;\n}\n\n/** Human-only fields must not control the terminal that presents them. */\nfunction escapeTerminalText(value: string): string {\n  let escaped = \"\";\n  for (const character of value) {\n    const codePoint = character.codePointAt(0) ?? 0;\n    const namedEscape = NAMED_CONTROL_ESCAPES[character];\n    if (namedEscape !== undefined) {\n      escaped += namedEscape;\n      continue;\n    }\n    escaped += isTerminalControl(codePoint)\n      ? `\\\\u${codePoint.toString(16).padStart(4, \"0\").toUpperCase()}`\n      : character;\n  }\n  return escaped;\n}\n\nfunction codePointLength(value: string): number {\n  let length = 0;\n  for (const _character of value) length += 1;\n  return length;\n}\n\nfunction prefixByCodePoints(value: string, limit: number): string {\n  let prefix = \"\";\n  let length = 0;\n  for (const character of value) {\n    if (length === limit) break;\n    prefix += character;\n    length += 1;\n  }\n  return prefix;\n}\n\nfunction isTerminalControl(codePoint: number): boolean {\n  return (\n    codePoint <= 0x1f ||\n    (codePoint >= 0x7f && codePoint <= 0x9f) ||\n    codePoint === 0x2028 ||\n    codePoint === 0x2029\n  );\n}\n\nfunction colorMessageLevel(level: CheckMessage[\"level\"], usesColor: boolean): string {\n  if (!usesColor) return level;\n  return `${COLOR[level]}${level}${COLOR.reset}`;\n}\n\ntype ProgressStatus = CheckOutcome[\"status\"];\n\nfunction statusForOutcome(outcome: CheckOutcome): ProgressStatus {\n  switch (outcome.status) {\n    case \"passed\":\n    case \"failed\":\n      return outcome.status;\n    case \"not-applicable\":\n      return \"not-applicable\";\n    case \"unavailable\":\n      return \"unavailable\";\n  }\n}\n\nfunction reasonForOutcome(outcome: CheckOutcome): string | undefined {\n  return outcome.status === \"passed\" || outcome.status === \"failed\"\n    ? undefined\n    : outcome.reason?.code;\n}\n\nfunction totalChecks(counts: ProgressOutcomeCounts): number {\n  return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;\n}\n\nfunction formatDuration(durationMs: number): string {\n  if (durationMs < 1_000) {\n    return `${Number.isInteger(durationMs) ? durationMs : Number(durationMs.toFixed(1))}ms`;\n  }\n  const seconds = durationMs / 1_000;\n  return `${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(1))}s`;\n}\n"]}