Function buildCommandTree

packages/evals/tui/commandTree.ts:390–674

()

 * argv (both null) contexts.
 */
export function buildCommandTree(): CommandNode {
  // Help printers are imported lazily to avoid pulling braintrust into
  // quiet commands like `config path`.
  const help = async () => import("./commands/help.js");

  const runNode: CommandNode = {
    name: "run",
    summary: "Run evals",
    printHelp: async () => (await help()).printRunHelp(),
    handler: async (args, ctx) => {
      const { parseRunArgs, resolveRunOptions } = await import(
        "./commands/parse.js"
      );
      const { readConfig } = await import("./commands/config.js");
      const { runCommand } = await import("./commands/run.js");

      const flags = parseRunArgs(args);
      const configFile = readConfig(ctx.entryDir);
      const resolved = resolveRunOptions(
        flags,
        configFile.defaults,
        process.env,
        configFile.core,
      );

      // Argv mode (no abortRef): handle --legacy here, mirroring cli.ts.
      if (ctx.abortRef === null) {
        if (flags.legacy) {
          const { runLegacy } = await import("./commands/legacy.js");
          const { discoverTasks } = await import("../framework/discovery.js");
          const { getRuntimeTasksRoot } = await import("../runtimePaths.js");
          const registry = await discoverTasks(getRuntimeTasksRoot(), false);
          await runLegacy(resolved, flags, registry);
          return;
        }
        await runCommand(resolved);
        return;
      }

      // REPL mode: pass abort signal so Esc can cancel.
      const registry = await ctx.getRegistry();
      ctx.abortRef.current = new AbortController();
      try {
        await runCommand(resolved, registry, ctx.abortRef.current.signal);
      } finally {
        ctx.abortRef.current = null;
      }
    },
  };

  const listNode: CommandNode = {
    name: "list",
    summary: "List tasks and categories",
    printHelp: async () => (await help()).printListHelp(),
    handler: async (args, ctx) => {
      const { printList } = await import("./commands/list.js");
      const detailed = args.includes("--detailed") || args.includes("-d");
      const tierFilter = args.find((a) => !a.startsWith("-"));