@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,135 @@
+import { createProgressRenderer } from "./renderer.mjs";
+const PROGRESS_REFRESH_INTERVAL_MS = 5_000;
+const defaultProgressRefreshScheduler = Object.freeze({
+    schedule: (refresh, intervalMs) => {
+        const interval = setInterval(refresh, intervalMs);
+        interval.unref();
+        return Object.freeze({ cancel: () => clearInterval(interval) });
+    }
+});
+/** Owns progress writer lifecycle and rendering; failed writers are permanently muted. */
+export function createProgressRendering(configuration, statuses, dependencies = {}) {
+    if (!configuration.enabled)
+        return inertProgressRendering();
+    let failed = false;
+    const runningCheckIds = new Set();
+    let renderer;
+    let refreshSchedule;
+    const failRendering = () => {
+        if (failed)
+            return;
+        failed = true;
+        const activeSchedule = refreshSchedule;
+        refreshSchedule = undefined;
+        try {
+            activeSchedule?.cancel();
+        }
+        catch {
+            // The output is already failed; a scheduler cleanup fault must not reach Check execution.
+        }
+        statuses.failed("progressRendering");
+    };
+    const stopRefresh = () => {
+        const activeSchedule = refreshSchedule;
+        refreshSchedule = undefined;
+        try {
+            activeSchedule?.cancel();
+        }
+        catch {
+            failRendering();
+        }
+    };
+    const render = (feedback) => {
+        if (failed)
+            return;
+        try {
+            renderer ??= createProgressRenderer((dependencies.writerFactory ?? defaultProgressWriter)(), dependencies.clock);
+            renderer.render(feedback);
+            if (feedback.kind === "final") {
+                statuses.succeeded("progressRendering");
+            }
+        }
+        catch {
+            failRendering();
+        }
+    };
+    const refresh = () => {
+        if (failed)
+            return;
+        try {
+            renderer?.refresh();
+        }
+        catch {
+            failRendering();
+        }
+    };
+    const startRefresh = () => {
+        if (failed ||
+            refreshSchedule !== undefined ||
+            runningCheckIds.size === 0 ||
+            renderer?.refreshesRunningRegion !== true) {
+            return;
+        }
+        try {
+            refreshSchedule = (dependencies.refreshScheduler ?? defaultProgressRefreshScheduler).schedule(refresh, PROGRESS_REFRESH_INTERVAL_MS);
+        }
+        catch {
+            failRendering();
+        }
+    };
+    return Object.freeze({
+        prepared: (totalChecks) => render(Object.freeze({ kind: "prepared", totalChecks })),
+        lifecycle: Object.freeze({
+            settled: (fact) => {
+                render(Object.freeze({
+                    kind: "settled",
+                    checkId: fact.checkId,
+                    displayName: fact.displayName,
+                    durationMs: fact.durationMs,
+                    messages: fact.messages,
+                    outcome: fact.outcome,
+                    visibility: fact.visibility
+                }));
+                runningCheckIds.delete(fact.checkId);
+                if (runningCheckIds.size === 0)
+                    stopRefresh();
+            },
+            started: (fact) => {
+                runningCheckIds.add(fact.checkId);
+                render(Object.freeze({ kind: "started", checkId: fact.checkId, displayName: fact.displayName }));
+                startRefresh();
+            }
+        }),
+        final: (input) => {
+            stopRefresh();
+            render(Object.freeze({
+                kind: "final",
+                counts: input.counts,
+                elapsedMs: input.elapsedMs,
+                execution: input.execution
+            }));
+        }
+    });
+}
+function inertProgressRendering() {
+    const lifecycle = Object.freeze({
+        settled: (_fact) => undefined,
+        started: (_fact) => undefined
+    });
+    return Object.freeze({
+        prepared: (_totalChecks) => undefined,
+        lifecycle,
+        final: (_input) => undefined
+    });
+}
+function defaultProgressWriter() {
+    return Object.freeze({
+        color: process.stdout.isTTY === true && process.env.NO_COLOR === undefined,
+        isTTY: process.stdout.isTTY === true,
+        term: process.env.TERM,
+        write: (content) => {
+            process.stdout.write(content);
+        }
+    });
+}
+//# sourceMappingURL=presentation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CheckExecutionLifecycle,\n  CheckSettledFact,\n  CheckStartedFact\n} from \"../check-execution/resolved-checks.ts\";\nimport {\n  createProgressRenderer,\n  type ProgressClock,\n  type ProgressFeedback,\n  type ProgressOutcomeCounts,\n  type ProgressWriter\n} from \"./renderer.ts\";\nimport type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport type { OutputStatuses } from \"../output-status.ts\";\nexport interface ProgressRendering {\n  readonly final: (input: ProgressFinalFeedback) => void;\n  readonly lifecycle: CheckExecutionLifecycle;\n  readonly prepared: (totalChecks: number) => void;\n}\nexport interface ProgressFinalFeedback {\n  readonly counts: ProgressOutcomeCounts;\n  readonly elapsedMs: number;\n  readonly execution: \"cancelled\" | \"completed\";\n}\nexport type ProgressWriterFactory = () => ProgressWriter;\n\nexport interface ProgressRefreshSchedule {\n  cancel(): void;\n}\n\nexport interface ProgressRefreshScheduler {\n  schedule(refresh: () => void, intervalMs: number): ProgressRefreshSchedule;\n}\n\nexport interface ProgressRenderingDependencies {\n  readonly clock?: ProgressClock;\n  readonly refreshScheduler?: ProgressRefreshScheduler;\n  readonly writerFactory?: ProgressWriterFactory;\n}\n\nconst PROGRESS_REFRESH_INTERVAL_MS = 5_000;\n\nconst defaultProgressRefreshScheduler: ProgressRefreshScheduler = Object.freeze({\n  schedule: (refresh: () => void, intervalMs: number) => {\n    const interval = setInterval(refresh, intervalMs);\n    interval.unref();\n    return Object.freeze({ cancel: () => clearInterval(interval) });\n  }\n});\n\n/** Owns progress writer lifecycle and rendering; failed writers are permanently muted. */\nexport function createProgressRendering(\n  configuration: ProjectOutputs[\"progressRendering\"],\n  statuses: OutputStatuses,\n  dependencies: ProgressRenderingDependencies = {}\n): ProgressRendering {\n  if (!configuration.enabled) return inertProgressRendering();\n  let failed = false;\n  const runningCheckIds = new Set<string>();\n  let renderer: ReturnType<typeof createProgressRenderer> | undefined;\n  let refreshSchedule: ProgressRefreshSchedule | undefined;\n\n  const failRendering = (): void => {\n    if (failed) return;\n    failed = true;\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      // The output is already failed; a scheduler cleanup fault must not reach Check execution.\n    }\n    statuses.failed(\"progressRendering\");\n  };\n\n  const stopRefresh = (): void => {\n    const activeSchedule = refreshSchedule;\n    refreshSchedule = undefined;\n    try {\n      activeSchedule?.cancel();\n    } catch {\n      failRendering();\n    }\n  };\n\n  const render = (feedback: ProgressFeedback): void => {\n    if (failed) return;\n    try {\n      renderer ??= createProgressRenderer(\n        (dependencies.writerFactory ?? defaultProgressWriter)(),\n        dependencies.clock\n      );\n      renderer.render(feedback);\n      if (feedback.kind === \"final\") {\n        statuses.succeeded(\"progressRendering\");\n      }\n    } catch {\n      failRendering();\n    }\n  };\n\n  const refresh = (): void => {\n    if (failed) return;\n    try {\n      renderer?.refresh();\n    } catch {\n      failRendering();\n    }\n  };\n\n  const startRefresh = (): void => {\n    if (\n      failed ||\n      refreshSchedule !== undefined ||\n      runningCheckIds.size === 0 ||\n      renderer?.refreshesRunningRegion !== true\n    ) {\n      return;\n    }\n    try {\n      refreshSchedule = (dependencies.refreshScheduler ?? defaultProgressRefreshScheduler).schedule(\n        refresh,\n        PROGRESS_REFRESH_INTERVAL_MS\n      );\n    } catch {\n      failRendering();\n    }\n  };\n\n  return Object.freeze({\n    prepared: (totalChecks: number) => render(Object.freeze({ kind: \"prepared\", totalChecks })),\n    lifecycle: Object.freeze({\n      settled: (fact: CheckSettledFact) => {\n        render(\n          Object.freeze({\n            kind: \"settled\",\n            checkId: fact.checkId,\n            displayName: fact.displayName,\n            durationMs: fact.durationMs,\n            messages: fact.messages,\n            outcome: fact.outcome,\n            visibility: fact.visibility\n          })\n        );\n        runningCheckIds.delete(fact.checkId);\n        if (runningCheckIds.size === 0) stopRefresh();\n      },\n      started: (fact: CheckStartedFact) => {\n        runningCheckIds.add(fact.checkId);\n        render(\n          Object.freeze({ kind: \"started\", checkId: fact.checkId, displayName: fact.displayName })\n        );\n        startRefresh();\n      }\n    }),\n    final: (input: ProgressFinalFeedback) => {\n      stopRefresh();\n      render(\n        Object.freeze({\n          kind: \"final\",\n          counts: input.counts,\n          elapsedMs: input.elapsedMs,\n          execution: input.execution\n        })\n      );\n    }\n  });\n}\nfunction inertProgressRendering(): ProgressRendering {\n  const lifecycle = Object.freeze({\n    settled: (_fact: CheckSettledFact): void => undefined,\n    started: (_fact: CheckStartedFact): void => undefined\n  });\n  return Object.freeze({\n    prepared: (_totalChecks: number): void => undefined,\n    lifecycle,\n    final: (_input: ProgressFinalFeedback): void => undefined\n  });\n}\nfunction defaultProgressWriter(): ProgressWriter {\n  return Object.freeze({\n    color: process.stdout.isTTY === true && process.env.NO_COLOR === undefined,\n    isTTY: process.stdout.isTTY === true,\n    term: process.env.TERM,\n    write: (content: string) => {\n      process.stdout.write(content);\n    }\n  });\n}\n"]}

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

