@gtkx/vitest 2.0.0-beta.3 → 2.0.0-beta.5

package/dist/reap-headless-displays.js

@@ -0,0 +1,211 @@
+import { cleanupDirectoryIdentity, info, removeCleanupDirectory, } from "@gtkx/utils";
+import { constants, lstatSync, readdirSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { createBusConfig, createHeadlessRuntimeMarker, HEADLESS_RUNTIME_MARKER, isSwayConfig, } from "./headless-config.js";
+const RUNTIME_DIRECTORY_PATTERN = /^gtkx-xdg-[A-Za-z0-9]{6}$/;
+const STOPPED_PROCESS_STATES = new Set(["Z", "X", "x"]);
+const CONFIG_SIZE_LIMIT = 2048;
+const MINIMUM_STALE_AGE_MS = 5000;
+const RUNTIME_ROOT = tmpdir();
+const currentUserId = () => {
+    const getuid = process.getuid;
+    return getuid === undefined ? undefined : getuid();
+};
+const isUserOwned = (path, userId) => {
+    try {
+        return lstatSync(path).uid === userId;
+    }
+    catch {
+        return false;
+    }
+};
+const isPrivateRuntimeDirectory = (runtimeDir, userId) => {
+    try {
+        const stat = lstatSync(runtimeDir);
+        return stat.isDirectory() &&
+            stat.uid === userId &&
+            (stat.mode & 0o777) === 0o700 &&
+            Date.now() - stat.mtimeMs >= MINIMUM_STALE_AGE_MS &&
+            RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) &&
+            dirname(runtimeDir) === RUNTIME_ROOT;
+    }
+    catch {
+        return false;
+    }
+};
+const readOwnedFile = (path, runtimeDir, userId, requiredMode) => {
+    try {
+        if (dirname(path) !== runtimeDir) {
+            return undefined;
+        }
+        const contents = readFileSync(path, {
+            encoding: "utf8",
+            flag: constants.O_RDONLY | constants.O_NOFOLLOW,
+        });
+        const stat = lstatSync(path);
+        return stat.isFile() &&
+            stat.uid === userId &&
+            stat.size < CONFIG_SIZE_LIMIT &&
+            (requiredMode === undefined || (stat.mode & 0o777) === requiredMode)
+            ? contents
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const hasOnlyBusConfig = (runtimeDir) => {
+    try {
+        const entries = readdirSync(runtimeDir);
+        return entries.length === 1 && entries[0] === "session.conf";
+    }
+    catch {
+        return false;
+    }
+};
+const hasGeneratedRuntimeFiles = (runtimeDir, userId) => {
+    const bus = readOwnedFile(join(runtimeDir, "session.conf"), runtimeDir, userId);
+    if (bus !== createBusConfig(join(runtimeDir, "bus"))) {
+        return false;
+    }
+    const sway = readOwnedFile(join(runtimeDir, "sway.conf"), runtimeDir, userId);
+    const marker = readOwnedFile(join(runtimeDir, HEADLESS_RUNTIME_MARKER), runtimeDir, userId, 0o600);
+    return marker === createHeadlessRuntimeMarker(runtimeDir) ||
+        (sway !== undefined && isSwayConfig(sway)) ||
+        hasOnlyBusConfig(runtimeDir);
+};
+const readProcessArguments = (pid) => {
+    try {
+        const stat = readFileSync(`/proc/${String(pid)}/stat`, "utf8");
+        const state = stat.slice(stat.lastIndexOf(") ") + 2).split(" ", 1)[0];
+        if (state === undefined || STOPPED_PROCESS_STATES.has(state)) {
+            return undefined;
+        }
+        return readFileSync(`/proc/${String(pid)}/cmdline`)
+            .toString()
+            .split("\0")
+            .filter((argument) => argument.length > 0);
+    }
+    catch {
+        return undefined;
+    }
+};
+const runtimeFromArgument = (argument) => {
+    const path = argument.startsWith("--config-file=") ? argument.slice("--config-file=".length) : argument;
+    const name = basename(path);
+    if (name !== "sway.conf" && name !== "session.conf") {
+        return undefined;
+    }
+    const runtimeDir = dirname(path);
+    return RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) && dirname(runtimeDir) === RUNTIME_ROOT
+        ? runtimeDir
+        : undefined;
+};
+const runtimeFromEnvironment = (pid) => {
+    try {
+        const prefix = "XDG_RUNTIME_DIR=";
+        const entry = readFileSync(`/proc/${String(pid)}/environ`, "utf8")
+            .split("\0")
+            .find((value) => value.startsWith(prefix));
+        const runtimeDir = entry?.slice(prefix.length);
+        return runtimeDir !== undefined &&
+            RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) &&
+            dirname(runtimeDir) === RUNTIME_ROOT
+            ? runtimeDir
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const isOwnedProcessId = (pid, userId) => Number.isSafeInteger(pid) && pid > 1 && isUserOwned(`/proc/${String(pid)}`, userId);
+const addRuntimeArguments = (live, processArgs) => {
+    for (const argument of processArgs) {
+        const runtimeDir = runtimeFromArgument(argument);
+        if (runtimeDir !== undefined) {
+            live.add(runtimeDir);
+        }
+    }
+};
+const addProcessRuntimes = (live, pid) => {
+    const processArgs = readProcessArguments(pid);
+    if (processArgs === undefined) {
+        return;
+    }
+    addRuntimeArguments(live, processArgs);
+    const runtimeDir = runtimeFromEnvironment(pid);
+    if (runtimeDir !== undefined) {
+        live.add(runtimeDir);
+    }
+};
+const findLiveRuntimeDirectories = (userId) => {
+    const live = new Set();
+    const processEntries = readdirSync("/proc");
+    for (const entry of processEntries) {
+        const pid = Number(entry);
+        if (!isOwnedProcessId(pid, userId)) {
+            continue;
+        }
+        addProcessRuntimes(live, pid);
+    }
+    return live;
+};
+const classifyRuntimeDirectory = (name, userId, live) => {
+    const runtimeDir = join(RUNTIME_ROOT, name);
+    if (live.has(runtimeDir) ||
+        !isPrivateRuntimeDirectory(runtimeDir, userId) ||
+        !hasGeneratedRuntimeFiles(runtimeDir, userId)) {
+        return [];
+    }
+    const cleanupDirectory = cleanupDirectoryIdentity(runtimeDir);
+    return cleanupDirectory === undefined ? [] : [{ runtimeDir, cleanupDirectory }];
+};
+const findStaleHeadlessDisplays = () => {
+    const userId = currentUserId();
+    if (userId === undefined) {
+        return [];
+    }
+    const live = findLiveRuntimeDirectories(userId);
+    return readdirSync(RUNTIME_ROOT, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && RUNTIME_DIRECTORY_PATTERN.test(entry.name))
+        .flatMap((entry) => classifyRuntimeDirectory(entry.name, userId, live));
+};
+const isSameCleanupDirectory = (left, right) => left?.device === right.device &&
+    left.inode === right.inode &&
+    left.userId === right.userId;
+const isReapable = (candidate, userId, live) => !live.has(candidate.runtimeDir) &&
+    isSameCleanupDirectory(cleanupDirectoryIdentity(candidate.runtimeDir), candidate.cleanupDirectory) &&
+    isPrivateRuntimeDirectory(candidate.runtimeDir, userId) &&
+    hasGeneratedRuntimeFiles(candidate.runtimeDir, userId);
+const didReapCandidate = (candidate, userId, live) => {
+    if (!isReapable(candidate, userId, live)) {
+        return false;
+    }
+    removeCleanupDirectory(candidate.cleanupDirectory);
+    return cleanupDirectoryIdentity(candidate.runtimeDir) === undefined;
+};
+const reapStaleHeadlessDisplays = (candidates = findStaleHeadlessDisplays()) => {
+    const userId = currentUserId();
+    if (userId === undefined) {
+        return [];
+    }
+    const live = findLiveRuntimeDirectories(userId);
+    const removed = [];
+    for (const candidate of candidates) {
+        if (didReapCandidate(candidate, userId, live)) {
+            removed.push(candidate.runtimeDir);
+        }
+    }
+    return removed;
+};
+const reapStaleHeadlessDisplaysAtStartup = () => {
+    const removed = reapStaleHeadlessDisplays();
+    if (removed.length === 0) {
+        return;
+    }
+    const noun = removed.length === 1 ? "directory" : "directories";
+    info(`removed stale headless runtime ${noun}: ${removed.join(", ")}`);
+};
+export { findStaleHeadlessDisplays, reapStaleHeadlessDisplays, reapStaleHeadlessDisplaysAtStartup, };
+//# sourceMappingURL=reap-headless-displays.js.map

package/dist/reap-headless-displays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reap-headless-displays.js","sourceRoot":"","sources":["../src/reap-headless-displays.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type CleanupDirectoryIdentity,\n    cleanupDirectoryIdentity,\n    info,\n    removeCleanupDirectory,\n} from \"@gtkx/utils\";\nimport { constants, lstatSync, readdirSync, readFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { basename, dirname, join } from \"node:path\";\nimport {\n    createBusConfig,\n    createHeadlessRuntimeMarker,\n    HEADLESS_RUNTIME_MARKER,\n    isSwayConfig,\n} from \"./headless-config.ts\";\n\ntype StaleHeadlessDisplay = {\n    runtimeDir: string;\n    cleanupDirectory: CleanupDirectoryIdentity;\n};\n\nconst RUNTIME_DIRECTORY_PATTERN = /^gtkx-xdg-[A-Za-z0-9]{6}$/;\nconst STOPPED_PROCESS_STATES: Set<string> = new Set([\"Z\", \"X\", \"x\"]);\nconst CONFIG_SIZE_LIMIT = 2048;\nconst MINIMUM_STALE_AGE_MS = 5000;\nconst RUNTIME_ROOT = tmpdir();\n\nconst currentUserId = (): number | undefined => {\n    const getuid = process.getuid;\n\n    return getuid === undefined ? undefined : getuid();\n};\n\nconst isUserOwned = (path: string, userId: number): boolean => {\n    try {\n        return lstatSync(path).uid === userId;\n    } catch {\n        return false;\n    }\n};\n\nconst isPrivateRuntimeDirectory = (runtimeDir: string, userId: number): boolean => {\n    try {\n        const stat = lstatSync(runtimeDir);\n\n        return stat.isDirectory() &&\n            stat.uid === userId &&\n            (stat.mode & 0o777) === 0o700 &&\n            Date.now() - stat.mtimeMs >= MINIMUM_STALE_AGE_MS &&\n            RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) &&\n            dirname(runtimeDir) === RUNTIME_ROOT;\n    } catch {\n        return false;\n    }\n};\n\nconst readOwnedFile = (\n    path: string,\n    runtimeDir: string,\n    userId: number,\n    requiredMode?: number,\n): string | undefined => {\n    try {\n        if (dirname(path) !== runtimeDir) {\n            return undefined;\n        }\n\n        const contents = readFileSync(path, {\n            encoding: \"utf8\",\n            flag: constants.O_RDONLY | constants.O_NOFOLLOW,\n        });\n        const stat = lstatSync(path);\n\n        return stat.isFile() &&\n            stat.uid === userId &&\n            stat.size < CONFIG_SIZE_LIMIT &&\n            (requiredMode === undefined || (stat.mode & 0o777) === requiredMode)\n            ? contents\n            : undefined;\n    } catch {\n        return undefined;\n    }\n};\n\nconst hasOnlyBusConfig = (runtimeDir: string): boolean => {\n    try {\n        const entries = readdirSync(runtimeDir);\n\n        return entries.length === 1 && entries[0] === \"session.conf\";\n    } catch {\n        return false;\n    }\n};\n\nconst hasGeneratedRuntimeFiles = (runtimeDir: string, userId: number): boolean => {\n    const bus = readOwnedFile(join(runtimeDir, \"session.conf\"), runtimeDir, userId);\n\n    if (bus !== createBusConfig(join(runtimeDir, \"bus\"))) {\n        return false;\n    }\n\n    const sway = readOwnedFile(join(runtimeDir, \"sway.conf\"), runtimeDir, userId);\n    const marker = readOwnedFile(join(runtimeDir, HEADLESS_RUNTIME_MARKER), runtimeDir, userId, 0o600);\n\n    return marker === createHeadlessRuntimeMarker(runtimeDir) ||\n        (sway !== undefined && isSwayConfig(sway)) ||\n        hasOnlyBusConfig(runtimeDir);\n};\n\nconst readProcessArguments = (pid: number): string[] | undefined => {\n    try {\n        const stat = readFileSync(`/proc/${String(pid)}/stat`, \"utf8\");\n        const state = stat.slice(stat.lastIndexOf(\") \") + 2).split(\" \", 1)[0];\n\n        if (state === undefined || STOPPED_PROCESS_STATES.has(state)) {\n            return undefined;\n        }\n\n        return readFileSync(`/proc/${String(pid)}/cmdline`)\n            .toString()\n            .split(\"\\0\")\n            .filter((argument) => argument.length > 0);\n    } catch {\n        return undefined;\n    }\n};\n\nconst runtimeFromArgument = (argument: string): string | undefined => {\n    const path = argument.startsWith(\"--config-file=\") ? argument.slice(\"--config-file=\".length) : argument;\n    const name = basename(path);\n\n    if (name !== \"sway.conf\" && name !== \"session.conf\") {\n        return undefined;\n    }\n\n    const runtimeDir = dirname(path);\n\n    return RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) && dirname(runtimeDir) === RUNTIME_ROOT\n        ? runtimeDir\n        : undefined;\n};\n\nconst runtimeFromEnvironment = (pid: number): string | undefined => {\n    try {\n        const prefix = \"XDG_RUNTIME_DIR=\";\n        const entry = readFileSync(`/proc/${String(pid)}/environ`, \"utf8\")\n            .split(\"\\0\")\n            .find((value) => value.startsWith(prefix));\n        const runtimeDir = entry?.slice(prefix.length);\n\n        return runtimeDir !== undefined &&\n            RUNTIME_DIRECTORY_PATTERN.test(basename(runtimeDir)) &&\n            dirname(runtimeDir) === RUNTIME_ROOT\n            ? runtimeDir\n            : undefined;\n    } catch {\n        return undefined;\n    }\n};\n\nconst isOwnedProcessId = (pid: number, userId: number): boolean =>\n    Number.isSafeInteger(pid) && pid > 1 && isUserOwned(`/proc/${String(pid)}`, userId);\n\nconst addRuntimeArguments = (live: Set<string>, processArgs: string[]): void => {\n    for (const argument of processArgs) {\n        const runtimeDir = runtimeFromArgument(argument);\n\n        if (runtimeDir !== undefined) {\n            live.add(runtimeDir);\n        }\n    }\n};\n\nconst addProcessRuntimes = (live: Set<string>, pid: number): void => {\n    const processArgs = readProcessArguments(pid);\n\n    if (processArgs === undefined) {\n        return;\n    }\n\n    addRuntimeArguments(live, processArgs);\n    const runtimeDir = runtimeFromEnvironment(pid);\n\n    if (runtimeDir !== undefined) {\n        live.add(runtimeDir);\n    }\n};\n\nconst findLiveRuntimeDirectories = (userId: number): Set<string> => {\n    const live: Set<string> = new Set();\n    const processEntries = readdirSync(\"/proc\");\n\n    for (const entry of processEntries) {\n        const pid = Number(entry);\n\n        if (!isOwnedProcessId(pid, userId)) {\n            continue;\n        }\n\n        addProcessRuntimes(live, pid);\n    }\n\n    return live;\n};\n\nconst classifyRuntimeDirectory = (\n    name: string,\n    userId: number,\n    live: ReadonlySet<string>,\n): StaleHeadlessDisplay[] => {\n    const runtimeDir = join(RUNTIME_ROOT, name);\n\n    if (\n        live.has(runtimeDir) ||\n        !isPrivateRuntimeDirectory(runtimeDir, userId) ||\n        !hasGeneratedRuntimeFiles(runtimeDir, userId)\n    ) {\n        return [];\n    }\n\n    const cleanupDirectory = cleanupDirectoryIdentity(runtimeDir);\n\n    return cleanupDirectory === undefined ? [] : [{ runtimeDir, cleanupDirectory }];\n};\n\nconst findStaleHeadlessDisplays = (): StaleHeadlessDisplay[] => {\n    const userId = currentUserId();\n\n    if (userId === undefined) {\n        return [];\n    }\n\n    const live = findLiveRuntimeDirectories(userId);\n\n    return readdirSync(RUNTIME_ROOT, { withFileTypes: true })\n        .filter((entry) => entry.isDirectory() && RUNTIME_DIRECTORY_PATTERN.test(entry.name))\n        .flatMap((entry) => classifyRuntimeDirectory(entry.name, userId, live));\n};\n\nconst isSameCleanupDirectory = (\n    left: CleanupDirectoryIdentity | undefined,\n    right: CleanupDirectoryIdentity,\n): boolean =>\n    left?.device === right.device &&\n    left.inode === right.inode &&\n    left.userId === right.userId;\n\nconst isReapable = (\n    candidate: StaleHeadlessDisplay,\n    userId: number,\n    live: ReadonlySet<string>,\n): boolean =>\n    !live.has(candidate.runtimeDir) &&\n    isSameCleanupDirectory(cleanupDirectoryIdentity(candidate.runtimeDir), candidate.cleanupDirectory) &&\n    isPrivateRuntimeDirectory(candidate.runtimeDir, userId) &&\n    hasGeneratedRuntimeFiles(candidate.runtimeDir, userId);\n\nconst didReapCandidate = (\n    candidate: StaleHeadlessDisplay,\n    userId: number,\n    live: ReadonlySet<string>,\n): boolean => {\n    if (!isReapable(candidate, userId, live)) {\n        return false;\n    }\n\n    removeCleanupDirectory(candidate.cleanupDirectory);\n\n    return cleanupDirectoryIdentity(candidate.runtimeDir) === undefined;\n};\n\nconst reapStaleHeadlessDisplays = (\n    candidates: readonly StaleHeadlessDisplay[] = findStaleHeadlessDisplays(),\n): string[] => {\n    const userId = currentUserId();\n\n    if (userId === undefined) {\n        return [];\n    }\n\n    const live = findLiveRuntimeDirectories(userId);\n    const removed: string[] = [];\n\n    for (const candidate of candidates) {\n        if (didReapCandidate(candidate, userId, live)) {\n            removed.push(candidate.runtimeDir);\n        }\n    }\n\n    return removed;\n};\n\nconst reapStaleHeadlessDisplaysAtStartup = (): void => {\n    const removed = reapStaleHeadlessDisplays();\n\n    if (removed.length === 0) {\n        return;\n    }\n\n    const noun = removed.length === 1 ? \"directory\" : \"directories\";\n    info(`removed stale headless runtime ${noun}: ${removed.join(\", \")}`);\n};\n\nexport {\n    findStaleHeadlessDisplays,\n    reapStaleHeadlessDisplays,\n    reapStaleHeadlessDisplaysAtStartup,\n    type StaleHeadlessDisplay,\n};\n"]}

