});

describe("createBackupArchive", () => {

it("falls back when injected nowMs is outside Date range", async () => {

await withOpenClawTestState(

{

layout: "state-only",

prefix: "openclaw-backup-invalid-now-",

scenario: "minimal",

},

async (state) => {

const outputDir = state.path("backups");

await fs.mkdir(outputDir, { recursive: true });

const dateNowSpy = vi.spyOn(Date, "now").mockReturnValue(Date.UTC(2026, 4, 30, 12, 0, 0));

try {

const result = await createBackupArchive({

output: outputDir,

dryRun: true,

includeWorkspace: false,

nowMs: 8_640_000_000_000_001,

});

expect(result.createdAt).toBe("2026-05-30T12:00:00.000Z");

expect(path.basename(result.archivePath)).toContain("openclaw-backup.tar.gz");

expect(path.basename(result.archivePath)).not.toContain("NaN");

} finally {

dateNowSpy.mockRestore();

}

},

);

});

it("skips current live volatile state files while preserving workspace locks", async () => {

await withOpenClawTestState(

{

resolveBackupPlanFromDisk,

} from "../commands/backup-shared.js";

import { isPathWithin } from "../commands/cleanup-utils.js";

import { asDateTimestampMs } from "../shared/number-coercion.js";

import { resolveHomeDir, resolveUserPath } from "../utils.js";

import { resolveRuntimeServiceVersion } from "../version.js";

import { isVolatileBackupPath } from "./backup-volatile-filter.js";

export async function createBackupArchive(

opts: BackupCreateOptions = {},

): Promise<BackupCreateResult> {

const nowMs = opts.nowMs ?? Date.now();

const nowMs = asDateTimestampMs(opts.nowMs) ?? Date.now();

const archiveRoot = buildBackupArchiveRoot(nowMs);

const onlyConfig = Boolean(opts.onlyConfig);

const includeWorkspace = onlyConfig ? false : (opts.includeWorkspace ?? true);