@@ -0,0 +1,100 @@
+const COLOR = Object.freeze({
+    error: "\u001B[31m",
+    info: "\u001B[36m",
+    reset: "\u001B[0m",
+    warning: "\u001B[33m"
+});
+const NAMED_CONTROL_ESCAPES = Object.freeze({
+    "\n": "\\n",
+    "\r": "\\r",
+    "\t": "\\t"
+});
+export function formatRunningRow(input) {
+    const elapsed = input.elapsedMs === null ? "" : ` | ${formatDuration(input.elapsedMs)}`;
+    return `  [${input.displayIndex}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | running${elapsed}\n`;
+}
+export function shouldPresentSettledFeedback(feedback) {
+    return (feedback.visibility !== "attention" ||
+        feedback.outcome.status !== "passed" ||
+        feedback.messages.length > 0);
+}
+export function formatSettledBlock(input) {
+    const status = statusForOutcome(input.outcome);
+    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`;
+    return `${row}${input.messages.map((message) => formatMessage(message, input.usesColor)).join("")}`;
+}
+export function formatFinalSummary(input) {
+    return [
+        "",
+        "Execution summary:",
+        `  execution: ${input.execution}`,
+        `  total checks: ${totalChecks(input.counts)}`,
+        `  passed: ${input.counts.passed}`,
+        `  failed: ${input.counts.failed}`,
+        `  not applicable: ${input.counts.notApplicable}`,
+        `  unavailable: ${input.counts.unavailable}`,
+        `  elapsed: ${formatDuration(input.elapsedMs)}`,
+        ""
+    ].join("\n");
+}
+function formatMessage(message, usesColor) {
+    const label = colorMessageLevel(message.level, usesColor);
+    return `    [${label}] ${escapeTerminalText(message.message)}\n`;
+}
+function totalChecks(counts) {
+    return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;
+}
+function statusForOutcome(outcome) {
+    switch (outcome.status) {
+        case "passed":
+        case "failed":
+            return outcome.status;
+        case "not-applicable":
+            return "not-applicable";
+        case "unavailable":
+            return "unavailable";
+    }
+}
+function reasonForOutcome(outcome) {
+    return outcome.status === "passed" || outcome.status === "failed"
+        ? undefined
+        : outcome.reason?.code;
+}
+/** Human-only fields must not control the terminal that presents them. */
+function escapeTerminalText(value) {
+    let escaped = "";
+    for (const character of value) {
+        const codePoint = character.codePointAt(0) ?? 0;
+        const namedEscape = NAMED_CONTROL_ESCAPES[character];
+        if (namedEscape !== undefined) {
+            escaped += namedEscape;
+            continue;
+        }
+        escaped += isTerminalControl(codePoint)
+            ? `\\u${codePoint.toString(16).padStart(4, "0").toUpperCase()}`
+            : character;
+    }
+    return escaped;
+}
+function isTerminalControl(codePoint) {
+    return (codePoint <= 0x1f ||
+        (codePoint >= 0x7f && codePoint <= 0x9f) ||
+        codePoint === 0x2028 ||
+        codePoint === 0x2029);
+}
+function colorMessageLevel(level, usesColor) {
+    if (!usesColor)
+        return level;
+    return `${COLOR[level]}${level}${COLOR.reset}`;
+}
+function formatDuration(durationMs) {
+    if (durationMs < 1_000) {
+        return `${Number.isInteger(durationMs) ? durationMs : Number(durationMs.toFixed(1))}ms`;
+    }
+    const seconds = durationMs / 1_000;
+    return `${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(1))}s`;
+}
+//# sourceMappingURL=renderer-formatting.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-formatting.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-formatting.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckOutcome } from \"../../check/check.ts\";\nimport type { ProgressFeedback, ProgressOutcomeCounts } from \"./renderer.ts\";\n\nconst COLOR = Object.freeze({\n  error: \"\\u001B[31m\",\n  info: \"\\u001B[36m\",\n  reset: \"\\u001B[0m\",\n  warning: \"\\u001B[33m\"\n});\n\nconst NAMED_CONTROL_ESCAPES: Readonly<Partial<Record<string, string>>> = Object.freeze({\n  \"\\n\": \"\\\\n\",\n  \"\\r\": \"\\\\r\",\n  \"\\t\": \"\\\\t\"\n});\n\nexport function formatRunningRow(\n  input: Readonly<{\n    readonly displayIndex: number;\n    readonly displayName: string;\n    readonly elapsedMs: number | null;\n    readonly totalChecks: number;\n  }>\n): string {\n  const elapsed = input.elapsedMs === null ? \"\" : ` | ${formatDuration(input.elapsedMs)}`;\n  return `  [${input.displayIndex}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | running${elapsed}\\n`;\n}\n\nexport function shouldPresentSettledFeedback(\n  feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>\n): boolean {\n  return (\n    feedback.visibility !== \"attention\" ||\n    feedback.outcome.status !== \"passed\" ||\n    feedback.messages.length > 0\n  );\n}\n\nexport function formatSettledBlock(\n  input: Readonly<{\n    readonly completionOrdinal: number;\n    readonly displayName: string;\n    readonly durationMs: number | null;\n    readonly messages: readonly CheckMessage[];\n    readonly outcome: CheckOutcome;\n    readonly totalChecks: number;\n    readonly usesColor: boolean;\n  }>\n): string {\n  const status = statusForOutcome(input.outcome);\n  const reason = reasonForOutcome(input.outcome);\n  const duration = input.durationMs === null ? \"not run\" : formatDuration(input.durationMs);\n  const reasonSuffix = reason === undefined ? \"\" : ` | ${escapeTerminalText(reason)}`;\n  const row = `  [${input.completionOrdinal}/${input.totalChecks}] ${escapeTerminalText(input.displayName)} | ${status} | ${duration}${reasonSuffix}\\n`;\n  return `${row}${input.messages.map((message) => formatMessage(message, input.usesColor)).join(\"\")}`;\n}\n\nexport function formatFinalSummary(\n  input: Extract<ProgressFeedback, { readonly kind: \"final\" }>\n): string {\n  return [\n    \"\",\n    \"Execution summary:\",\n    `  execution: ${input.execution}`,\n    `  total checks: ${totalChecks(input.counts)}`,\n    `  passed: ${input.counts.passed}`,\n    `  failed: ${input.counts.failed}`,\n    `  not applicable: ${input.counts.notApplicable}`,\n    `  unavailable: ${input.counts.unavailable}`,\n    `  elapsed: ${formatDuration(input.elapsedMs)}`,\n    \"\"\n  ].join(\"\\n\");\n}\n\nfunction formatMessage(message: CheckMessage, usesColor: boolean): string {\n  const label = colorMessageLevel(message.level, usesColor);\n  return `    [${label}] ${escapeTerminalText(message.message)}\\n`;\n}\n\nfunction totalChecks(counts: ProgressOutcomeCounts): number {\n  return counts.passed + counts.failed + counts.notApplicable + counts.unavailable;\n}\n\nfunction statusForOutcome(outcome: CheckOutcome): ProgressStatus {\n  switch (outcome.status) {\n    case \"passed\":\n    case \"failed\":\n      return outcome.status;\n    case \"not-applicable\":\n      return \"not-applicable\";\n    case \"unavailable\":\n      return \"unavailable\";\n  }\n}\n\nfunction reasonForOutcome(outcome: CheckOutcome): string | undefined {\n  return outcome.status === \"passed\" || outcome.status === \"failed\"\n    ? undefined\n    : outcome.reason?.code;\n}\n\n/** Human-only fields must not control the terminal that presents them. */\nfunction escapeTerminalText(value: string): string {\n  let escaped = \"\";\n  for (const character of value) {\n    const codePoint = character.codePointAt(0) ?? 0;\n    const namedEscape = NAMED_CONTROL_ESCAPES[character];\n    if (namedEscape !== undefined) {\n      escaped += namedEscape;\n      continue;\n    }\n    escaped += isTerminalControl(codePoint)\n      ? `\\\\u${codePoint.toString(16).padStart(4, \"0\").toUpperCase()}`\n      : character;\n  }\n  return escaped;\n}\n\nfunction isTerminalControl(codePoint: number): boolean {\n  return (\n    codePoint <= 0x1f ||\n    (codePoint >= 0x7f && codePoint <= 0x9f) ||\n    codePoint === 0x2028 ||\n    codePoint === 0x2029\n  );\n}\n\nfunction colorMessageLevel(level: CheckMessage[\"level\"], usesColor: boolean): string {\n  if (!usesColor) return level;\n  return `${COLOR[level]}${level}${COLOR.reset}`;\n}\n\ntype ProgressStatus = CheckOutcome[\"status\"];\n\nfunction formatDuration(durationMs: number): string {\n  if (durationMs < 1_000) {\n    return `${Number.isInteger(durationMs) ? durationMs : Number(durationMs.toFixed(1))}ms`;\n  }\n  const seconds = durationMs / 1_000;\n  return `${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(1))}s`;\n}\n"]}

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

@@ -0,0 +1,123 @@
+import { formatFinalSummary, formatRunningRow, formatSettledBlock, shouldPresentSettledFeedback } from "./renderer-formatting.mjs";
+/** Maintains the mutable lifecycle state and the TTY-only running terminal region. */
+export class ProgressRendererController {
+    refreshesRunningRegion;
+    clock;
+    writer;
+    completedCount = 0;
+    preparedTotal;
+    renderedRunningRows = 0;
+    running = [];
+    usesColor;
+    constructor(writer, clock) {
+        this.writer = writer;
+        this.clock = clock;
+        this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== "dumb";
+        this.usesColor = this.refreshesRunningRegion && writer.color;
+    }
+    refresh() {
+        if (!this.refreshesRunningRegion || this.running.length === 0)
+            return;
+        this.requirePrepared();
+        this.eraseRunningRegion();
+        this.updateRunningDurations(this.clock.now());
+        this.redrawRunningRegion();
+    }
+    render(feedback) {
+        switch (feedback.kind) {
+            case "prepared":
+                this.prepare(feedback.totalChecks);
+                return;
+            case "started":
+                this.start(feedback);
+                return;
+            case "settled":
+                this.settle(feedback);
+                return;
+            case "final":
+                this.finish(feedback);
+        }
+    }
+    prepare(totalChecks) {
+        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`);
+    }
+    start(feedback) {
+        if (!this.refreshesRunningRegion)
+            return;
+        this.requirePrepared();
+        this.eraseRunningRegion();
+        this.running.push({
+            checkId: feedback.checkId,
+            displayName: feedback.displayName,
+            elapsedMs: null,
+            startedAtMs: this.clock.now()
+        });
+        this.redrawRunningRegion();
+    }
+    settle(feedback) {
+        const totalChecks = this.requirePrepared();
+        if (this.refreshesRunningRegion)
+            this.eraseRunningRegion();
+        this.completedCount += 1;
+        this.removeRunningCheck(feedback.checkId);
+        if (shouldPresentSettledFeedback(feedback)) {
+            this.writer.write(formatSettledBlock({
+                completionOrdinal: this.completedCount,
+                displayName: feedback.displayName,
+                durationMs: feedback.durationMs,
+                messages: feedback.messages,
+                outcome: feedback.outcome,
+                totalChecks,
+                usesColor: this.usesColor
+            }));
+        }
+        if (this.refreshesRunningRegion)
+            this.redrawRunningRegion();
+    }
+    finish(feedback) {
+        this.requirePrepared();
+        if (this.running.length > 0) {
+            throw new Error("Progress feedback finalized while Checks are still running");
+        }
+        this.writer.write(formatFinalSummary(feedback));
+    }
+    eraseRunningRegion() {
+        for (let index = 0; index < this.renderedRunningRows; index += 1) {
+            this.writer.write("\u001B[1A\u001B[2K");
+        }
+        this.renderedRunningRows = 0;
+    }
+    redrawRunningRegion() {
+        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,
+                totalChecks
+            }));
+        }
+        this.renderedRunningRows = this.running.length;
+    }
+    removeRunningCheck(checkId) {
+        const index = this.running.findIndex((check) => check.checkId === checkId);
+        if (index >= 0)
+            this.running.splice(index, 1);
+    }
+    updateRunningDurations(refreshedAtMs) {
+        for (const check of this.running) {
+            const elapsedMs = refreshedAtMs - check.startedAtMs;
+            check.elapsedMs = Number.isFinite(elapsedMs) && elapsedMs >= 0 ? elapsedMs : 0;
+        }
+    }
+    requirePrepared() {
+        if (this.preparedTotal === undefined) {
+            throw new Error("Progress feedback arrived before preparation");
+        }
+        return this.preparedTotal;
+    }
+}
+//# sourceMappingURL=renderer-lifecycle.mjs.map

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

@@ -0,0 +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 {\n  formatFinalSummary,\n  formatRunningRow,\n  formatSettledBlock,\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 preparedTotal: number | undefined;\n  private renderedRunningRows = 0;\n  private readonly running: RunningCheck[] = [];\n  private readonly usesColor: boolean;\n\n  constructor(writer: ProgressWriter, clock: ProgressClock) {\n    this.writer = writer;\n    this.clock = clock;\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 \"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 (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          totalChecks,\n          usesColor: this.usesColor\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.writer.write(formatFinalSummary(feedback));\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"]}

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

@@ -0,0 +1,12 @@
+import { ProgressRendererController } from "./renderer-lifecycle.mjs";
+const SYSTEM_PROGRESS_CLOCK = Object.freeze({ now: () => performance.now() });
+/** Product-private lifecycle presentation with one owner for feedback and its writer. */
+export function createProgressRenderer(writer, clock = SYSTEM_PROGRESS_CLOCK) {
+    const controller = new ProgressRendererController(writer, clock);
+    return Object.freeze({
+        refreshesRunningRegion: controller.refreshesRunningRegion,
+        refresh: () => controller.refresh(),
+        render: (feedback) => controller.render(feedback)
+    });
+}
+//# sourceMappingURL=renderer.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAqDrE,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;IAE5C,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjE,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 { ProgressRendererController } from \"./renderer-lifecycle.ts\";\n\nexport interface ProgressWriter {\n  readonly color: boolean;\n  readonly isTTY: boolean;\n  readonly term: string | undefined;\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: \"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    }\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): ProgressRenderer {\n  const controller = new ProgressRendererController(writer, clock);\n  return Object.freeze({\n    refreshesRunningRegion: controller.refreshesRunningRegion,\n    refresh: (): void => controller.refresh(),\n    render: (feedback: ProgressFeedback): void => controller.render(feedback)\n  });\n}\n"]}

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

@@ -0,0 +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 ?? [])]),
+        root: input.root
+    });
+}
+//# sourceMappingURL=project-context.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.mjs","sourceRoot":"","sources":["../../../src/project-run/project-context.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAClC,KAA0E;IAE1E,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,IAAI;KACjB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext } from \"../check/check.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\n/** Materializes only invocation-wide callback input; Check-local options own domain configuration. */\nexport function createProjectContext(\n  input: Readonly<{ readonly controls: RunControls; readonly root: string }>\n): CheckProjectContext {\n  return Object.freeze({\n    flags: Object.freeze([...(input.controls.flags ?? [])]),\n    root: input.root\n  });\n}\n"]}

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

@@ -0,0 +1,54 @@
+export function outputFailure(declarativeFingerprint, definitionWarnings, outputs, output, facts) {
+    return Object.freeze({
+        kind: "output",
+        declarativeFingerprint,
+        definitionWarnings,
+        diagnostic: Object.freeze({ code: outputDiagnosticCode(output) }),
+        outputs,
+        ...facts
+    });
+}
+function outputDiagnosticCode(output) {
+    switch (output) {
+        case "machinePublication":
+            return "machine-publication-failed";
+        case "progressRendering":
+            return "progress-rendering-failed";
+        case "diagnosticLogging":
+            return "diagnostic-logging-failed";
+    }
+}
+export function isCancelled(controls) {
+    return controls.signal?.aborted === true;
+}
+export function planning(declarativeFingerprint, definitionWarnings, outputs, code) {
+    return Object.freeze({
+        kind: "planning",
+        declarativeFingerprint,
+        definitionWarnings,
+        diagnostic: Object.freeze({ code }),
+        outputs
+    });
+}
+export function preExecutionCancellation(declarativeFingerprint, definitionWarnings, outputs, phase) {
+    return Object.freeze({
+        kind: "cancelled",
+        declarativeFingerprint,
+        definitionWarnings,
+        outputs,
+        phase
+    });
+}
+export function executionCancellation(input) {
+    return Object.freeze({
+        kind: "cancelled",
+        declarativeFingerprint: input.declarativeFingerprint,
+        definitionWarnings: input.definitionWarnings,
+        outputs: input.outputs,
+        phase: "execution",
+        checkDurations: input.checkDurations,
+        checkMessages: input.checkMessages,
+        snapshot: input.snapshot
+    });
+}
+//# sourceMappingURL=result.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../src/project-run/result.ts"],"names":[],"mappings":"AA2FA,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;IACvC,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 \"./output-status.ts\";\nexport type RunDiagnostic = Readonly<{\n  readonly code: \"task-graph-invalid\" | \"task-engine-failed\" | \"publication-model-failed\";\n}>;\nexport type CheckDuration = Readonly<{\n  readonly checkId: string;\n  readonly durationMs: number | null;\n}>;\nexport interface CheckRunMessage {\n  readonly checkId: string;\n  readonly level: CheckMessageLevel;\n  readonly code: string;\n  readonly message: string;\n}\nexport interface RunResultFacts {\n  readonly aggregate: CheckAggregate | null;\n  readonly checkDurations: readonly CheckDuration[];\n  readonly checkMessages: readonly CheckRunMessage[];\n  readonly snapshot: CoreSnapshot;\n}\n/** 一次 Project Run 的可判别结果；output failure 保留已结算 facts。 */\nexport type RunResult = Readonly<\n  | {\n      readonly kind: \"configuration\";\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: ProjectDefinitionDiagnostic | RunControlDiagnostic;\n    }\n  | {\n      readonly kind: \"planning\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | {\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      readonly phase: \"pre-work\" | \"planning\";\n    }\n  | {\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      readonly phase: \"execution\";\n      readonly checkDurations: readonly CheckDuration[];\n      readonly checkMessages: readonly CheckRunMessage[];\n      readonly snapshot: CoreSnapshot;\n    }\n  | ({\n      readonly kind: \"completed\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n  | {\n      readonly kind: \"execution\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | ({\n      readonly kind: \"output\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: Readonly<{\n        readonly code:\n          | \"machine-publication-failed\"\n          | \"progress-rendering-failed\"\n          | \"diagnostic-logging-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  }\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

@@ -0,0 +1,23 @@
+import { validateProjectDefinition } from "../project-definition/project-definition-validation.mjs";
+import { validateRunControls } from "./controls/validation.mjs";
+import { executeValidatedRun } from "./invocation.mjs";
+export async function run(definition, controls = {}) {
+    const validatedDefinition = validateProjectDefinition(definition);
+    if (!validatedDefinition.ok) {
+        return Object.freeze({
+            kind: "configuration",
+            definitionWarnings: Object.freeze([]),
+            diagnostic: validatedDefinition.error
+        });
+    }
+    const validatedControls = validateRunControls(controls);
+    if (!validatedControls.ok) {
+        return Object.freeze({
+            kind: "configuration",
+            definitionWarnings: Object.freeze([]),
+            diagnostic: validatedControls.error
+        });
+    }
+    return executeValidatedRun(validatedDefinition.value, validatedControls.value, validatedDefinition.warnings);
+}
+//# sourceMappingURL=run.mjs.map

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

@@ -0,0 +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,iBAAiB,CAAC;AAsBtD,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.ts\";\nimport type { RunResult } from \"./result.ts\";\n\nexport type { RunOutputStatus, RunOutputStatuses } from \"./output-status.ts\";\nexport type { RunDiagnostic, RunResult } from \"./result.ts\";\n\n/**\n * 在调用方的 Bun 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 组成 invocation execution barrier，\n * 并在 execution callback、dependency resolver 或 scanner 前完成。`output` branch 同时提供完整 final\n * 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"]}

package/dist/esm/project-run/task-scheduler/execution-state.mjs

@@ -0,0 +1,66 @@
+export function createSchedulerState(graph, options) {
+    const scopesById = new Map();
+    for (const scope of graph.scopes) {
+        scopesById.set(scope.id, {
+            scope,
+            activationTaskIds: new Set(scope.activationTaskIds),
+            isActive: false
+        });
+    }
+    return {
+        diagnosticLogger: options.diagnosticLogger,
+        graph,
+        maxParallel: options.maxParallel,
+        signal: options.signal,
+        execute: options.execute,
+        pending: [...graph.tasks],
+        runningById: new Map(),
+        runningMutexes: new Set(),
+        settlementsByTaskId: new Map(),
+        scopesById,
+        reservationTaskId: undefined,
+        isCancelled: false
+    };
+}
+/** Projects mutable execution state into the pure scheduler-decision input. */
+export function snapshotSchedulerState(state) {
+    return Object.freeze({
+        activeScopeIds: Object.freeze([...state.scopesById.values()]
+            .filter((scope) => scope.isActive)
+            .map((scope) => scope.scope.id)),
+        graph: state.graph,
+        isAbortRequested: state.signal?.aborted === true,
+        isCancelled: state.isCancelled,
+        maxParallel: state.maxParallel,
+        pendingTaskIds: Object.freeze(state.pending.map((task) => task.id)),
+        reservationTaskId: state.reservationTaskId,
+        runningMutexes: Object.freeze([...state.runningMutexes]),
+        runningTaskIds: Object.freeze([...state.runningById.keys()]),
+        settledTasks: Object.freeze([...state.settlementsByTaskId].map(([taskId, settlement]) => Object.freeze({ kind: settlement.kind, taskId })))
+    });
+}
+export function scopeForTask(task, state) {
+    return task.scopeId === undefined ? undefined : state.scopesById.get(task.scopeId);
+}
+export function cancelPendingTasks(state) {
+    state.isCancelled = true;
+    state.reservationTaskId = undefined;
+    while (state.pending.length > 0) {
+        const task = state.pending.shift();
+        if (task === undefined) {
+            throw new Error("task graph pending queue changed unexpectedly");
+        }
+        recordSettlement(state, task, Object.freeze({ kind: "cancelled-before-start" }));
+    }
+}
+export function recordSettlement(state, task, settlement) {
+    if (state.settlementsByTaskId.has(task.id)) {
+        throw new Error(`task ${task.id} settled more than once`);
+    }
+    state.settlementsByTaskId.set(task.id, settlement);
+    const scope = scopeForTask(task, state);
+    if (scope?.scope.terminalTaskId === task.id) {
+        scope.isActive = false;
+    }
+}
+//# sourceMappingURL=execution-state.mjs.map