readyup 0.0.0 → 0.13.0

package/dist/esm/reportPreflight.js

@@ -0,0 +1,105 @@
+import { meetsThreshold } from "./runPreflight.js";
+import { isPercentProgress } from "./types.js";
+const ICON_PASSED = "\u{1F7E2}";
+const ICON_ERROR_FAILED = "\u{1F534}";
+const ICON_WARN_FAILED = "\u{1F7E0}";
+const ICON_RECOMMEND_FAILED = "\u{1F7E1}";
+const ICON_SKIPPED_NA = "\u26AA";
+const ICON_SKIPPED_PRECONDITION = "\u26D4";
+const ICON_FIX = "\u{1F48A}";
+function formatDuration(ms) {
+  return `${Math.round(ms)}ms`;
+}
+function getIcon(result) {
+  if (result.status === "passed") return ICON_PASSED;
+  if (result.status === "skipped") {
+    return result.skipReason === "precondition" ? ICON_SKIPPED_PRECONDITION : ICON_SKIPPED_NA;
+  }
+  if (result.severity === "warn") return ICON_WARN_FAILED;
+  if (result.severity === "recommend") return ICON_RECOMMEND_FAILED;
+  return ICON_ERROR_FAILED;
+}
+function formatProgress(progress) {
+  if (isPercentProgress(progress)) {
+    return `${progress.percent}%`;
+  }
+  return `${progress.passedCount} of ${progress.count}`;
+}
+function formatSummaryCounts(passed, failed, skipped) {
+  const parts = [];
+  if (passed > 0) parts.push(`${ICON_PASSED} ${passed} passed`);
+  if (failed > 0) parts.push(`${ICON_ERROR_FAILED} ${failed} failed`);
+  if (skipped > 0) parts.push(`${ICON_SKIPPED_PRECONDITION} ${skipped} skipped`);
+  return parts.join(", ");
+}
+function collectInlineDetails(result, includeFix) {
+  const details = [];
+  if (result.error !== null) {
+    details.push(`  Error: ${result.error.message}`);
+  }
+  if (includeFix && result.fix !== null) {
+    details.push(`  ${ICON_FIX} Fix: ${result.fix}`);
+  }
+  return details;
+}
+function* iterateWithNaSuppression(results) {
+  let suppressBelowDepth = null;
+  for (const result of results) {
+    if (suppressBelowDepth !== null) {
+      if (result.depth > suppressBelowDepth) continue;
+      suppressBelowDepth = null;
+    }
+    if (result.status === "skipped" && result.skipReason === "n/a") {
+      suppressBelowDepth = result.depth;
+    }
+    yield result;
+  }
+}
+function countResults(results) {
+  let passed = 0;
+  let failed = 0;
+  let skipped = 0;
+  for (const r of iterateWithNaSuppression(results)) {
+    if (r.status === "passed") passed++;
+    else if (r.status === "failed") failed++;
+    else skipped++;
+  }
+  return { passed, failed, skipped };
+}
+function reportPreflight(report, options) {
+  const fixLocation = options?.fixLocation ?? "end";
+  const reportOn = options?.reportOn ?? "recommend";
+  const lines = [];
+  const collectedFixes = [];
+  const visibleResults = report.results.filter((r) => meetsThreshold(r.severity, reportOn));
+  for (const result of iterateWithNaSuppression(visibleResults)) {
+    const indent = "  ".repeat(result.depth);
+    const icon = getIcon(result);
+    let checkLine = `${indent}${icon} ${result.name} (${formatDuration(result.durationMs)})`;
+    if (result.detail !== null) {
+      checkLine += ` \u2014 ${result.detail}`;
+    }
+    if (result.progress !== null) {
+      checkLine += ` \u2014 ${formatProgress(result.progress)}`;
+    }
+    lines.push(checkLine);
+    if (result.status === "failed") {
+      const includeFix = fixLocation === "inline";
+      const details = collectInlineDetails(result, includeFix);
+      lines.push(...details.map((line) => `${indent}${line}`));
+      if (!includeFix && result.fix !== null) {
+        collectedFixes.push(result.fix);
+      }
+    }
+  }
+  const { passed, failed, skipped } = countResults(visibleResults);
+  lines.push("", `${formatSummaryCounts(passed, failed, skipped)} (${formatDuration(report.durationMs)})`);
+  if (fixLocation === "end" && collectedFixes.length > 0) {
+    lines.push("", "Fixes:", ...collectedFixes.map((fix) => `  ${ICON_FIX} ${fix}`));
+  }
+  return lines.join("\n");
+}
+export {
+  formatSummaryCounts,
+  reportPreflight
+};

