openclaw/test/scripts/runtime-postbuild-stamp.test.ts

import fs from "node:fs";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { RUNTIME_POSTBUILD_STAMP_FILE } from "../../scripts/lib/local-build-metadata-paths.mts";
import { writeRuntimePostBuildStamp } from "../../scripts/lib/local-build-metadata.mts";
import { captureRunNodeInputState } from "../../scripts/lib/run-node-input-state.mts";
import {
  copyStaticExtensionAssets,
  copyStaticExtensionAssetsToRuntimeOverlay,
} from "../../scripts/lib/static-extension-assets.mts";
import { resolveRuntimePostBuildRequirement } from "../../scripts/run-node.mts";
import { useAutoCleanupTempDirTracker } from "../helpers/temp-dir.js";
import { setupStampedProject, trackProjectWithGit } from "./run-node.test-support.js";

describe("runtime-postbuild-stamp script", () => {
  const tempDirs = useAutoCleanupTempDirTracker(afterEach);

  it.each([
    { name: "clean", gitStatus: "", inputsClean: true },
    { name: "skipped assets", gitStatus: "", inputsClean: true },
    {
      name: "dirty metadata",
      gitStatus: " M extensions/demo/openclaw.plugin.json\0",
      inputsClean: false,
    },
    { name: "source-only change", gitStatus: " M src/index.ts\0", inputsClean: true },
    { name: "unknown", gitStatus: null, inputsClean: null },
  ])(
    "records $name runtime inputs with the current git head",
    ({ name, gitStatus, inputsClean }) => {
      const rootDir = tempDirs.make("openclaw-runtime-postbuild-stamp-");
      const stampPath = writeRuntimePostBuildStamp({
        cwd: rootDir,
        now: () => 123,
        env: { OPENCLAW_RUNTIME_POSTBUILD_STATIC_ASSETS: name === "skipped assets" ? "0" : "1" },
        spawnSync: (_command, args) =>
          args[0] === "rev-parse"
            ? { status: 0, stdout: "abc123\n" }
            : gitStatus === null
              ? { status: 1, stdout: "" }
              : { status: 0, stdout: gitStatus },
      });

      expect(path.relative(rootDir, stampPath)).toBe(
        path.join("dist", RUNTIME_POSTBUILD_STAMP_FILE),
      );
      expect(JSON.parse(fs.readFileSync(stampPath, "utf8"))).toEqual({
        syncedAt: 123,
        head: "abc123",
        inputsClean,
        staticAssets: name !== "skipped assets",
      });
    },
  );
  it("does not reuse skipped static assets for a full runtime reader", async () => {
    const cwd = tempDirs.make("runtime-stamp-assets-");
    const source = "extensions/apple-fm/assets/AppleFoundationModels.swift";
    const output = `dist/${source}`;
    const overlay = `dist-runtime/${source}`;
    await setupStampedProject(cwd, {
      files: {
        "extensions/apple-fm/package.json": JSON.stringify({
          name: "@openclaw/apple-fm",
          openclaw: {
            build: {
              staticAssets: [
                {
                  source: "assets/AppleFoundationModels.swift",
                  output: "assets/AppleFoundationModels.swift",
                },
              ],
            },
          },
        }),
        [source]: "A",
        [output]: "A",
        [overlay]: "A",
      },
    });
    const { deps } = await trackProjectWithGit(cwd);
    fs.writeFileSync(path.join(cwd, source), "B");
    const env = { OPENCLAW_RUNTIME_POSTBUILD_STATIC_ASSETS: "0" };
    writeRuntimePostBuildStamp({
      cwd,
      env,
      inputState: captureRunNodeInputState({ ...deps, env }, "runtime"),
    });
    expect(fs.readFileSync(path.join(cwd, output), "utf8")).toBe("A");
    expect(resolveRuntimePostBuildRequirement(deps, { allowEquivalentInputs: true }).reason).toBe(
      "static_assets_not_prepared",
    );
    expect(
      resolveRuntimePostBuildRequirement({ ...deps, env }, { allowEquivalentInputs: true })
        .shouldSync,
    ).toBe(false);
    const inputState = captureRunNodeInputState(deps, "runtime");
    copyStaticExtensionAssets({ rootDir: cwd, env: {} });
    copyStaticExtensionAssetsToRuntimeOverlay({ rootDir: cwd, env: {} });
    writeRuntimePostBuildStamp({ cwd, env: {}, inputState });
    expect(fs.readFileSync(path.join(cwd, output), "utf8")).toBe("B");
    expect(
      resolveRuntimePostBuildRequirement(deps, { allowEquivalentInputs: true }).shouldSync,
    ).toBe(false);
    expect(
      resolveRuntimePostBuildRequirement({ ...deps, env }, { allowEquivalentInputs: true })
        .shouldSync,
    ).toBe(false);
    const stamp = path.join(cwd, "dist", RUNTIME_POSTBUILD_STAMP_FILE);
    const recorded = JSON.parse(fs.readFileSync(stamp, "utf8"));
    fs.writeFileSync(stamp, JSON.stringify({ ...recorded, staticAssets: "unknown" }));
    expect(resolveRuntimePostBuildRequirement(deps, { allowEquivalentInputs: true }).reason).toBe(
      "static_assets_not_prepared",
    );
  });
});