package/dist/worker-preload.js

@@ -1,5 +1,6 @@
-import { installGracefulShutdown } from "@gtkx/utils";
+import { installGracefulShutdown, watchParentProcess } from "@gtkx/utils";
 import { readHeadlessOptions, resolveHeadlessOptions, startHeadlessDisplay } from "./headless-display.js";
+watchParentProcess();
 const options = readHeadlessOptions(new URL(import.meta.url).searchParams);
 const teardown = await startHeadlessDisplay(resolveHeadlessOptions(options));
 process.on("exit", teardown);

package/dist/worker-preload.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-preload.js","sourceRoot":"","sources":["../src/worker-preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE1G,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AAC3E,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7B,uBAAuB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC","sourcesContent":["import { installGracefulShutdown } from \"@gtkx/utils\";\nimport { readHeadlessOptions, resolveHeadlessOptions, startHeadlessDisplay } from \"./headless-display.ts\";\n\nconst options = readHeadlessOptions(new URL(import.meta.url).searchParams);\nconst teardown = await startHeadlessDisplay(resolveHeadlessOptions(options));\n\nprocess.on(\"exit\", teardown);\ninstallGracefulShutdown({ onSignal: teardown });\n"]}
+{"version":3,"file":"worker-preload.js","sourceRoot":"","sources":["../src/worker-preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE1G,kBAAkB,EAAE,CAAC;AAErB,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AAC3E,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7B,uBAAuB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC","sourcesContent":["import { installGracefulShutdown, watchParentProcess } from \"@gtkx/utils\";\nimport { readHeadlessOptions, resolveHeadlessOptions, startHeadlessDisplay } from \"./headless-display.ts\";\n\nwatchParentProcess();\n\nconst options = readHeadlessOptions(new URL(import.meta.url).searchParams);\nconst teardown = await startHeadlessDisplay(resolveHeadlessOptions(options));\n\nprocess.on(\"exit\", teardown);\ninstallGracefulShutdown({ onSignal: teardown });\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/vitest",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.5",
   "description": "Vitest plugin for GTK apps with headless Wayland isolation.",
   "keywords": [
     "gtkx",
@@ -59,8 +59,8 @@
     "node": ">=26.7.0"
   },
   "dependencies": {
-    "@gtkx/config": "2.0.0-beta.3",
-    "@gtkx/utils": "2.0.0-beta.3",
+    "@gtkx/config": "2.0.0-beta.5",
+    "@gtkx/utils": "2.0.0-beta.5",
     "@homebridge/dbus-native": "^0.7.9"
   },
   "devDependencies": {

package/src/headless-config.ts

@@ -0,0 +1,61 @@
+const BUS_CONFIG_DOCTYPE =
+    '<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN" ' +
+    '"https://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">';
+
+const HEADLESS_RUNTIME_MARKER = ".gtkx-headless-runtime";
+
+const SWAY_CONFIG_LINES = [
+    /^xwayland disable$/,
+    /^default_border none$/,
+    /^default_floating_border none$/,
+    /^output HEADLESS-1 resolution [1-9]\d*x[1-9]\d*$/,
+    /^output HEADLESS-1 bg #000000 solid_color$/,
+    /^for_window \[app_id="\.\*"\] floating enable, border none$/,
+    /^for_window \[title="\.\*"\] floating enable, border none$/,
+    /^$/,
+];
+
+const createSwayConfig = (width: string, height: string): string =>
+    [
+        "xwayland disable",
+        "default_border none",
+        "default_floating_border none",
+        `output HEADLESS-1 resolution ${width}x${height}`,
+        "output HEADLESS-1 bg #000000 solid_color",
+        'for_window [app_id=".*"] floating enable, border none',
+        'for_window [title=".*"] floating enable, border none',
+        "",
+    ].join("\n");
+
+const createBusConfig = (busSocketPath: string): string =>
+    [
+        BUS_CONFIG_DOCTYPE,
+        "<busconfig>",
+        "  <type>session</type>",
+        `  <listen>unix:path=${busSocketPath}</listen>`,
+        "  <auth>EXTERNAL</auth>",
+        '  <policy context="default">',
+        '    <allow send_destination="*" eavesdrop="true"/>',
+        '    <allow eavesdrop="true"/>',
+        '    <allow own="*"/>',
+        "  </policy>",
+        "</busconfig>",
+    ].join("\n");
+
+const createHeadlessRuntimeMarker = (runtimeDir: string): string =>
+    ["gtkx-headless-runtime-v1", `runtime=${runtimeDir}`, ""].join("\n");
+
+const isSwayConfig = (value: string): boolean => {
+    const lines = value.split("\n");
+
+    return lines.length === SWAY_CONFIG_LINES.length &&
+        SWAY_CONFIG_LINES.every((pattern, index) => pattern.test(lines[index] ?? "invalid"));
+};
+
+export {
+    createBusConfig,
+    createHeadlessRuntimeMarker,
+    createSwayConfig,
+    HEADLESS_RUNTIME_MARKER,
+    isSwayConfig,
+};

package/src/headless-display.ts

@@ -4,6 +4,12 @@ import { chmodSync, closeSync, existsSync, mkdtempSync, openSync, rmSync, writeF
 import { Socket } from "node:net";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import {
+    createBusConfig,
+    createHeadlessRuntimeMarker,
+    createSwayConfig,
+    HEADLESS_RUNTIME_MARKER,
+} from "./headless-config.ts";
 import { startNotificationService } from "./notification-service.ts";
 import { startVirtualSeat } from "./virtual-seat.ts";
 
@@ -59,6 +65,7 @@ type DisplaySockets = {
 
 type CapturedStderr = {
     chunks: string[];
+    logPath: string;
     stop: () => void;
 };
 
@@ -72,10 +79,6 @@ const DEFAULT_HEADLESS_SIZE = "1024x768";
 const DEFAULT_HEADLESS_COMPOSITOR: CompositorId = "sway";
 const HEADLESS_SIZE_PATTERN = /^[1-9]\d*x[1-9]\d*$/;
 
-const BUS_CONFIG_DOCTYPE =
-    '<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN" ' +
-    '"https://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">';
-
 const hasWestonFakeSeat = createWestonFakeSeatProbe();
 
 const compositorRegistry: Record<CompositorId, CompositorDescriptor> = {
@@ -94,16 +97,7 @@ const compositorRegistry: Record<CompositorId, CompositorDescriptor> = {
 
             writeFileSync(
                 configPath,
-                [
-                    "xwayland disable",
-                    "default_border none",
-                    "default_floating_border none",
-                    `output HEADLESS-1 resolution ${width}x${height}`,
-                    "output HEADLESS-1 bg #000000 solid_color",
-                    'for_window [app_id=".*"] floating enable, border none',
-                    'for_window [title=".*"] floating enable, border none',
-                    "",
-                ].join("\n"),
+                createSwayConfig(width, height),
             );
 
             return spawnWithParentDeathSupervisor("sway", ["-c", configPath], {
@@ -228,22 +222,7 @@ const attachVirtualSeat = (compositor: SpawnedCompositor, socketPath: string): P
     compositor.requiresVirtualSeat ? startVirtualSeat(socketPath) : Promise.resolve(noVirtualSeat);
 
 const writeBusConfig = (busConfigPath: string, busSocketPath: string): void => {
-    writeFileSync(
-        busConfigPath,
-        [
-            BUS_CONFIG_DOCTYPE,
-            "<busconfig>",
-            "  <type>session</type>",
-            `  <listen>unix:path=${busSocketPath}</listen>`,
-            "  <auth>EXTERNAL</auth>",
-            '  <policy context="default">',
-            '    <allow send_destination="*" eavesdrop="true"/>',
-            '    <allow eavesdrop="true"/>',
-            '    <allow own="*"/>',
-            "  </policy>",
-            "</busconfig>",
-        ].join("\n"),
-    );
+    writeFileSync(busConfigPath, createBusConfig(busSocketPath));
 };
 
 const exitedMessage = (label: string, path: string, code: number | null, signal: NodeJS.Signals | null): string =>
@@ -383,7 +362,7 @@ const captureCompositorStderr = (child: ChildProcess, logPath: string): Captured
     const stderr = child.stderr;
 
     if (stderr === null) {
-        return { chunks: captured, stop: noVirtualSeat };
+        return { chunks: captured, logPath, stop: noVirtualSeat };
     }
 
     stderr.setEncoding("utf8");
@@ -404,6 +383,7 @@ const captureCompositorStderr = (child: ChildProcess, logPath: string): Captured
 
     return {
         chunks: captured,
+        logPath,
         stop: () => {
             stderr.removeListener("data", onData);
 
@@ -418,14 +398,15 @@ const captureCompositorStderr = (child: ChildProcess, logPath: string): Captured
 const compositorExitMessage = (
     code: number | null,
     signal: NodeJS.Signals | null,
-    capturedStderr: string[],
+    captured: CapturedStderr,
 ): string =>
     `[gtkx] the headless compositor exited (code ${String(code)}, signal ${signal ?? "null"}); ` +
-    `every Wayland client in this worker has been severed.\n${capturedStderr.join("")}`;
+    "every Wayland client in this worker has been severed. " +
+    `Its stderr log is kept at ${captured.logPath} until this worker exits.\n${captured.chunks.join("")}`;
 
-const watchCompositorExit = (child: ChildProcess, capturedStderr: string[]): (() => void) => {
+const watchCompositorExit = (child: ChildProcess, captured: CapturedStderr): (() => void) => {
     const report = (code: number | null, signal: NodeJS.Signals | null): void => {
-        process.stderr.write(compositorExitMessage(code, signal, capturedStderr));
+        process.stderr.write(compositorExitMessage(code, signal, captured));
     };
 
     child.on("exit", report);
@@ -457,10 +438,25 @@ const makeTeardown = (stops: (() => void)[]): (() => void) => {
     };
 };
 
+const createHeadlessRuntimeDirectory = (): string => {
+    const runtimeDir = mkdtempSync(join(tmpdir(), "gtkx-xdg-"));
+
+    try {
+        chmodSync(runtimeDir, 0o700);
+        const markerPath = join(runtimeDir, HEADLESS_RUNTIME_MARKER);
+        writeFileSync(markerPath, createHeadlessRuntimeMarker(runtimeDir), { flag: "wx", mode: 0o600 });
+        chmodSync(markerPath, 0o600);
+
+        return runtimeDir;
+    } catch (error) {
+        rmSync(runtimeDir, { recursive: true, force: true });
+        throw error;
+    }
+};
+
 const startHeadlessDisplay = async (options: HeadlessOptions): Promise<() => void> => {
     const env: EnvSnapshot = {};
-    const runtimeDir = mkdtempSync(join(tmpdir(), "gtkx-xdg-"));
-    chmodSync(runtimeDir, 0o700);
+    const runtimeDir = createHeadlessRuntimeDirectory();
     const spawned: ChildProcess[] = [];
 
     const removeRuntime = (): void => {
@@ -494,7 +490,7 @@ const startHeadlessDisplay = async (options: HeadlessOptions): Promise<() => voi
         const stopVirtualSeat = await attachVirtualSeat(compositor, compositorSocketPath);
         const stopNotifications = await startNotificationService(`unix:path=${busSocketPath}`);
         const capturedStderr = captureCompositorStderr(compositor.child, join(runtimeDir, "compositor.stderr.log"));
-        const stopExitWatch = watchCompositorExit(compositor.child, capturedStderr.chunks);
+        const stopExitWatch = watchCompositorExit(compositor.child, capturedStderr);
 
         return makeTeardown([
             stopExitWatch,

package/src/headless.ts

@@ -6,3 +6,9 @@ export {
     type CompositorId,
     type HeadlessOptions,
 } from "./headless-display.js";
+export {
+    findStaleHeadlessDisplays,
+    reapStaleHeadlessDisplays,
+    reapStaleHeadlessDisplaysAtStartup,
+    type StaleHeadlessDisplay,
+} from "./reap-headless-displays.js";

package/src/index.ts

@@ -5,6 +5,7 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { type HeadlessOptions, STATIC_HEADLESS_ENV } from "./headless-display.ts";
+import { reapStaleHeadlessDisplaysAtStartup } from "./reap-headless-displays.ts";
 
 /**
  * Options accepted by the GTKX Vitest plugin. Every headless display
@@ -37,11 +38,18 @@ const headlessPreloadSpecifier = (options: Partial<HeadlessOptions>): string =>
  * Wayland display. It configures the forks pool, injects the worker preload and
  * setup files, and sets the environment needed for headless GTK4 rendering.
  *
+ * Each worker's compositor, session bus, and private runtime directory are torn
+ * down when the worker exits, and a guard process tears them down as well when
+ * the worker or the Vitest process that launched it is killed with `SIGKILL`.
+ * Creating the plugin reaps stale `gtkx-xdg-*` runtime directories left behind
+ * by earlier runs, which `gtkx cleanup` also does on demand.
+ *
  * @param options Headless display settings (size, compositor) forwarded to each worker.
  * @returns A Vitest config plugin.
  */
 const gtkx = (options: PluginOptions = {}): Plugin => {
     assertSupportedNodeVersion();
+    reapStaleHeadlessDisplaysAtStartup();
     const { configFile, ...headlessOptions } = options;
     const loadConfig = createConfigLoader({ configFile });