package/dist/esm/reportRdy.d.ts

@@ -0,0 +1,7 @@
+import type { FixLocation, RdyReport, Severity } from './types.ts';
+export interface ReportRdyOptions {
+    fixLocation?: FixLocation;
+    reportOn?: Severity;
+}
+export declare function formatSummaryCounts(passed: number, failed: number, skipped: number): string;
+export declare function reportRdy(report: RdyReport, options?: ReportRdyOptions): string;

package/dist/esm/reportRdy.js

@@ -0,0 +1,105 @@
+import { meetsThreshold } from "./runRdy.js";
+import { isPercentProgress } from "./types.js";
+const ICON_PASSED = "\u{1F7E2}";
+const ICON_ERROR_FAILED = "\u{1F534}";
+const ICON_WARN_FAILED = "\u{1F7E0}";
+const ICON_RECOMMEND_FAILED = "\u{1F7E1}";
+const ICON_SKIPPED_NA = "\u26AA";
+const ICON_SKIPPED_PRECONDITION = "\u26D4";
+const ICON_FIX = "\u{1F48A}";
+function formatDuration(ms) {
+  return `${Math.round(ms)}ms`;
+}
+function getIcon(result) {
+  if (result.status === "passed") return ICON_PASSED;
+  if (result.status === "skipped") {
+    return result.skipReason === "precondition" ? ICON_SKIPPED_PRECONDITION : ICON_SKIPPED_NA;
+  }
+  if (result.severity === "warn") return ICON_WARN_FAILED;
+  if (result.severity === "recommend") return ICON_RECOMMEND_FAILED;
+  return ICON_ERROR_FAILED;
+}
+function formatProgress(progress) {
+  if (isPercentProgress(progress)) {
+    return `${progress.percent}%`;
+  }
+  return `${progress.passedCount} of ${progress.count}`;
+}
+function formatSummaryCounts(passed, failed, skipped) {
+  const parts = [];
+  if (passed > 0) parts.push(`${ICON_PASSED} ${passed} passed`);
+  if (failed > 0) parts.push(`${ICON_ERROR_FAILED} ${failed} failed`);
+  if (skipped > 0) parts.push(`${ICON_SKIPPED_PRECONDITION} ${skipped} skipped`);
+  return parts.join(", ");
+}
+function collectInlineDetails(result, includeFix) {
+  const details = [];
+  if (result.error !== null) {
+    details.push(`  Error: ${result.error.message}`);
+  }
+  if (includeFix && result.fix !== null) {
+    details.push(`  ${ICON_FIX} Fix: ${result.fix}`);
+  }
+  return details;
+}
+function* iterateWithNaSuppression(results) {
+  let suppressBelowDepth = null;
+  for (const result of results) {
+    if (suppressBelowDepth !== null) {
+      if (result.depth > suppressBelowDepth) continue;
+      suppressBelowDepth = null;
+    }
+    if (result.status === "skipped" && result.skipReason === "n/a") {
+      suppressBelowDepth = result.depth;
+    }
+    yield result;
+  }
+}
+function countResults(results) {
+  let passed = 0;
+  let failed = 0;
+  let skipped = 0;
+  for (const r of iterateWithNaSuppression(results)) {
+    if (r.status === "passed") passed++;
+    else if (r.status === "failed") failed++;
+    else skipped++;
+  }
+  return { passed, failed, skipped };
+}
+function reportRdy(report, options) {
+  const fixLocation = options?.fixLocation ?? "end";
+  const reportOn = options?.reportOn ?? "recommend";
+  const lines = [];
+  const collectedFixes = [];
+  const visibleResults = report.results.filter((r) => meetsThreshold(r.severity, reportOn));
+  for (const result of iterateWithNaSuppression(visibleResults)) {
+    const indent = "  ".repeat(result.depth);
+    const icon = getIcon(result);
+    let checkLine = `${indent}${icon} ${result.name} (${formatDuration(result.durationMs)})`;
+    if (result.detail !== null) {
+      checkLine += ` \u2014 ${result.detail}`;
+    }
+    if (result.progress !== null) {
+      checkLine += ` \u2014 ${formatProgress(result.progress)}`;
+    }
+    lines.push(checkLine);
+    if (result.status === "failed") {
+      const includeFix = fixLocation === "inline";
+      const details = collectInlineDetails(result, includeFix);
+      lines.push(...details.map((line) => `${indent}${line}`));
+      if (!includeFix && result.fix !== null) {
+        collectedFixes.push(result.fix);
+      }
+    }
+  }
+  const { passed, failed, skipped } = countResults(visibleResults);
+  lines.push("", `${formatSummaryCounts(passed, failed, skipped)} (${formatDuration(report.durationMs)})`);
+  if (fixLocation === "end" && collectedFixes.length > 0) {
+    lines.push("", "Fixes:", ...collectedFixes.map((fix) => `  ${ICON_FIX} ${fix}`));
+  }
+  return lines.join("\n");
+}
+export {
+  formatSummaryCounts,
+  reportRdy
+};

