Function run

packages/cli/src/commands/benchmark.ts:59–244

({ args })

    json: { type: "boolean", description: "Output results as JSON", default: false },
  },
  async run({ args }) {
    // ── Resolve project ──────────────────────────────────────────────────
    const project = resolveProject(args.dir);

    // ── Parse runs ───────────────────────────────────────────────────────
    const runsPerConfig = parseInt(args.runs ?? "3", 10);
    if (isNaN(runsPerConfig) || runsPerConfig < 1 || runsPerConfig > 20) {
      errorBox("Invalid runs", `Got "${args.runs ?? "3"}". Must be between 1 and 20.`);
      process.exit(1);
    }

    const jsonOutput = args.json ?? false;

    // ── Temp output for benchmark renders ────────────────────────────────
    const benchDir = resolve("renders", ".benchmark");

    // ── Load producer ────────────────────────────────────────────────────
    let producer: Awaited<ReturnType<typeof loadProducer>> | null = null;
    try {
      producer = await loadProducer();
    } catch {
      if (jsonOutput) {
        console.log(
          JSON.stringify({ error: "Producer module not available. Is the project built?" }),
        );
      } else {
        errorBox(
          "Producer module not available",
          "The rendering pipeline could not be loaded.",
          "Ensure @hyperframes/producer is built and linked.",
        );
      }
      process.exit(1);
    }

    // ── Print header ─────────────────────────────────────────────────────
    if (!jsonOutput) {
      console.log("");
      console.log(
        c.accent("\u25C6") +
          "  Benchmarking " +
          c.accent(project.name) +
          c.dim(` (${runsPerConfig} runs each)`),
      );
      console.log("");
    }

    // ── Run benchmarks ───────────────────────────────────────────────────
    const results: ConfigResult[] = [];

    for (const config of DEFAULT_CONFIGS) {
      const runs: RunResult[] = [];
      let failures = 0;

      const s = !jsonOutput ? clack.spinner() : undefined;
      s?.start(`Benchmarking ${config.label}...`);

      for (let i = 0; i < runsPerConfig; i++) {