openclaw/test/scripts/write-cli-startup-metadata.test.ts

import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
import os from "node:os";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import {
  renderBundledRootHelpText,
  writeCliStartupMetadata,
} from "../../scripts/write-cli-startup-metadata.ts";

function createTempDir(prefix: string): string {
  return mkdtempSync(path.join(os.tmpdir(), prefix));
}

describe("write-cli-startup-metadata", () => {
  const tempDirs: string[] = [];

  afterEach(() => {
    for (const dir of tempDirs.splice(0)) {
      rmSync(dir, { recursive: true, force: true });
    }
  });

  it("captures async root help bundle output", async () => {
    const distDir = createTempDir("openclaw-root-help-");
    tempDirs.push(distDir);
    writeFileSync(
      path.join(distDir, "root-help-async.js"),
      [
        "export async function outputRootHelp() {",
        "  await Promise.resolve();",
        "  process.stdout.write('OpenClaw help\\n');",
        "}",
        "",
      ].join("\n"),
      "utf8",
    );

    await expect(renderBundledRootHelpText(distDir)).resolves.toBe("OpenClaw help\n");
  });

  it("writes startup metadata with populated root help text", async () => {
    const tempRoot = createTempDir("openclaw-startup-metadata-");
    tempDirs.push(tempRoot);
    const distDir = path.join(tempRoot, "dist");
    const extensionsDir = path.join(tempRoot, "extensions");
    const outputPath = path.join(distDir, "cli-startup-metadata.json");

    mkdirSync(distDir, { recursive: true });
    mkdirSync(path.join(extensionsDir, "matrix"), { recursive: true });
    writeFileSync(
      path.join(distDir, "root-help-fixture.js"),
      "export async function outputRootHelp() { process.stdout.write('Usage: openclaw\\n'); }\n",
      "utf8",
    );
    writeFileSync(
      path.join(extensionsDir, "matrix", "package.json"),
      JSON.stringify({
        openclaw: {
          channel: {
            id: "matrix",
            order: 120,
            label: "Matrix",
          },
        },
      }),
      "utf8",
    );

    await writeCliStartupMetadata({ distDir, outputPath, extensionsDir });

    const written = JSON.parse(readFileSync(outputPath, "utf8")) as {
      channelOptions: string[];
      rootHelpText: string;
    };
    expect(written.channelOptions).toContain("matrix");
    expect(written.rootHelpText).toBe("Usage: openclaw\n");
  });
});