package/dist/esm/resolveCollectionExports.d.ts

@@ -0,0 +1 @@
+export declare function resolveCollectionExports(moduleRecord: Record<string, unknown>): Record<string, unknown>;

package/dist/esm/resolveCollectionExports.js

@@ -0,0 +1,20 @@
+import { isRecord } from "./isRecord.js";
+function resolveCollectionExports(moduleRecord) {
+  const source = isRecord(moduleRecord.default) ? moduleRecord.default : moduleRecord;
+  if (source.checklists === void 0) {
+    throw new Error(
+      "Collection file must export checklists (e.g., `export default definePreflightCollection({ checklists: [...] })` or `export const checklists = [...]`)"
+    );
+  }
+  return {
+    checklists: source.checklists,
+    ...source.defaultSeverity !== void 0 && { defaultSeverity: source.defaultSeverity },
+    ...source.failOn !== void 0 && { failOn: source.failOn },
+    ...source.fixLocation !== void 0 && { fixLocation: source.fixLocation },
+    ...source.reportOn !== void 0 && { reportOn: source.reportOn },
+    ...source.suites !== void 0 && { suites: source.suites }
+  };
+}
+export {
+  resolveCollectionExports
+};

package/dist/esm/resolveGitHubToken.d.ts

@@ -0,0 +1 @@
+export declare function resolveGitHubToken(): string | undefined;

package/dist/esm/resolveGitHubToken.js

