@zxyycom/vibe-check 0.0.2 → 0.0.3

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

@@ -6,7 +6,11 @@ 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 terminal progress and its optional file tee; terminal output survives a file-only failure. */
@@ -48,7 +52,9 @@ export function createProgressRendering(configuration, statuses, dependencies =
             return renderer;
         writer = createProgressTee({
             file: dependencies.file ?? null,
-            onFileFailure: () => statuses.failed("progressRendering"),
+            onFileFailure: () => {
+                statuses.failed("progressRendering");
+            },
             terminal: (dependencies.writerFactory ?? defaultProgressWriter)()
         });
         renderer = createProgressRenderer(writer, dependencies.clock, configuration);
@@ -107,9 +113,15 @@ export function createProgressRendering(configuration, statuses, dependencies =
     };
     return Object.freeze({
         close,
-        prepared: (totalChecks) => render(Object.freeze({ kind: "prepared", totalChecks })),
-        lifecycle: Object.freeze({
-            flagControlCompleted: () => render(Object.freeze({ kind: "flag-control-completed" })),
+        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",
@@ -119,7 +131,7 @@ export function createProgressRendering(configuration, statuses, dependencies =
                     messages: fact.messages,
                     outcome: fact.outcome,
                     records: fact.records,
-                    visibility: fact.visibility
+                    omitQuietPassedRow: fact.omitQuietPassedRow
                 }));
                 runningCheckIds.delete(fact.checkId);
                 if (runningCheckIds.size === 0)
@@ -127,7 +139,12 @@ 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();
             }
         }),
