The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
import { afterEach, describe, expect, it, vi } from "vitest";
import { nextCronTickInTimeZone } from "./routines.js";
import * as cron from "./cron.js";
describe("nextCronTickInTimeZone formatter caching", () => {
afterEach(() => {
vi.restoreAllMocks();
});
it("parses a sparse schedule once instead of once per searched minute", () => {
const parse = cron.parseCron;
let parses = 0;
vi.spyOn(cron, "parseCron").mockImplementation(expression => {
parses++;
if (parses > 1) throw new Error("Repeated cron parsing blocks unrelated scheduled work");
return parse(expression);
});
const next = nextCronTickInTimeZone("0 12 1 1 *", "UTC", new Date("2020-01-01T12:00:00Z"));
expect(next?.toISOString()).toBe("2021-01-01T12:00:00.000Z");
expect(parses).toBe(1);
});
it("skips impossible UTC dates before localized formatting", () => {
const format = Intl.DateTimeFormat.prototype.formatToParts;
let formats = 0;
vi.spyOn(Intl.DateTimeFormat.prototype, "formatToParts").mockImplementation(function(this: Intl.DateTimeFormat, date) {
formats++;
if (formats > 48) throw new Error("Sparse UTC schedules must skip impossible dates");
return format.call(this, date);
});
const next = nextCronTickInTimeZone("0 12 1 1 *", "UTC", new Date("2020-01-01T12:00:00Z"));
expect(next?.toISOString()).toBe("2021-01-01T12:00:00.000Z");
expect(formats).toBeLessThanOrEqual(48);
});
it.each(["UTC", "America/New_York"])("rejects invalid search dates in %s", timeZone => {
expect(() => nextCronTickInTimeZone("0 12 1 1 *", timeZone, new Date(Number.NaN)))
.toThrow(RangeError);
});
it("computes the next occurrence of a sparse monthly cron correctly", () => {
const next = nextCronTickInTimeZone(
"30 6 1 * *",
"America/New_York",
new Date("2026-06-02T00:00:00Z"),
);
expect(next).not.toBeNull();
// 06:30 America/New_York on July 1st is 10:30 UTC (EDT, UTC-4).
expect(next!.toISOString()).toBe("2026-07-01T10:30:00.000Z");
});
it("does not construct a new Intl.DateTimeFormat per minute-step", () => {
const RealDateTimeFormat = Intl.DateTimeFormat;
let constructions = 0;
// Must be a `function` (not an arrow) so the mock stays constructable
// when the code under test calls `new Intl.DateTimeFormat(...)`.
vi.spyOn(Intl, "DateTimeFormat").mockImplementation(function (
...args: ConstructorParameters<typeof Intl.DateTimeFormat>
) {
constructions += 1;
return new RealDateTimeFormat(...args);
} as unknown as typeof Intl.DateTimeFormat);
// A monthly cron scanned from just after the previous firing walks tens of
// thousands of minute-steps before it matches. Use a timezone that nothing
// else in this test file has warmed so cache misses are observable.
const next = nextCronTickInTimeZone(
"0 12 1 * *",
"Pacific/Kiritimati",
new Date("2026-06-01T12:01:00Z"),
);
expect(next).not.toBeNull();
// One construction to populate the per-timezone cache; the ~43k subsequent
// minute-steps must reuse it. Before the cache this was one construction
// per step, which blocked the event loop for minutes (#8033).
expect(constructions).toBeLessThanOrEqual(1);
constructions = 0;
nextCronTickInTimeZone("0 12 1 * *", "Pacific/Kiritimati", new Date("2026-06-01T12:01:00Z"));
expect(constructions).toBe(0);
});
});