@@ -0,0 +1,22 @@
+import { execFileSync } from "node:child_process";
+function resolveGitHubToken() {
+  const envToken = process.env.GITHUB_TOKEN;
+  if (envToken !== void 0 && envToken !== "") {
+    return envToken;
+  }
+  try {
+    const output = execFileSync("gh", ["auth", "token"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const trimmed = output.trim();
+    if (trimmed !== "") {
+      return trimmed;
+    }
+  } catch {
+  }
+  return void 0;
+}
+export {
+  resolveGitHubToken
+};

package/dist/esm/resolveKitExports.d.ts

@@ -0,0 +1 @@
+export declare function resolveKitExports(moduleRecord: Record<string, unknown>): Record<string, unknown>;

package/dist/esm/resolveKitExports.js

@@ -0,0 +1,20 @@
+import { isRecord } from "./isRecord.js";
+function resolveKitExports(moduleRecord) {
+  const source = isRecord(moduleRecord.default) ? moduleRecord.default : moduleRecord;
+  if (source.checklists === void 0) {
+    throw new Error(
+      "Kit file must export checklists (e.g., `export default defineRdyKit({ checklists: [...] })` or `export const checklists = [...]`)"
+    );
+  }
+  return {
+    checklists: source.checklists,
+    ...source.defaultSeverity !== void 0 && { defaultSeverity: source.defaultSeverity },
+    ...source.failOn !== void 0 && { failOn: source.failOn },
+    ...source.fixLocation !== void 0 && { fixLocation: source.fixLocation },
+    ...source.reportOn !== void 0 && { reportOn: source.reportOn },
+    ...source.suites !== void 0 && { suites: source.suites }
+  };
+}
+export {
+  resolveKitExports
+};

package/dist/esm/resolveRequestedNames.d.ts

@@ -0,0 +1,2 @@
+import type { RdyKit } from './types.ts';
+export declare function resolveRequestedNames(requestedNames: string[], kit: RdyKit): string[];

package/dist/esm/resolveRequestedNames.js

@@ -0,0 +1,38 @@
+function resolveRequestedNames(requestedNames, kit) {
+  if (requestedNames.length === 0) {
+    return kit.checklists.map((c) => c.name);
+  }
+  const checklistNames = new Set(kit.checklists.map((c) => c.name));
+  const suites = kit.suites ?? {};
+  const unknownNames = [];
+  const resolved = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const name of requestedNames) {
+    const suiteEntries = suites[name];
+    if (suiteEntries !== void 0) {
+      for (const entry of suiteEntries) {
+        if (!seen.has(entry)) {
+          seen.add(entry);
+          resolved.push(entry);
+        }
+      }
+    } else if (checklistNames.has(name)) {
+      if (!seen.has(name)) {
+        seen.add(name);
+        resolved.push(name);
+      }
+    } else {
+      unknownNames.push(name);
+    }
+  }
+  if (unknownNames.length > 0) {
+    const checklistList = [...checklistNames].join(", ");
+    const suiteNames = Object.keys(suites);
+    const suiteList = suiteNames.length > 0 ? `. Suites: ${suiteNames.join(", ")}` : "";
+    throw new Error(`Unknown name(s): ${unknownNames.join(", ")}. Checklists: ${checklistList}${suiteList}`);
+  }
+  return resolved;
+}
+export {
+  resolveRequestedNames
+};

package/dist/esm/runPreflight.d.ts

@@ -0,0 +1,7 @@
+import type { PreflightChecklist, PreflightReport, PreflightStagedChecklist, Severity } from './types.ts';
+export interface RunPreflightOptions {
+    defaultSeverity?: Severity;
+    failOn?: Severity;
+}
+export declare function meetsThreshold(severity: Severity, threshold: Severity): boolean;
+export declare function runPreflight(checklist: PreflightChecklist | PreflightStagedChecklist, options?: RunPreflightOptions): Promise<PreflightReport>;

package/dist/esm/runPreflight.js

@@ -0,0 +1,157 @@
+import { performance } from "node:perf_hooks";
+import { isFlatChecklist } from "./types.js";
+const SEVERITY_RANK = {
+  error: 0,
+  warn: 1,
+  recommend: 2
+};
+function meetsThreshold(severity, threshold) {
+  return SEVERITY_RANK[severity] <= SEVERITY_RANK[threshold];
+}
+function resolveSeverity(check, defaultSeverity) {
+  return check.severity ?? defaultSeverity;
+}
+function buildPassedResult(name, severity, durationMs, detail, fix, progress, depth = 0) {
+  return { name, status: "passed", ok: true, severity, detail, fix, error: null, progress, durationMs, depth };
+}
+function buildFailedResult(name, severity, durationMs, detail, fix, error, progress, depth = 0) {
+  return { name, status: "failed", ok: false, severity, detail, fix, error, progress, durationMs, depth };
+}
+function buildSkippedResult(name, severity, skipReason, detail, fix, depth = 0) {
+  return {
+    name,
+    status: "skipped",
+    ok: null,
+    severity,
+    skipReason,
+    detail,
+    fix,
+    error: null,
+    progress: null,
+    durationMs: 0,
+    depth
+  };
+}
+async function executeCheck(check, defaultSeverity, depth = 0) {
+  const severity = resolveSeverity(check, defaultSeverity);
+  const fix = check.fix ?? null;
+  const children = check.checks ?? [];
+  if (check.skip !== void 0) {
+    const start2 = performance.now();
+    try {
+      const skipResult = await check.skip();
+      if (typeof skipResult === "string") {
+        const result = buildSkippedResult(check.name, severity, "n/a", skipResult, fix, depth);
+        const childResults = skipAllDescendants(children, defaultSeverity, "n/a", depth + 1);
+        return [result, ...childResults];
+      }
+    } catch (error_) {
+      const durationMs = performance.now() - start2;
+      const error = error_ instanceof Error ? error_ : new Error(String(error_));
+      const result = buildFailedResult(check.name, severity, durationMs, null, fix, error, null, depth);
+      const childResults = skipAllDescendants(children, defaultSeverity, "precondition", depth + 1);
+      return [result, ...childResults];
+    }
+  }
+  const start = performance.now();
+  try {
+    const raw = await check.check();
+    const durationMs = performance.now() - start;
+    let result;
+    if (typeof raw === "boolean") {
+      result = raw ? buildPassedResult(check.name, severity, durationMs, null, fix, null, depth) : buildFailedResult(check.name, severity, durationMs, null, fix, null, null, depth);
+    } else {
+      const detail = raw.detail ?? null;
+      const progress = raw.progress ?? null;
+      result = raw.ok ? buildPassedResult(check.name, severity, durationMs, detail, fix, progress, depth) : buildFailedResult(check.name, severity, durationMs, detail, fix, null, progress, depth);
+    }
+    const childResults = await collectChildResults(result, children, defaultSeverity, depth + 1);
+    return [result, ...childResults];
+  } catch (error_) {
+    const durationMs = performance.now() - start;
+    const error = error_ instanceof Error ? error_ : new Error(String(error_));
+    const result = buildFailedResult(check.name, severity, durationMs, null, fix, error, null, depth);
+    const childResults = skipAllDescendants(children, defaultSeverity, "precondition", depth + 1);
+    return [result, ...childResults];
+  }
+}
+async function collectChildResults(parentResult, children, defaultSeverity, childDepth) {
+  if (children.length === 0) return [];
+  if (parentResult.status === "failed") {
+    return skipAllDescendants(children, defaultSeverity, "precondition", childDepth);
+  }
+  if (parentResult.status === "skipped") {
+    const reason = parentResult.skipReason === "n/a" ? "n/a" : "precondition";
+    return skipAllDescendants(children, defaultSeverity, reason, childDepth);
+  }
+  return runSiblingChecks(children, defaultSeverity, childDepth);
+}
+async function runSiblingChecks(checks, defaultSeverity, depth) {
+  const siblingTrees = await Promise.all(checks.map((c) => executeCheck(c, defaultSeverity, depth)));
+  return siblingTrees.flat();
+}
+function skipAllDescendants(checks, defaultSeverity, skipReason, depth) {
+  const results = [];
+  for (const check of checks) {
+    results.push(skipCheck(check, defaultSeverity, skipReason, depth));
+    if (check.checks !== void 0 && check.checks.length > 0) {
+      results.push(...skipAllDescendants(check.checks, defaultSeverity, skipReason, depth + 1));
+    }
+  }
+  return results;
+}
+function skipCheck(check, defaultSeverity, skipReason = "precondition", depth = 0) {
+  const severity = resolveSeverity(check, defaultSeverity);
+  return buildSkippedResult(check.name, severity, skipReason, null, check.fix ?? null, depth);
+}
+async function runPreconditions(preconditions, results, defaultSeverity) {
+  if (preconditions.length === 0) return true;
+  const trees = await Promise.all(preconditions.map((c) => executeCheck(c, defaultSeverity)));
+  const flat = trees.flat();
+  results.push(...flat);
+  return flat.filter((r) => r.depth === 0).every((r) => r.status === "passed");
+}
+async function runFlatChecks(checklist, results, preconditionsPassed, defaultSeverity) {
+  if (!preconditionsPassed) {
+    results.push(...skipAllDescendants(checklist.checks, defaultSeverity, "precondition", 0));
+    return;
+  }
+  const checkResults = await runSiblingChecks(checklist.checks, defaultSeverity, 0);
+  results.push(...checkResults);
+}
+async function runStagedChecks(checklist, results, preconditionsPassed, defaultSeverity, failOn) {
+  if (!preconditionsPassed) {
+    for (const group of checklist.groups) {
+      results.push(...skipAllDescendants(group, defaultSeverity, "precondition", 0));
+    }
+    return;
+  }
+  let shouldSkipRemaining = false;
+  for (const group of checklist.groups) {
+    if (shouldSkipRemaining) {
+      results.push(...skipAllDescendants(group, defaultSeverity, "precondition", 0));
+      continue;
+    }
+    const groupResults = await runSiblingChecks(group, defaultSeverity, 0);
+    results.push(...groupResults);
+    const topLevelFailed = groupResults.filter((r) => r.depth === 0).some((r) => r.status === "failed" && meetsThreshold(r.severity, failOn));
+    if (topLevelFailed) {
+      shouldSkipRemaining = true;
+    }
+  }
+}
+async function runPreflight(checklist, options = {}) {
+  const defaultSeverity = options.defaultSeverity ?? "error";
+  const failOn = options.failOn ?? "error";
+  const start = performance.now();
+  const results = [];
+  const preconditionsPassed = await runPreconditions(checklist.preconditions ?? [], results, defaultSeverity);
+  await (isFlatChecklist(checklist) ? runFlatChecks(checklist, results, preconditionsPassed, defaultSeverity) : runStagedChecks(checklist, results, preconditionsPassed, defaultSeverity, failOn));
+  const durationMs = performance.now() - start;
+  const passed = !results.some((r) => r.status === "failed" && meetsThreshold(r.severity, failOn));
+  return { results, passed, durationMs };
+}
+export {
+  meetsThreshold,
+  runPreflight
+};

package/dist/esm/runRdy.d.ts

@@ -0,0 +1,7 @@
+import type { RdyChecklist, RdyReport, RdyStagedChecklist, Severity } from './types.ts';
+export interface RunRdyOptions {
+    defaultSeverity?: Severity;
+    failOn?: Severity;
+}
+export declare function meetsThreshold(severity: Severity, threshold: Severity): boolean;
+export declare function runRdy(checklist: RdyChecklist | RdyStagedChecklist, options?: RunRdyOptions): Promise<RdyReport>;

package/dist/esm/runRdy.js

@@ -0,0 +1,157 @@
+import { performance } from "node:perf_hooks";
+import { isFlatChecklist } from "./types.js";
+const SEVERITY_RANK = {
+  error: 0,
+  warn: 1,
+  recommend: 2
+};
+function meetsThreshold(severity, threshold) {
+  return SEVERITY_RANK[severity] <= SEVERITY_RANK[threshold];
+}
+function resolveSeverity(check, defaultSeverity) {
+  return check.severity ?? defaultSeverity;
+}
+function buildPassedResult(name, severity, durationMs, detail, fix, progress, depth = 0) {
+  return { name, status: "passed", ok: true, severity, detail, fix, error: null, progress, durationMs, depth };
+}
+function buildFailedResult(name, severity, durationMs, detail, fix, error, progress, depth = 0) {
+  return { name, status: "failed", ok: false, severity, detail, fix, error, progress, durationMs, depth };
+}
+function buildSkippedResult(name, severity, skipReason, detail, fix, depth = 0) {
+  return {
+    name,
+    status: "skipped",
+    ok: null,
+    severity,
+    skipReason,
+    detail,
+    fix,
+    error: null,
+    progress: null,
+    durationMs: 0,
+    depth
+  };
+}
+async function executeCheck(check, defaultSeverity, depth = 0) {
+  const severity = resolveSeverity(check, defaultSeverity);
+  const fix = check.fix ?? null;
+  const children = check.checks ?? [];
+  if (check.skip !== void 0) {
+    const start2 = performance.now();
+    try {
+      const skipResult = await check.skip();
+      if (typeof skipResult === "string") {
+        const result = buildSkippedResult(check.name, severity, "n/a", skipResult, fix, depth);
+        const childResults = skipAllDescendants(children, defaultSeverity, "n/a", depth + 1);
+        return [result, ...childResults];
+      }
+    } catch (error_) {
+      const durationMs = performance.now() - start2;
+      const error = error_ instanceof Error ? error_ : new Error(String(error_));
+      const result = buildFailedResult(check.name, severity, durationMs, null, fix, error, null, depth);
+      const childResults = skipAllDescendants(children, defaultSeverity, "precondition", depth + 1);
+      return [result, ...childResults];
+    }
+  }
+  const start = performance.now();
+  try {
+    const raw = await check.check();
+    const durationMs = performance.now() - start;
+    let result;
+    if (typeof raw === "boolean") {
+      result = raw ? buildPassedResult(check.name, severity, durationMs, null, fix, null, depth) : buildFailedResult(check.name, severity, durationMs, null, fix, null, null, depth);
+    } else {
+      const detail = raw.detail ?? null;
+      const progress = raw.progress ?? null;
+      result = raw.ok ? buildPassedResult(check.name, severity, durationMs, detail, fix, progress, depth) : buildFailedResult(check.name, severity, durationMs, detail, fix, null, progress, depth);
+    }
+    const childResults = await collectChildResults(result, children, defaultSeverity, depth + 1);
+    return [result, ...childResults];
+  } catch (error_) {
+    const durationMs = performance.now() - start;
+    const error = error_ instanceof Error ? error_ : new Error(String(error_));
+    const result = buildFailedResult(check.name, severity, durationMs, null, fix, error, null, depth);
+    const childResults = skipAllDescendants(children, defaultSeverity, "precondition", depth + 1);
+    return [result, ...childResults];
+  }
+}
+async function collectChildResults(parentResult, children, defaultSeverity, childDepth) {
+  if (children.length === 0) return [];
+  if (parentResult.status === "failed") {
+    return skipAllDescendants(children, defaultSeverity, "precondition", childDepth);
+  }
+  if (parentResult.status === "skipped") {
+    const reason = parentResult.skipReason === "n/a" ? "n/a" : "precondition";
+    return skipAllDescendants(children, defaultSeverity, reason, childDepth);
+  }
+  return runSiblingChecks(children, defaultSeverity, childDepth);
+}
+async function runSiblingChecks(checks, defaultSeverity, depth) {
+  const siblingTrees = await Promise.all(checks.map((c) => executeCheck(c, defaultSeverity, depth)));
+  return siblingTrees.flat();
+}
+function skipAllDescendants(checks, defaultSeverity, skipReason, depth) {
+  const results = [];
+  for (const check of checks) {
+    results.push(skipCheck(check, defaultSeverity, skipReason, depth));
+    if (check.checks !== void 0 && check.checks.length > 0) {
+      results.push(...skipAllDescendants(check.checks, defaultSeverity, skipReason, depth + 1));
+    }
+  }
+  return results;
+}
+function skipCheck(check, defaultSeverity, skipReason = "precondition", depth = 0) {
+  const severity = resolveSeverity(check, defaultSeverity);
+  return buildSkippedResult(check.name, severity, skipReason, null, check.fix ?? null, depth);
+}
+async function runPreconditions(preconditions, results, defaultSeverity) {
+  if (preconditions.length === 0) return true;
+  const trees = await Promise.all(preconditions.map((c) => executeCheck(c, defaultSeverity)));
+  const flat = trees.flat();
+  results.push(...flat);
+  return flat.filter((r) => r.depth === 0).every((r) => r.status === "passed");
+}
+async function runFlatChecks(checklist, results, preconditionsPassed, defaultSeverity) {
+  if (!preconditionsPassed) {
+    results.push(...skipAllDescendants(checklist.checks, defaultSeverity, "precondition", 0));
+    return;
+  }
+  const checkResults = await runSiblingChecks(checklist.checks, defaultSeverity, 0);
+  results.push(...checkResults);
+}
+async function runStagedChecks(checklist, results, preconditionsPassed, defaultSeverity, failOn) {
+  if (!preconditionsPassed) {
+    for (const group of checklist.groups) {
+      results.push(...skipAllDescendants(group, defaultSeverity, "precondition", 0));
+    }
+    return;
+  }
+  let shouldSkipRemaining = false;
+  for (const group of checklist.groups) {
+    if (shouldSkipRemaining) {
+      results.push(...skipAllDescendants(group, defaultSeverity, "precondition", 0));
+      continue;
+    }
+    const groupResults = await runSiblingChecks(group, defaultSeverity, 0);
+    results.push(...groupResults);
+    const topLevelFailed = groupResults.filter((r) => r.depth === 0).some((r) => r.status === "failed" && meetsThreshold(r.severity, failOn));
+    if (topLevelFailed) {
+      shouldSkipRemaining = true;
+    }
+  }
+}
+async function runRdy(checklist, options = {}) {
+  const defaultSeverity = options.defaultSeverity ?? "error";
+  const failOn = options.failOn ?? "error";
+  const start = performance.now();
+  const results = [];
+  const preconditionsPassed = await runPreconditions(checklist.preconditions ?? [], results, defaultSeverity);
+  await (isFlatChecklist(checklist) ? runFlatChecks(checklist, results, preconditionsPassed, defaultSeverity) : runStagedChecks(checklist, results, preconditionsPassed, defaultSeverity, failOn));
+  const durationMs = performance.now() - start;
+  const passed = !results.some((r) => r.status === "failed" && meetsThreshold(r.severity, failOn));
+  return { results, passed, durationMs };
+}
+export {
+  meetsThreshold,
+  runRdy
+};

package/dist/esm/terminal.d.ts

@@ -0,0 +1,6 @@
+import type { WriteResult } from './writeFileWithCheck.ts';
+export declare function printStep(message: string): void;
+export declare function printSuccess(message: string): void;
+export declare function printSkip(message: string): void;
+export declare function printError(message: string): void;
+export declare function reportWriteResult(result: WriteResult, dryRun: boolean): void;