@@ -144,15 +161,18 @@ export function createProgressRendering(configuration, statuses, dependencies =
     });
 }
 function inertProgressRendering() {
-    const lifecycle = Object.freeze({
-        flagControlCompleted: () => undefined,
+    const invocationLifecycle = Object.freeze({
+        selectionSettled: () => undefined
+    });
+    const checkLifecycle = Object.freeze({
         settled: (_fact) => undefined,
         started: (_fact) => undefined
     });
     return Object.freeze({
         close: () => undefined,
-        prepared: (_totalChecks) => undefined,
-        lifecycle,
+        prepared: (_totalChecks, _quietPassOmissionConfiguredCount) => undefined,
+        checkLifecycle,
+        invocationLifecycle,
         final: (_input) => undefined
     });
 }

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 { 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"]}
+{"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  InvocationLifecycle,\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 checkLifecycle: CheckExecutionLifecycle;\n  readonly invocationLifecycle: InvocationLifecycle;\n  readonly prepared: (totalChecks: number, quietPassOmissionConfiguredCount: 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({\n      cancel: () => {\n        clearInterval(interval);\n      }\n    });\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: () => {\n        statuses.failed(\"progressRendering\");\n      },\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, quietPassOmissionConfiguredCount: number) => {\n      render(Object.freeze({ kind: \"prepared\", quietPassOmissionConfiguredCount, totalChecks }));\n    },\n    invocationLifecycle: Object.freeze({\n      selectionSettled: () => {\n        render(Object.freeze({ kind: \"flag-control-completed\" }));\n      }\n    }),\n    checkLifecycle: 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            records: fact.records,\n            omitQuietPassedRow: fact.omitQuietPassedRow\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({\n            kind: \"started\",\n            checkId: fact.checkId,\n            displayName: fact.displayName,\n            omitQuietPassedRow: fact.omitQuietPassedRow\n          })\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 invocationLifecycle = Object.freeze({\n    selectionSettled: (): void => undefined\n  });\n  const checkLifecycle = Object.freeze({\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, _quietPassOmissionConfiguredCount: number): void => undefined,\n    checkLifecycle,\n    invocationLifecycle,\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

@@ -15,10 +15,11 @@ const NAMED_CONTROL_ESCAPES = Object.freeze({
 });
 export function formatRunningRow(input) {
     const elapsed = input.elapsedMs === null ? "" : ` | ${formatDuration(input.elapsedMs)}`;
-    return `  [${input.displayIndex}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | running${elapsed}\n`;
+    const ordinal = input.displayIndex === undefined ? "·" : `[${input.displayIndex}/${input.totalChecks}]`;
+    return `  ${ordinal} ${escapeTerminalText(input.displayName)} | running${elapsed}\n`;
 }
 export function shouldPresentSettledFeedback(feedback) {
-    return (feedback.visibility !== "attention" ||
+    return (!feedback.omitQuietPassedRow ||
         feedback.outcome.status !== "passed" ||
         feedback.messages.length > 0 ||
         feedback.records.length > 0);
@@ -43,7 +44,10 @@ export function formatSettledBlock(input) {
     const reason = reasonForOutcome(input.outcome);
     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`;
+    const ordinal = input.completionOrdinal === undefined
+        ? "·"
+        : `[${input.completionOrdinal}/${input.totalChecks}]`;
+    const row = `  ${ordinal} ${escapeTerminalText(input.displayName)} | ${status} | ${duration}${reasonSuffix}\n`;
     const recordPreview = formatRecords(input.records, input.progressRendering);
     const messagePreview = formatMessages(input.messages, input.usesColor, input.progressRendering);
     return `${row}${recordPreview}${messagePreview}`;
@@ -58,6 +62,9 @@ export function formatFinalSummary(input) {
         `  failed: ${input.counts.failed}`,
         `  not applicable: ${input.counts.notApplicable}`,
         `  unavailable: ${input.counts.unavailable}`,
+        ...(input.quietPassOmissionConfiguredCount === 0
+            ? []
+            : [`  quiet-pass rows omitted: ${input.quietPassOmittedCount}`]),
         `  elapsed: ${formatDuration(input.elapsedMs)}`,
         ""
     ].join("\n");
@@ -104,7 +111,7 @@ function formattedPreviewText(kind, text, progressRendering) {
 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.
+        // oxlint-disable-next-line typescript/no-floating-promises -- rendering must not await formatter misuse.
         void Promise.prototype.then.call(value, undefined, () => undefined);
     }
 }

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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAKlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AAGtF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAE1C,MAAM,qBAAqB,GAA8C,MAAM,CAAC,MAAM,CAAC;IACrF,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;CACZ,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAC9B,KAKE;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;IACxF,OAAO,MAAM,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,WAAW,KAAK,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,OAAO,IAAI,CAAC;AACzH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAiE;IAEjE,OAAO,CACL,QAAQ,CAAC,UAAU,KAAK,WAAW;QACnC,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ;QACpC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAAiE;IAEjE,OAAO,CACL,QAAQ,CAAC,UAAU,KAAK,IAAI;QAC5B,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC7B,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,gBAAgB;QAC5C,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,+BAA+B,CAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,YAA4C;IAE5C,MAAM,OAAO,GACX,YAAY,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,oFAAoF;QACtF,CAAC,CAAC,iBAAiB,YAAY,CAAC,MAAM,2EAA2E,CAAC;IACtH,OAAO,KAAK,OAAO,KAAK,YAAY;SACjC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,SAAS,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC;SAClE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAUE;IAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,WAAW,KAAK,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,MAAM,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC;IACtJ,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChG,OAAO,GAAG,GAAG,GAAG,aAAa,GAAG,cAAc,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAA4D;IAE5D,OAAO;QACL,EAAE;QACF,oBAAoB;QACpB,gBAAgB,KAAK,CAAC,SAAS,EAAE;QACjC,mBAAmB,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QAC9C,aAAa,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QAClC,aAAa,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QAClC,qBAAqB,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE;QACjD,kBAAkB,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE;QAC5C,cAAc,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QAC/C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,OAA8B,EAC9B,iBAAkD;IAElD,OAAO,aAAa,CAClB,OAAO,EACP,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACnD,QAAQ,EACR,iBAAiB,CAAC,kBAAkB,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,QAAiC,EACjC,SAAkB,EAClB,iBAAkD;IAElD,OAAO,aAAa,CAClB,QAAQ,EACR,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,EACjE,SAAS,EACT,iBAAiB,CAAC,mBAAmB,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,KAAsB,EACtB,UAAkC,EAClC,WAAiC,EACjC,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnD,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,kFAAkF;IAClF,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,eAAe,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,YAAY,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IAC/C,OAAO,GAAG,eAAe,QAAQ,WAAW,MAAM,YAAY,eAAe,WAAW,2CAA2C,CAAC;AACtI,CAAC;AAED,SAAS,YAAY,CACnB,MAAkB,EAClB,iBAAkD;IAElD,MAAM,WAAW,GAAG,GAAG,MAAM,CAAC,EAAE,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACvE,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACrF,MAAM,WAAW,GAAG,mBAAmB,CACrC,aAAa,EACb,iBAAiB,CAAC,yBAAyB,CAC5C,CAAC;IACF,OAAO,gBAAgB,WAAW,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CACpB,OAAqB,EACrB,SAAkB,EAClB,iBAAkD;IAElD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC1F,MAAM,WAAW,GAAG,mBAAmB,CACrC,aAAa,EACb,iBAAiB,CAAC,yBAAyB,CAC5C,CAAC;IACF,OAAO,QAAQ,KAAK,KAAK,WAAW,IAAI,CAAC;AAC3C,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAA0B,EAC1B,IAAY,EACZ,iBAAkD;IAElD,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC9C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,SAAS,GAAY,SAAS,CAClC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,iBAAiB,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC,CAC1F,CAAC;IACF,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpD,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,0FAA0F;QAC1F,yGAAyG;QACzG,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,iBAAyB;IACnE,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,iBAAiB;QAAE,OAAO,OAAO,CAAC;IAClE,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,iBAAiB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED,0EAA0E;AAC1E,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,IAAI,WAAW,CAAC;YACvB,SAAS;QACX,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC;YACrC,CAAC,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;YAC/D,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,UAAU,IAAI,KAAK;QAAE,MAAM,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,KAAK;YAAE,MAAM;QAC5B,MAAM,IAAI,SAAS,CAAC;QACpB,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,CACL,SAAS,IAAI,IAAI;QACjB,CAAC,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC;QACxC,SAAS,KAAK,MAAM;QACpB,SAAS,KAAK,MAAM,CACrB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA4B,EAAE,SAAkB;IACzE,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAID,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,KAAK,gBAAgB;YACnB,OAAO,gBAAgB,CAAC;QAC1B,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAC/D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,MAA6B;IAChD,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC;AACnF,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACxC,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;QACvB,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;IACnC,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAChF,CAAC","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"]}
+{"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 | undefined;\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  const ordinal =\n    input.displayIndex === undefined ? \"·\" : `[${input.displayIndex}/${input.totalChecks}]`;\n  return `  ${ordinal} ${escapeTerminalText(input.displayName)} | running${elapsed}\\n`;\n}\n\nexport function shouldPresentSettledFeedback(\n  feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>\n): boolean {\n  return (\n    !feedback.omitQuietPassedRow ||\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 | undefined;\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 ordinal =\n    input.completionOrdinal === undefined\n      ? \"·\"\n      : `[${input.completionOrdinal}/${input.totalChecks}]`;\n  const row = `  ${ordinal} ${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    Readonly<{\n      readonly quietPassOmissionConfiguredCount: number;\n      readonly quietPassOmittedCount: number;\n    }>\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    ...(input.quietPassOmissionConfiguredCount === 0\n      ? []\n      : [`  quiet-pass rows omitted: ${input.quietPassOmittedCount}`]),\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    // oxlint-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"]}

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

@@ -6,6 +6,8 @@ export class ProgressRendererController {
     writer;
     completedCount = 0;
     flagConditionNotMatchedDisplayNames = [];
+    quietPassOmissionConfiguredCount = 0;
+    quietPassOmittedCount = 0;
     preparedTotal;
     renderedRunningRows = 0;
     running = [];
@@ -29,7 +31,7 @@ export class ProgressRendererController {
     render(feedback) {
         switch (feedback.kind) {
             case "prepared":
-                this.prepare(feedback.totalChecks);
+                this.prepare(feedback.totalChecks, feedback.quietPassOmissionConfiguredCount);
                 return;
             case "flag-control-completed":
                 this.completeFlagControl();
@@ -44,11 +46,15 @@ export class ProgressRendererController {
                 this.finish(feedback);
         }
     }
-    prepare(totalChecks) {
+    prepare(totalChecks, quietPassOmissionConfiguredCount) {
         if (this.preparedTotal !== undefined)
             throw new Error("Progress feedback was prepared twice");
         this.preparedTotal = totalChecks;
-        this.writer.write(`Vibe Check\ntotal ${totalChecks} checks\n\nChecks:\n`);
+        this.quietPassOmissionConfiguredCount = quietPassOmissionConfiguredCount;
+        const configuredSuffix = quietPassOmissionConfiguredCount === 0
+            ? ""
+            : ` · ${quietPassOmissionConfiguredCount} configured for quiet-pass omission`;
+        this.writer.write(`Vibe Check\ntotal ${totalChecks} checks${configuredSuffix}\n\nChecks:\n`);
     }
     start(feedback) {
         if (!this.refreshesRunningRegion)
@@ -58,6 +64,7 @@ export class ProgressRendererController {
         this.running.push({
             checkId: feedback.checkId,
             displayName: feedback.displayName,
+            omitQuietPassedRow: feedback.omitQuietPassedRow,
             elapsedMs: null,
             startedAtMs: this.clock.now()
         });
@@ -74,7 +81,7 @@ export class ProgressRendererController {
         }
         else if (shouldPresentSettledFeedback(feedback)) {
             this.writer.write(formatSettledBlock({
-                completionOrdinal: this.completedCount,
+                completionOrdinal: feedback.omitQuietPassedRow ? undefined : this.completedCount,
                 displayName: feedback.displayName,
                 durationMs: feedback.durationMs,
                 messages: feedback.messages,
@@ -85,6 +92,9 @@ export class ProgressRendererController {
                 progressRendering: this.progressRendering
             }));
         }
+        else {
+            this.quietPassOmittedCount += 1;
+        }
         if (this.refreshesRunningRegion)
             this.redrawRunningRegion();
     }
@@ -94,7 +104,11 @@ export class ProgressRendererController {
             throw new Error("Progress feedback finalized while Checks are still running");
         }
         this.flushFlagConditionNotMatchedChecks();
-        this.writer.write(formatFinalSummary(feedback));
+        this.writer.write(formatFinalSummary({
+            ...feedback,
+            quietPassOmissionConfiguredCount: this.quietPassOmissionConfiguredCount,
+            quietPassOmittedCount: this.quietPassOmittedCount
+        }));
     }
     completeFlagControl() {
         this.requirePrepared();
@@ -120,9 +134,9 @@ export class ProgressRendererController {
         const totalChecks = this.requirePrepared();
         for (const [index, check] of this.running.entries()) {
             this.writer.write(formatRunningRow({
-                displayIndex: this.completedCount + index + 1,
                 displayName: check.displayName,
                 elapsedMs: check.elapsedMs,
+                displayIndex: check.omitQuietPassedRow ? undefined : this.completedCount + index + 1,
                 totalChecks
             }));
         }

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

@@ -1 +1 @@
-{"version":3,"file":"renderer-lifecycle.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ProgressClock,\n  ProgressFeedback,\n  ProgressRenderer,\n  ProgressWriter\n} from \"./renderer.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport {\n  formatFlagConditionNotMatchedBlock,\n  formatFinalSummary,\n  formatRunningRow,\n  formatSettledBlock,\n  isFlagConditionNotMatchedFeedback,\n  shouldPresentSettledFeedback\n} from \"./renderer-formatting.ts\";\n\ninterface RunningCheck {\n  readonly checkId: string;\n  readonly displayName: string;\n  readonly startedAtMs: number;\n  elapsedMs: number | null;\n}\n\n/** Maintains the mutable lifecycle state and the TTY-only running terminal region. */\nexport class ProgressRendererController implements ProgressRenderer {\n  readonly refreshesRunningRegion: boolean;\n\n  private readonly clock: ProgressClock;\n  private readonly writer: ProgressWriter;\n  private completedCount = 0;\n  private readonly flagConditionNotMatchedDisplayNames: string[] = [];\n  private preparedTotal: number | undefined;\n  private renderedRunningRows = 0;\n  private readonly running: RunningCheck[] = [];\n  private readonly usesColor: boolean;\n  private readonly progressRendering: ResolvedProgressRenderingOutput;\n\n  constructor(\n    writer: ProgressWriter,\n    clock: ProgressClock,\n    progressRendering: ResolvedProgressRenderingOutput\n  ) {\n    this.writer = writer;\n    this.clock = clock;\n    this.progressRendering = progressRendering;\n    this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== \"dumb\";\n    this.usesColor = this.refreshesRunningRegion && writer.color;\n  }\n\n  refresh(): void {\n    if (!this.refreshesRunningRegion || this.running.length === 0) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.updateRunningDurations(this.clock.now());\n    this.redrawRunningRegion();\n  }\n\n  render(feedback: ProgressFeedback): void {\n    switch (feedback.kind) {\n      case \"prepared\":\n        this.prepare(feedback.totalChecks);\n        return;\n      case \"flag-control-completed\":\n        this.completeFlagControl();\n        return;\n      case \"started\":\n        this.start(feedback);\n        return;\n      case \"settled\":\n        this.settle(feedback);\n        return;\n      case \"final\":\n        this.finish(feedback);\n    }\n  }\n\n  private prepare(totalChecks: number): void {\n    if (this.preparedTotal !== undefined) throw new Error(\"Progress feedback was prepared twice\");\n    this.preparedTotal = totalChecks;\n    this.writer.write(`Vibe Check\\ntotal ${totalChecks} checks\\n\\nChecks:\\n`);\n  }\n\n  private start(feedback: Extract<ProgressFeedback, { readonly kind: \"started\" }>): void {\n    if (!this.refreshesRunningRegion) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.running.push({\n      checkId: feedback.checkId,\n      displayName: feedback.displayName,\n      elapsedMs: null,\n      startedAtMs: this.clock.now()\n    });\n    this.redrawRunningRegion();\n  }\n\n  private settle(feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>): void {\n    const totalChecks = this.requirePrepared();\n    if (this.refreshesRunningRegion) this.eraseRunningRegion();\n    this.completedCount += 1;\n    this.removeRunningCheck(feedback.checkId);\n    if (isFlagConditionNotMatchedFeedback(feedback)) {\n      this.flagConditionNotMatchedDisplayNames.push(feedback.displayName);\n    } else if (shouldPresentSettledFeedback(feedback)) {\n      this.writer.write(\n        formatSettledBlock({\n          completionOrdinal: this.completedCount,\n          displayName: feedback.displayName,\n          durationMs: feedback.durationMs,\n          messages: feedback.messages,\n          outcome: feedback.outcome,\n          records: feedback.records,\n          totalChecks,\n          usesColor: this.usesColor,\n          progressRendering: this.progressRendering\n        })\n      );\n    }\n    if (this.refreshesRunningRegion) this.redrawRunningRegion();\n  }\n\n  private finish(feedback: Extract<ProgressFeedback, { readonly kind: \"final\" }>): void {\n    this.requirePrepared();\n    if (this.running.length > 0) {\n      throw new Error(\"Progress feedback finalized while Checks are still running\");\n    }\n    this.flushFlagConditionNotMatchedChecks();\n    this.writer.write(formatFinalSummary(feedback));\n  }\n\n  private completeFlagControl(): void {\n    this.requirePrepared();\n    this.flushFlagConditionNotMatchedChecks();\n  }\n\n  private flushFlagConditionNotMatchedChecks(): void {\n    const firstDisplayName = this.flagConditionNotMatchedDisplayNames[0];\n    if (firstDisplayName === undefined) return;\n    this.writer.write(\n      formatFlagConditionNotMatchedBlock([\n        firstDisplayName,\n        ...this.flagConditionNotMatchedDisplayNames.slice(1)\n      ])\n    );\n    this.flagConditionNotMatchedDisplayNames.length = 0;\n  }\n\n  private eraseRunningRegion(): void {\n    for (let index = 0; index < this.renderedRunningRows; index += 1) {\n      this.writer.write(\"\\u001B[1A\\u001B[2K\");\n    }\n    this.renderedRunningRows = 0;\n  }\n\n  private redrawRunningRegion(): void {\n    const totalChecks = this.requirePrepared();\n    for (const [index, check] of this.running.entries()) {\n      this.writer.write(\n        formatRunningRow({\n          displayIndex: this.completedCount + index + 1,\n          displayName: check.displayName,\n          elapsedMs: check.elapsedMs,\n          totalChecks\n        })\n      );\n    }\n    this.renderedRunningRows = this.running.length;\n  }\n\n  private removeRunningCheck(checkId: string): void {\n    const index = this.running.findIndex((check) => check.checkId === checkId);\n    if (index >= 0) this.running.splice(index, 1);\n  }\n\n  private updateRunningDurations(refreshedAtMs: number): void {\n    for (const check of this.running) {\n      const elapsedMs = refreshedAtMs - check.startedAtMs;\n      check.elapsedMs = Number.isFinite(elapsedMs) && elapsedMs >= 0 ? elapsedMs : 0;\n    }\n  }\n\n  private requirePrepared(): number {\n    if (this.preparedTotal === undefined) {\n      throw new Error(\"Progress feedback arrived before preparation\");\n    }\n    return this.preparedTotal;\n  }\n}\n"]}
+{"version":3,"file":"renderer-lifecycle.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ProgressClock,\n  ProgressFeedback,\n  ProgressRenderer,\n  ProgressWriter\n} from \"./renderer.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport {\n  formatFlagConditionNotMatchedBlock,\n  formatFinalSummary,\n  formatRunningRow,\n  formatSettledBlock,\n  isFlagConditionNotMatchedFeedback,\n  shouldPresentSettledFeedback\n} from \"./renderer-formatting.ts\";\n\ninterface RunningCheck {\n  readonly checkId: string;\n  readonly displayName: string;\n  readonly omitQuietPassedRow: boolean;\n  readonly startedAtMs: number;\n  elapsedMs: number | null;\n}\n\n/** Maintains the mutable lifecycle state and the TTY-only running terminal region. */\nexport class ProgressRendererController implements ProgressRenderer {\n  readonly refreshesRunningRegion: boolean;\n\n  private readonly clock: ProgressClock;\n  private readonly writer: ProgressWriter;\n  private completedCount = 0;\n  private readonly flagConditionNotMatchedDisplayNames: string[] = [];\n  private quietPassOmissionConfiguredCount = 0;\n  private quietPassOmittedCount = 0;\n  private preparedTotal: number | undefined;\n  private renderedRunningRows = 0;\n  private readonly running: RunningCheck[] = [];\n  private readonly usesColor: boolean;\n  private readonly progressRendering: ResolvedProgressRenderingOutput;\n\n  constructor(\n    writer: ProgressWriter,\n    clock: ProgressClock,\n    progressRendering: ResolvedProgressRenderingOutput\n  ) {\n    this.writer = writer;\n    this.clock = clock;\n    this.progressRendering = progressRendering;\n    this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== \"dumb\";\n    this.usesColor = this.refreshesRunningRegion && writer.color;\n  }\n\n  refresh(): void {\n    if (!this.refreshesRunningRegion || this.running.length === 0) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.updateRunningDurations(this.clock.now());\n    this.redrawRunningRegion();\n  }\n\n  render(feedback: ProgressFeedback): void {\n    switch (feedback.kind) {\n      case \"prepared\":\n        this.prepare(feedback.totalChecks, feedback.quietPassOmissionConfiguredCount);\n        return;\n      case \"flag-control-completed\":\n        this.completeFlagControl();\n        return;\n      case \"started\":\n        this.start(feedback);\n        return;\n      case \"settled\":\n        this.settle(feedback);\n        return;\n      case \"final\":\n        this.finish(feedback);\n    }\n  }\n\n  private prepare(totalChecks: number, quietPassOmissionConfiguredCount: number): void {\n    if (this.preparedTotal !== undefined) throw new Error(\"Progress feedback was prepared twice\");\n    this.preparedTotal = totalChecks;\n    this.quietPassOmissionConfiguredCount = quietPassOmissionConfiguredCount;\n    const configuredSuffix =\n      quietPassOmissionConfiguredCount === 0\n        ? \"\"\n        : ` · ${quietPassOmissionConfiguredCount} configured for quiet-pass omission`;\n    this.writer.write(`Vibe Check\\ntotal ${totalChecks} checks${configuredSuffix}\\n\\nChecks:\\n`);\n  }\n\n  private start(feedback: Extract<ProgressFeedback, { readonly kind: \"started\" }>): void {\n    if (!this.refreshesRunningRegion) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.running.push({\n      checkId: feedback.checkId,\n      displayName: feedback.displayName,\n      omitQuietPassedRow: feedback.omitQuietPassedRow,\n      elapsedMs: null,\n      startedAtMs: this.clock.now()\n    });\n    this.redrawRunningRegion();\n  }\n\n  private settle(feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>): void {\n    const totalChecks = this.requirePrepared();\n    if (this.refreshesRunningRegion) this.eraseRunningRegion();\n    this.completedCount += 1;\n    this.removeRunningCheck(feedback.checkId);\n    if (isFlagConditionNotMatchedFeedback(feedback)) {\n      this.flagConditionNotMatchedDisplayNames.push(feedback.displayName);\n    } else if (shouldPresentSettledFeedback(feedback)) {\n      this.writer.write(\n        formatSettledBlock({\n          completionOrdinal: feedback.omitQuietPassedRow ? undefined : this.completedCount,\n          displayName: feedback.displayName,\n          durationMs: feedback.durationMs,\n          messages: feedback.messages,\n          outcome: feedback.outcome,\n          records: feedback.records,\n          totalChecks,\n          usesColor: this.usesColor,\n          progressRendering: this.progressRendering\n        })\n      );\n    } else {\n      this.quietPassOmittedCount += 1;\n    }\n    if (this.refreshesRunningRegion) this.redrawRunningRegion();\n  }\n\n  private finish(feedback: Extract<ProgressFeedback, { readonly kind: \"final\" }>): void {\n    this.requirePrepared();\n    if (this.running.length > 0) {\n      throw new Error(\"Progress feedback finalized while Checks are still running\");\n    }\n    this.flushFlagConditionNotMatchedChecks();\n    this.writer.write(\n      formatFinalSummary({\n        ...feedback,\n        quietPassOmissionConfiguredCount: this.quietPassOmissionConfiguredCount,\n        quietPassOmittedCount: this.quietPassOmittedCount\n      })\n    );\n  }\n\n  private completeFlagControl(): void {\n    this.requirePrepared();\n    this.flushFlagConditionNotMatchedChecks();\n  }\n\n  private flushFlagConditionNotMatchedChecks(): void {\n    const firstDisplayName = this.flagConditionNotMatchedDisplayNames[0];\n    if (firstDisplayName === undefined) return;\n    this.writer.write(\n      formatFlagConditionNotMatchedBlock([\n        firstDisplayName,\n        ...this.flagConditionNotMatchedDisplayNames.slice(1)\n      ])\n    );\n    this.flagConditionNotMatchedDisplayNames.length = 0;\n  }\n\n  private eraseRunningRegion(): void {\n    for (let index = 0; index < this.renderedRunningRows; index += 1) {\n      this.writer.write(\"\\u001B[1A\\u001B[2K\");\n    }\n    this.renderedRunningRows = 0;\n  }\n\n  private redrawRunningRegion(): void {\n    const totalChecks = this.requirePrepared();\n    for (const [index, check] of this.running.entries()) {\n      this.writer.write(\n        formatRunningRow({\n          displayName: check.displayName,\n          elapsedMs: check.elapsedMs,\n          displayIndex: check.omitQuietPassedRow ? undefined : this.completedCount + index + 1,\n          totalChecks\n        })\n      );\n    }\n    this.renderedRunningRows = this.running.length;\n  }\n\n  private removeRunningCheck(checkId: string): void {\n    const index = this.running.findIndex((check) => check.checkId === checkId);\n    if (index >= 0) this.running.splice(index, 1);\n  }\n\n  private updateRunningDurations(refreshedAtMs: number): void {\n    for (const check of this.running) {\n      const elapsedMs = refreshedAtMs - check.startedAtMs;\n      check.elapsedMs = Number.isFinite(elapsedMs) && elapsedMs >= 0 ? elapsedMs : 0;\n    }\n  }\n\n  private requirePrepared(): number {\n    if (this.preparedTotal === undefined) {\n      throw new Error(\"Progress feedback arrived before preparation\");\n    }\n    return this.preparedTotal;\n  }\n}\n"]}

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

@@ -8,8 +8,12 @@ export function createProgressRenderer(writer, clock = SYSTEM_PROGRESS_CLOCK, pr
     const controller = new ProgressRendererController(writer, clock, progressRendering);
     return Object.freeze({
         refreshesRunningRegion: controller.refreshesRunningRegion,
-        refresh: () => controller.refresh(),
-        render: (feedback) => controller.render(feedback)
+        refresh: () => {
+            controller.refresh();
+        },
+        render: (feedback) => {
+            controller.render(feedback);
+        }
     });
 }
 //# sourceMappingURL=renderer.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"renderer.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AA0DrE,MAAM,qBAAqB,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7F,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,KAAK,GAAkB,qBAAqB,EAC5C,iBAAiB,GAAoC,8BAA8B,CAAC;IAClF,OAAO,EAAE,IAAI;CACd,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,OAAO,EAAE,GAAS,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,CAAC,QAA0B,EAAQ,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC1E,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage, CheckOutcome, CheckVisibility } from \"../../check/check.ts\";\nimport type { CoreRecord } from \"../../check-settlement/facts.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport { resolveProgressRenderingOutput } from \"../../project-definition/output-defaults.ts\";\nimport { ProgressRendererController } from \"./renderer-lifecycle.ts\";\n\nexport interface ProgressWriter {\n  readonly color: boolean;\n  readonly isTTY: boolean;\n  readonly term: string | undefined;\n  close?(): void;\n  write(content: string): void;\n}\n\nexport type ProgressFeedback = Readonly<\n  | {\n      readonly kind: \"prepared\";\n      readonly totalChecks: number;\n    }\n  | {\n      readonly kind: \"flag-control-completed\";\n    }\n  | {\n      readonly kind: \"started\";\n      readonly checkId: string;\n      readonly displayName: string;\n    }\n  | {\n      readonly kind: \"settled\";\n      readonly checkId: string;\n      readonly displayName: string;\n      readonly outcome: CheckOutcome;\n      readonly durationMs: number | null;\n      readonly visibility: CheckVisibility;\n      readonly messages: readonly CheckMessage[];\n      readonly records: readonly CoreRecord[];\n    }\n  | {\n      readonly kind: \"final\";\n      readonly execution: \"cancelled\" | \"completed\";\n      readonly counts: ProgressOutcomeCounts;\n      readonly elapsedMs: number;\n    }\n>;\n\nexport interface ProgressOutcomeCounts {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n}\n\nexport interface ProgressRenderer {\n  refresh(): void;\n  readonly refreshesRunningRegion: boolean;\n  render(feedback: ProgressFeedback): void;\n}\n\nexport interface ProgressClock {\n  now(): number;\n}\n\nconst SYSTEM_PROGRESS_CLOCK: ProgressClock = Object.freeze({ now: () => performance.now() });\n\n/** Product-private lifecycle presentation with one owner for feedback and its writer. */\nexport function createProgressRenderer(\n  writer: ProgressWriter,\n  clock: ProgressClock = SYSTEM_PROGRESS_CLOCK,\n  progressRendering: ResolvedProgressRenderingOutput = resolveProgressRenderingOutput({\n    enabled: true\n  })\n): ProgressRenderer {\n  const controller = new ProgressRendererController(writer, clock, progressRendering);\n  return Object.freeze({\n    refreshesRunningRegion: controller.refreshesRunningRegion,\n    refresh: (): void => controller.refresh(),\n    render: (feedback: ProgressFeedback): void => controller.render(feedback)\n  });\n}\n"]}
+{"version":3,"file":"renderer.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AA4DrE,MAAM,qBAAqB,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7F,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,KAAK,GAAkB,qBAAqB,EAC5C,iBAAiB,GAAoC,8BAA8B,CAAC;IAClF,OAAO,EAAE,IAAI;CACd,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,OAAO,EAAE,GAAS,EAAE;YAClB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,EAAE,CAAC,QAA0B,EAAQ,EAAE;YAC3C,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import 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 { resolveProgressRenderingOutput } from \"../../project-definition/output-defaults.ts\";\nimport { ProgressRendererController } from \"./renderer-lifecycle.ts\";\n\nexport interface ProgressWriter {\n  readonly color: boolean;\n  readonly isTTY: boolean;\n  readonly term: string | undefined;\n  close?(): void;\n  write(content: string): void;\n}\n\nexport type ProgressFeedback = Readonly<\n  | {\n      readonly kind: \"prepared\";\n      readonly quietPassOmissionConfiguredCount: number;\n      readonly totalChecks: number;\n    }\n  | {\n      readonly kind: \"flag-control-completed\";\n    }\n  | {\n      readonly kind: \"started\";\n      readonly checkId: string;\n      readonly displayName: string;\n      readonly omitQuietPassedRow: boolean;\n    }\n  | {\n      readonly kind: \"settled\";\n      readonly checkId: string;\n      readonly displayName: string;\n      readonly outcome: CheckOutcome;\n      readonly durationMs: number | null;\n      readonly omitQuietPassedRow: boolean;\n      readonly messages: readonly CheckMessage[];\n      readonly records: readonly CoreRecord[];\n    }\n  | {\n      readonly kind: \"final\";\n      readonly execution: \"cancelled\" | \"completed\";\n      readonly counts: ProgressOutcomeCounts;\n      readonly elapsedMs: number;\n    }\n>;\n\nexport interface ProgressOutcomeCounts {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n}\n\nexport interface ProgressRenderer {\n  refresh(): void;\n  readonly refreshesRunningRegion: boolean;\n  render(feedback: ProgressFeedback): void;\n}\n\nexport interface ProgressClock {\n  now(): number;\n}\n\nconst SYSTEM_PROGRESS_CLOCK: ProgressClock = Object.freeze({ now: () => performance.now() });\n\n/** Product-private lifecycle presentation with one owner for feedback and its writer. */\nexport function createProgressRenderer(\n  writer: ProgressWriter,\n  clock: ProgressClock = SYSTEM_PROGRESS_CLOCK,\n  progressRendering: ResolvedProgressRenderingOutput = resolveProgressRenderingOutput({\n    enabled: true\n  })\n): ProgressRenderer {\n  const controller = new ProgressRendererController(writer, clock, progressRendering);\n  return Object.freeze({\n    refreshesRunningRegion: controller.refreshesRunningRegion,\n    refresh: (): void => {\n      controller.refresh();\n    },\n    render: (feedback: ProgressFeedback): void => {\n      controller.render(feedback);\n    }\n  });\n}\n"]}

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

@@ -1,7 +1,8 @@
 /** Materializes only invocation-wide callback input; Check-local options own domain configuration. */
 export function createProjectContext(input) {
     return Object.freeze({
-        flags: Object.freeze([...(input.controls.flags ?? [])]),
+        ...(input.changes === undefined ? {} : { changes: input.changes }),
+        flags: input.flags,
         root: input.paths.projectRoot
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"project-context.mjs","sourceRoot":"","sources":["../../../src/project-run/project-context.ts"],"names":[],"mappings":"AAGA,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAClC,KAA4F;IAE5F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext } from \"../check/check.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport type { ResolvedInvocationPaths } from \"./invocation/paths.ts\";\n/** Materializes only invocation-wide callback input; Check-local options own domain configuration. */\nexport function createProjectContext(\n  input: Readonly<{ readonly controls: RunControls; readonly paths: ResolvedInvocationPaths }>\n): CheckProjectContext {\n  return Object.freeze({\n    flags: Object.freeze([...(input.controls.flags ?? [])]),\n    root: input.paths.projectRoot\n  });\n}\n"]}
+{"version":3,"file":"project-context.mjs","sourceRoot":"","sources":["../../../src/project-run/project-context.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAClC,KAIE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext, ProjectChanges } from \"../check/check.ts\";\nimport type { ResolvedInvocationPaths } from \"./invocation/paths.ts\";\n/** Materializes only invocation-wide callback input; Check-local options own domain configuration. */\nexport function createProjectContext(\n  input: Readonly<{\n    readonly changes?: ProjectChanges;\n    readonly flags: readonly string[];\n    readonly paths: ResolvedInvocationPaths;\n  }>\n): CheckProjectContext {\n  return Object.freeze({\n    ...(input.changes === undefined ? {} : { changes: input.changes }),\n    flags: input.flags,\n    root: input.paths.projectRoot\n  });\n}\n"]}

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

@@ -16,8 +16,8 @@ function outputDiagnosticCode(output) {
             return "progress-rendering-failed";
         case "diagnosticLogging":
             return "diagnostic-logging-failed";
-        case "measurementHooks":
-            return "scheduler-measurement-hooks-failed";
+        case "terminalEffects":
+            return "scheduler-terminal-effects-failed";
     }
 }
 export function isCancelled(controls) {

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

@@ -1 +1 @@
-{"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../src/project-run/result.ts"],"names":[],"mappings":"AAuIA,MAAM,UAAU,aAAa,CAC3B,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,MAA+B,EAC/B,KAAqB;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO;QACP,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AACD,SAAS,oBAAoB,CAC3B,MAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB;YACvB,OAAO,4BAA4B,CAAC;QACtC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,kBAAkB;YACrB,OAAO,oCAAoC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,QAAQ,CACtB,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,IAA0D;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,wBAAwB,CACtC,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,KAA8B;IAK9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB;QACtB,kBAAkB;QAClB,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,qBAAqB,CACnC,KAOE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  DefinitionWarning,\n  ProjectDefinitionDiagnostic\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControlDiagnostic } from \"./controls/validation-result.ts\";\nimport type { CheckAggregate, RunControls } from \"./controls/contract.ts\";\nimport type { CheckMessageLevel } from \"../check/check.ts\";\nimport type { CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport type { RunOutputStatuses } from \"./outputs/status.ts\";\n\n/** Product 不能形成正常 Run 结果时的稳定 invocation diagnostic。 */\nexport type RunDiagnostic = Readonly<{\n  /** 失败的 Run-owned execution 或 planning boundary；它不是任何 Check 的 terminal status。 */\n  readonly code:\n    | \"admission-policy-failed\"\n    | \"admission-strategy-preparation-failed\"\n    | \"task-graph-invalid\"\n    | \"task-engine-failed\"\n    | \"publication-model-failed\";\n}>;\n\n/** 一项 executable Check 的最终 duration readback。 */\nexport type CheckDuration = Readonly<{\n  /** 与 snapshot 中 Check facts 相同的 stable Check identity。 */\n  readonly checkId: string;\n  /** 已测量的 execution duration；未进入 execution 的 Check 为 `null`，不是零时长。 */\n  readonly durationMs: number | null;\n}>;\n\n/** Run 在 Check terminal lifecycle 中接受的人读 message。 */\nexport interface CheckRunMessage {\n  /** 产生 message 的 stable Check identity。 */\n  readonly checkId: string;\n  /** author message 或已捕获 console output 的 presentation severity。 */\n  readonly level: CheckMessageLevel;\n  /** owning Check 或 Product capture 使用的稳定 message code。 */\n  readonly code: string;\n  /** 人读正文；不能代替 snapshot 中的 terminal outcome。 */\n  readonly message: string;\n}\n\n/** 只有已形成 terminal Check facts 的 Run branch 才具备的完整结果 readback。 */\nexport interface RunResultFacts {\n  /** 调用方未配置 aggregation 时为 `null`；否则是选中 Check statuses 的 invocation-level conclusion。 */\n  readonly aggregate: CheckAggregate | null;\n  /** 按 canonical Check order 的 duration facts；未执行 Check 仍以 `null` 保留。 */\n  readonly checkDurations: readonly CheckDuration[];\n  /** 已接受的 author 与 console-capture messages，不决定 Check outcome。 */\n  readonly checkMessages: readonly CheckRunMessage[];\n  /** 已结算的完整 Check 与 supplemental Record facts。 */\n  readonly snapshot: CoreSnapshot;\n}\n/** 一次 Project Run 的可判别结果；output failure 保留已结算 facts。 */\nexport type RunResult = Readonly<\n  | {\n      /** Definition、RunControls 或 aggregation selection 无效；没有执行任何 Check author callback。 */\n      readonly kind: \"configuration\";\n      /** Definition normalization 时仍可报告、但不单独阻止本 branch 的 warning。 */\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 指向被拒绝 Definition 或 RunControls value 的 closed diagnostic。 */\n      readonly diagnostic: ProjectDefinitionDiagnostic | RunControlDiagnostic;\n    }\n  | {\n      /** 配置有效，但 static Check graph 不能进入 execution planning。 */\n      readonly kind: \"planning\";\n      /** normalized declarative Definition 的 matching signal；不包含 RunControls 或 outcome。 */\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 这次 planning 失败的 Product diagnostic。 */\n      readonly diagnostic: RunDiagnostic;\n      /** 配置有效后各 terminal output participant 的独立状态。 */\n      readonly outputs: RunOutputStatuses;\n    }\n  | {\n      /** invocation 在 Check work 开始前或 planning 中响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 取消发生在尚未形成 terminal Check facts 的阶段。 */\n      readonly phase: \"pre-work\" | \"planning\";\n    }\n  | {\n      /** invocation 在至少可能已开始 Check work 的 execution 阶段响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 此 branch 总在 terminal Check facts 形成后的 execution cancellation 返回。 */\n      readonly phase: \"execution\";\n      /** 按 canonical Check order 的 duration facts；未执行 Check 为 `null`。 */\n      readonly checkDurations: readonly CheckDuration[];\n      /** cancellation 前已接受的 author 与 console-capture messages。 */\n      readonly checkMessages: readonly CheckRunMessage[];\n      /** cancellation 时已结算的完整 Check 与 supplemental Record facts。 */\n      readonly snapshot: CoreSnapshot;\n    }\n  | ({\n      /** 所有 Check 已完成 terminal settlement；不表示每项 Check 都 `passed`。 */\n      readonly kind: \"completed\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n  | {\n      /** Product execution/settlement infrastructure 失败；不把它误表示为 Check `failed`。 */\n      readonly kind: \"execution\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 停止正常 execution 的 Product diagnostic；本 branch 不提供 partial snapshot。 */\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | ({\n      /** Check facts 已完整结算，但至少一个 terminal output participant 失败。 */\n      readonly kind: \"output\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 失败的 machine、progress、diagnostic 或 scheduler-measurement output 类别。 */\n      readonly diagnostic: Readonly<{\n        readonly code:\n          | \"machine-publication-failed\"\n          | \"progress-rendering-failed\"\n          | \"diagnostic-logging-failed\"\n          | \"scheduler-measurement-hooks-failed\";\n      }>;\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n>;\n\n/** Any Run result produced after controls and Definition validation have completed. */\nexport type NonConfigurationRunResult = Exclude<RunResult, { readonly kind: \"configuration\" }>;\n\ntype OutputRunResult = Extract<RunResult, { readonly kind: \"output\" }>;\n\nexport function outputFailure(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  output: keyof RunOutputStatuses,\n  facts: RunResultFacts\n): OutputRunResult {\n  return Object.freeze({\n    kind: \"output\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code: outputDiagnosticCode(output) }),\n    outputs,\n    ...facts\n  });\n}\nfunction outputDiagnosticCode(\n  output: keyof RunOutputStatuses\n): Extract<RunResult, { readonly kind: \"output\" }>[\"diagnostic\"][\"code\"] {\n  switch (output) {\n    case \"machinePublication\":\n      return \"machine-publication-failed\";\n    case \"progressRendering\":\n      return \"progress-rendering-failed\";\n    case \"diagnosticLogging\":\n      return \"diagnostic-logging-failed\";\n    case \"measurementHooks\":\n      return \"scheduler-measurement-hooks-failed\";\n  }\n}\n\nexport function isCancelled(controls: RunControls): boolean {\n  return controls.signal?.aborted === true;\n}\nexport function planning(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): Extract<NonConfigurationRunResult, { readonly kind: \"planning\" }> {\n  return Object.freeze({\n    kind: \"planning\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs\n  });\n}\nexport function preExecutionCancellation(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  phase: \"pre-work\" | \"planning\"\n): Extract<\n  NonConfigurationRunResult,\n  { readonly kind: \"cancelled\"; readonly phase: \"pre-work\" | \"planning\" }\n> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint,\n    definitionWarnings,\n    outputs,\n    phase\n  });\n}\nexport function executionCancellation(\n  input: Readonly<{\n    readonly checkDurations: readonly CheckDuration[];\n    readonly checkMessages: readonly CheckRunMessage[];\n    readonly declarativeFingerprint: string;\n    readonly definitionWarnings: readonly DefinitionWarning[];\n    readonly outputs: RunOutputStatuses;\n    readonly snapshot: CoreSnapshot;\n  }>\n): Extract<NonConfigurationRunResult, { readonly kind: \"cancelled\"; readonly phase: \"execution\" }> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint: input.declarativeFingerprint,\n    definitionWarnings: input.definitionWarnings,\n    outputs: input.outputs,\n    phase: \"execution\",\n    checkDurations: input.checkDurations,\n    checkMessages: input.checkMessages,\n    snapshot: input.snapshot\n  });\n}\n"]}
+{"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../src/project-run/result.ts"],"names":[],"mappings":"AAuIA,MAAM,UAAU,aAAa,CAC3B,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,MAA+B,EAC/B,KAAqB;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO;QACP,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AACD,SAAS,oBAAoB,CAC3B,MAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB;YACvB,OAAO,4BAA4B,CAAC;QACtC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,iBAAiB;YACpB,OAAO,mCAAmC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,QAAQ,CACtB,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,IAA0D;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,wBAAwB,CACtC,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,KAA8B;IAK9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB;QACtB,kBAAkB;QAClB,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,qBAAqB,CACnC,KAOE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  DefinitionWarning,\n  ProjectDefinitionDiagnostic\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControlDiagnostic } from \"./controls/validation-result.ts\";\nimport type { CheckAggregate, RunControls } from \"./controls/contract.ts\";\nimport type { CheckMessageLevel } from \"../check/check.ts\";\nimport type { CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport type { RunOutputStatuses } from \"./outputs/status.ts\";\n\n/** Product 不能形成正常 Run 结果时的稳定 invocation diagnostic。 */\nexport type RunDiagnostic = Readonly<{\n  /** 失败的 Run-owned execution 或 planning boundary；它不是任何 Check 的 terminal status。 */\n  readonly code:\n    | \"admission-policy-failed\"\n    | \"admission-strategy-preparation-failed\"\n    | \"task-graph-invalid\"\n    | \"task-engine-failed\"\n    | \"publication-model-failed\";\n}>;\n\n/** 一项 executable Check 的最终 duration readback。 */\nexport type CheckDuration = Readonly<{\n  /** 与 snapshot 中 Check facts 相同的 stable Check identity。 */\n  readonly checkId: string;\n  /** 已测量的 execution duration；未进入 execution 的 Check 为 `null`，不是零时长。 */\n  readonly durationMs: number | null;\n}>;\n\n/** Run 在 Check terminal lifecycle 中接受的人读 message。 */\nexport interface CheckRunMessage {\n  /** 产生 message 的 stable Check identity。 */\n  readonly checkId: string;\n  /** author message 或已捕获 console output 的 presentation severity。 */\n  readonly level: CheckMessageLevel;\n  /** owning Check 或 Product capture 使用的稳定 message code。 */\n  readonly code: string;\n  /** 人读正文；不能代替 snapshot 中的 terminal outcome。 */\n  readonly message: string;\n}\n\n/** 只有已形成 terminal Check facts 的 Run branch 才具备的完整结果 readback。 */\nexport interface RunResultFacts {\n  /** 有完整 terminal Check facts 时，由有效 Check 列表形成的 invocation-level conclusion。 */\n  readonly aggregate: CheckAggregate;\n  /** 按 canonical Check order 的 duration facts；未执行 Check 仍以 `null` 保留。 */\n  readonly checkDurations: readonly CheckDuration[];\n  /** 已接受的 author 与 console-capture messages，不决定 Check outcome。 */\n  readonly checkMessages: readonly CheckRunMessage[];\n  /** 已结算的完整 Check 与 supplemental Record facts。 */\n  readonly snapshot: CoreSnapshot;\n}\n/** 一次 Project Run 的可判别结果；output failure 保留已结算 facts。 */\nexport type RunResult = Readonly<\n  | {\n      /** Definition、RunControls 或 aggregation selection 无效；没有执行任何 Check author callback。 */\n      readonly kind: \"configuration\";\n      /** Definition normalization 时仍可报告、但不单独阻止本 branch 的 warning。 */\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 指向被拒绝 Definition 或 RunControls value 的 closed diagnostic。 */\n      readonly diagnostic: ProjectDefinitionDiagnostic | RunControlDiagnostic;\n    }\n  | {\n      /** 配置有效，但 static Check graph 不能进入 execution planning。 */\n      readonly kind: \"planning\";\n      /** normalized declarative Definition 的 matching signal；不包含 RunControls 或 outcome。 */\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 这次 planning 失败的 Product diagnostic。 */\n      readonly diagnostic: RunDiagnostic;\n      /** 配置有效后各 terminal output participant 的独立状态。 */\n      readonly outputs: RunOutputStatuses;\n    }\n  | {\n      /** invocation 在 Check work 开始前或 planning 中响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 取消发生在尚未形成 terminal Check facts 的阶段。 */\n      readonly phase: \"pre-work\" | \"planning\";\n    }\n  | {\n      /** invocation 在至少可能已开始 Check work 的 execution 阶段响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 此 branch 总在 terminal Check facts 形成后的 execution cancellation 返回。 */\n      readonly phase: \"execution\";\n      /** 按 canonical Check order 的 duration facts；未执行 Check 为 `null`。 */\n      readonly checkDurations: readonly CheckDuration[];\n      /** cancellation 前已接受的 author 与 console-capture messages。 */\n      readonly checkMessages: readonly CheckRunMessage[];\n      /** cancellation 时已结算的完整 Check 与 supplemental Record facts。 */\n      readonly snapshot: CoreSnapshot;\n    }\n  | ({\n      /** 所有 Check 已完成 terminal settlement；不表示每项 Check 都 `passed`。 */\n      readonly kind: \"completed\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n  | {\n      /** Product execution/settlement infrastructure 失败；不把它误表示为 Check `failed`。 */\n      readonly kind: \"execution\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 停止正常 execution 的 Product diagnostic；本 branch 不提供 partial snapshot。 */\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | ({\n      /** Check facts 已完整结算，但至少一个 terminal output participant 失败。 */\n      readonly kind: \"output\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 失败的 machine、progress、diagnostic 或 scheduler-measurement output 类别。 */\n      readonly diagnostic: Readonly<{\n        readonly code:\n          | \"machine-publication-failed\"\n          | \"progress-rendering-failed\"\n          | \"diagnostic-logging-failed\"\n          | \"scheduler-terminal-effects-failed\";\n      }>;\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n>;\n\n/** Any Run result produced after controls and Definition validation have completed. */\nexport type NonConfigurationRunResult = Exclude<RunResult, { readonly kind: \"configuration\" }>;\n\ntype OutputRunResult = Extract<RunResult, { readonly kind: \"output\" }>;\n\nexport function outputFailure(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  output: keyof RunOutputStatuses,\n  facts: RunResultFacts\n): OutputRunResult {\n  return Object.freeze({\n    kind: \"output\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code: outputDiagnosticCode(output) }),\n    outputs,\n    ...facts\n  });\n}\nfunction outputDiagnosticCode(\n  output: keyof RunOutputStatuses\n): Extract<RunResult, { readonly kind: \"output\" }>[\"diagnostic\"][\"code\"] {\n  switch (output) {\n    case \"machinePublication\":\n      return \"machine-publication-failed\";\n    case \"progressRendering\":\n      return \"progress-rendering-failed\";\n    case \"diagnosticLogging\":\n      return \"diagnostic-logging-failed\";\n    case \"terminalEffects\":\n      return \"scheduler-terminal-effects-failed\";\n  }\n}\n\nexport function isCancelled(controls: RunControls): boolean {\n  return controls.signal?.aborted === true;\n}\nexport function planning(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): Extract<NonConfigurationRunResult, { readonly kind: \"planning\" }> {\n  return Object.freeze({\n    kind: \"planning\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs\n  });\n}\nexport function preExecutionCancellation(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  phase: \"pre-work\" | \"planning\"\n): Extract<\n  NonConfigurationRunResult,\n  { readonly kind: \"cancelled\"; readonly phase: \"pre-work\" | \"planning\" }\n> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint,\n    definitionWarnings,\n    outputs,\n    phase\n  });\n}\nexport function executionCancellation(\n  input: Readonly<{\n    readonly checkDurations: readonly CheckDuration[];\n    readonly checkMessages: readonly CheckRunMessage[];\n    readonly declarativeFingerprint: string;\n    readonly definitionWarnings: readonly DefinitionWarning[];\n    readonly outputs: RunOutputStatuses;\n    readonly snapshot: CoreSnapshot;\n  }>\n): Extract<NonConfigurationRunResult, { readonly kind: \"cancelled\"; readonly phase: \"execution\" }> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint: input.declarativeFingerprint,\n    definitionWarnings: input.definitionWarnings,\n    outputs: input.outputs,\n    phase: \"execution\",\n    checkDurations: input.checkDurations,\n    checkMessages: input.checkMessages,\n    snapshot: input.snapshot\n  });\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../../../src/project-run/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAuB1D,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,UAAmB,EAAE,QAAQ,GAAY,EAAE;IACnE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,mBAAmB,CAAC,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,iBAAiB,CAAC,KAAK;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CACxB,mBAAmB,CAAC,KAAK,EACzB,iBAAiB,CAAC,KAAK,EACvB,mBAAmB,CAAC,QAAQ,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["import type { ProjectDefinition } from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport { validateProjectDefinition } from \"../project-definition/project-definition-validation.ts\";\nimport { validateRunControls } from \"./controls/validation.ts\";\nimport { executeValidatedRun } from \"./invocation/run.ts\";\nimport type { RunResult } from \"./result.ts\";\n\nexport type { RunOutputStatus, RunOutputStatuses } from \"./outputs/status.ts\";\nexport type { RunDiagnostic, RunResult } from \"./result.ts\";\n\n/**\n * 在调用方的 Node runtime 中执行一个由项目拥有的 Project Definition。\n *\n * @param definition - Project Definition input；{@link defineConfig} 补齐 defaults，run 在 invocation 前验证。\n * @param controls - 本次 invocation context 与 outputs 使用的闭合控制值。\n * @returns ordinary configuration、planning、execution、cancellation 与 output failures 通过 `RunResult`\n * 返回；调用方先按 `kind` narrow。\n * @remarks Definition validation 关闭 authoring grammar；可选 Check preflight 在其 Task 通过直接 relation\n * readiness 后被 Scheduler admission 时运行，并先于该 Check 自己的 execution callback。它受该 Task 的\n * mutex、capacity、priority 与 cancellation 约束，而不是 invocation-wide barrier。`output` branch 同时提供\n * 完整 final snapshot 与 output failure diagnostic。\n */\nexport async function run(\n  definition: ProjectDefinition,\n  controls?: RunControls\n): Promise<RunResult>;\nexport async function run(definition: unknown, controls?: unknown): Promise<RunResult>;\nexport async function run(definition: unknown, controls: unknown = {}): Promise<RunResult> {\n  const validatedDefinition = validateProjectDefinition(definition);\n  if (!validatedDefinition.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedDefinition.error\n    });\n  }\n  const validatedControls = validateRunControls(controls);\n  if (!validatedControls.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedControls.error\n    });\n  }\n\n  return executeValidatedRun(\n    validatedDefinition.value,\n    validatedControls.value,\n    validatedDefinition.warnings\n  );\n}\n"]}
+{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../../../src/project-run/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAuB1D,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,UAAmB,EAAE,QAAQ,GAAY,EAAE;IACnE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,mBAAmB,CAAC,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,iBAAiB,CAAC,KAAK;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CACxB,mBAAmB,CAAC,KAAK,EACzB,iBAAiB,CAAC,KAAK,EACvB,mBAAmB,CAAC,QAAQ,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["import type { ProjectDefinition } from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport { validateProjectDefinition } from \"../project-definition/project-definition-validation.ts\";\nimport { validateRunControls } from \"./controls/validation.ts\";\nimport { executeValidatedRun } from \"./invocation/run.ts\";\nimport type { RunResult } from \"./result.ts\";\n\nexport type { RunOutputStatus, RunOutputStatuses } from \"./outputs/status.ts\";\nexport type { RunDiagnostic, RunResult } from \"./result.ts\";\n\n/**\n * 在调用方的 Node runtime 中执行一个由项目拥有的 Project Definition。\n *\n * @param definition - Project Definition input；{@link defineConfig} 补齐 defaults，run 在 invocation 前验证。\n * @param controls - 本次 invocation context 与 outputs 使用的闭合控制值。\n * @returns ordinary configuration、planning、execution、cancellation 与 output failures 通过 `RunResult`\n * 返回；调用方先按 `kind` narrow。\n * @remarks Definition validation 关闭 authoring grammar；可选 Check preparation 在其 Task 通过直接 relation\n * readiness 后被 Scheduler admission 时运行，并先于该 Check 自己的 execution callback。它受该 Task 的\n * mutex、capacity、priority 与 cancellation 约束，而不是 invocation-wide barrier。`output` branch 同时提供\n * 完整 final snapshot 与 output failure diagnostic。\n */\nexport async function run(\n  definition: ProjectDefinition,\n  controls?: RunControls\n): Promise<RunResult>;\nexport async function run(definition: unknown, controls?: unknown): Promise<RunResult>;\nexport async function run(definition: unknown, controls: unknown = {}): Promise<RunResult> {\n  const validatedDefinition = validateProjectDefinition(definition);\n  if (!validatedDefinition.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedDefinition.error\n    });\n  }\n  const validatedControls = validateRunControls(controls);\n  if (!validatedControls.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedControls.error\n    });\n  }\n\n  return executeValidatedRun(\n    validatedDefinition.value,\n    validatedControls.value,\n    validatedDefinition.warnings\n  );\n}\n"]}