Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
// @vitest-environment node
import { spawn } from "node:child_process";
import { mkdirSync, mkdtempSync, readFileSync, rmSync, utimesSync, writeFileSync } from "node:fs";
import { homedir, tmpdir } from "node:os";
import { join } from "node:path";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
let home: string;
let configDir: string;
const saved = { HOME: process.env.HOME, USERPROFILE: process.env.USERPROFILE };
beforeEach(() => {
home = mkdtempSync(join(tmpdir(), "hf-config-lock-"));
configDir = join(home, ".hyperframes");
mkdirSync(configDir, { recursive: true });
process.env.HOME = home;
process.env.USERPROFILE = home;
// A worker thread keeps the real home; never write a test answer into it.
if (homedir() !== home) throw new Error("these tests need a process per test file");
vi.resetModules();
});
afterEach(() => {
process.env.HOME = saved.HOME;
process.env.USERPROFILE = saved.USERPROFILE;
rmSync(home, { recursive: true, force: true });
});
const consentOnDisk = () =>
JSON.parse(readFileSync(join(configDir, "config.json"), "utf-8")).localEmbeddingEnabled;
/** Another CLI process: takes the settings lock, saves the person's no after a pause, lets go. */
function anotherProcessSavesNo(): Promise<void> {
const script = `
const fs = require("fs");
const dir = process.argv[1];
fs.writeFileSync(dir + "/config.json.lock", "", { flag: "wx" });
process.stdout.write("locked\\n");
setTimeout(() => {
fs.writeFileSync(dir + "/config.json.other.tmp", JSON.stringify({ localEmbeddingEnabled: false }));
fs.renameSync(dir + "/config.json.other.tmp", dir + "/config.json");
fs.rmSync(dir + "/config.json.lock");
}, 300);`;
const child = spawn(process.execPath, ["-e", script, configDir]);
return new Promise((locked, failed) => {
child.stdout.on("data", () => locked());
child.on("error", failed);
});
}
describe("a settings file that exists but cannot be read", () => {
it.each([
[
"corrupt",
() => writeFileSync(join(configDir, "config.json"), '{"localEmbeddingEnabled": fal'),
],
["not a file", () => mkdirSync(join(configDir, "config.json"))],
[
"its answer is not a yes or no",
() => writeFileSync(join(configDir, "config.json"), '{"localEmbeddingEnabled": "false"}'),
],
])("counts as a no when %s, never as a question not yet asked", async (_, make) => {
make();
const { readConfig, updateLocalModelConsent } = await import("./config.js");
readConfig();
expect(updateLocalModelConsent((onDisk) => onDisk ?? true)).toBe(false);
});
});
describe("a settings lock left by a process that stopped", () => {
const leaveLock = () => {
const lock = join(configDir, "config.json.lock");
writeFileSync(lock, "stopped");
const past = new Date(Date.now() - 60_000);
utimesSync(lock, past, past);
return lock;
};
it.each([
["a terminal", true, [], undefined, 1],
["--json", true, ["--json"], undefined, 0],
["--json=true", true, ["--json=true"], undefined, 0],
["piped output", false, [], undefined, 0],
["CI", true, [], "true", 0],
])("warns once per process on %s", async (_, tty, extraArgs, ci, lines) => {
const lock = leaveLock();
const { writeConfig, readConfig } = await import("./config.js");
const streams = [process.stdin, process.stdout];
const saved = streams.map((stream) => Object.getOwnPropertyDescriptor(stream, "isTTY"));
const argv = process.argv;
const savedCi = process.env.CI;
const error = vi.spyOn(console, "error").mockImplementation(() => {});
for (const stream of streams)
Object.defineProperty(stream, "isTTY", { value: tty, configurable: true });
process.argv = [...argv, ...extraArgs];
if (ci === undefined) delete process.env.CI;
else process.env.CI = ci;
try {
writeConfig(readConfig());
writeConfig(readConfig());
const warnings = error.mock.calls.map(([line]) => String(line));
expect(warnings).toHaveLength(lines);
if (lines) expect(warnings[0]).toContain(lock);
if (lines) expect(warnings[0]).toContain("hyperframes doctor");
} finally {
error.mockRestore();
process.argv = argv;
if (savedCi === undefined) delete process.env.CI;
else process.env.CI = savedCi;
streams.forEach((stream, i) => {
const descriptor = saved[i];
if (descriptor) Object.defineProperty(stream, "isTTY", descriptor);
else delete (stream as { isTTY?: boolean }).isTTY;
});
}
});
});
describe("config writes across processes", () => {
it("reads a no another process is saving at that moment, not the answer before it", async () => {
const { readConfig, updateLocalModelConsent } = await import("./config.js");
writeFileSync(join(configDir, "config.json"), JSON.stringify({ localEmbeddingEnabled: true }));
readConfig();
await anotherProcessSavesNo();
expect(updateLocalModelConsent((onDisk) => onDisk)).toBe(false);
});
it("waits for another process's settings write, then keeps the no it saved", async () => {
const { readConfig, updateLocalModelConsent } = await import("./config.js");
expect(readConfig().localEmbeddingEnabled).toBeUndefined();
await anotherProcessSavesNo();
expect(updateLocalModelConsent((onDisk) => onDisk ?? true)).toBe(false);
expect(consentOnDisk()).toBe(false);
});
it("reads a no saved elsewhere even when keeping it writes nothing", async () => {
const { readConfig, updateLocalModelConsent } = await import("./config.js");
const early = readConfig();
writeFileSync(
join(configDir, "config.json"),
JSON.stringify({ ...early, localEmbeddingEnabled: false }),
);
expect(updateLocalModelConsent((onDisk) => onDisk ?? true)).toBe(false);
expect(readConfig().localEmbeddingEnabled).toBe(false);
});
it("never lets a copy read before another process's no put the question back", async () => {
const { readConfig, writeConfig } = await import("./config.js");
const early = readConfig();
writeFileSync(
join(configDir, "config.json"),
JSON.stringify({ ...early, localEmbeddingEnabled: false }),
);
writeConfig({ ...early, commandCount: early.commandCount + 1 });
expect(consentOnDisk()).toBe(false);
});
});