@cleaver/breakcheck 0.2.4 → 0.3.0

package/dist/cli/site-environment.js

@@ -0,0 +1,231 @@
+import { spawn } from "node:child_process";
+function launchCommand(command, cwd, environment) {
+    const [executable, ...arguments_] = command;
+    if (executable === undefined || executable.trim().length === 0) {
+        throw new Error("A configured command must include an executable.");
+    }
+    const child = spawn(executable, arguments_, {
+        cwd,
+        env: environment,
+        detached: process.platform !== "win32",
+        shell: false,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    child.stdout?.on("data", (chunk) => {
+        process.stderr.write(chunk);
+    });
+    child.stderr?.on("data", (chunk) => {
+        process.stderr.write(chunk);
+    });
+    let result;
+    const closed = new Promise((resolve) => {
+        child.once("close", (code, signal) => {
+            result = { code, signal };
+            resolve(result);
+        });
+    });
+    const started = new Promise((resolve, reject) => {
+        child.once("spawn", resolve);
+        child.once("error", reject);
+    });
+    return started.then(() => ({
+        child,
+        closed,
+        getResult: () => result,
+    }));
+}
+function formatCommand(command) {
+    return command.map((argument) => JSON.stringify(argument)).join(" ");
+}
+async function runCommand(command, cwd, environment, signal) {
+    signal?.throwIfAborted();
+    const processHandle = await launchCommand(command, cwd, environment);
+    let result;
+    let onAbort;
+    try {
+        if (signal === undefined) {
+            result = await processHandle.closed;
+        }
+        else {
+            const aborted = new Promise((resolve) => {
+                onAbort = () => resolve(undefined);
+                signal.addEventListener("abort", onAbort, { once: true });
+                if (signal.aborted)
+                    onAbort();
+            });
+            const completed = await Promise.race([processHandle.closed, aborted]);
+            if (completed === undefined) {
+                await stopForegroundProcess(processHandle);
+                signal.throwIfAborted();
+                throw new Error("Command was interrupted.");
+            }
+            result = completed;
+        }
+    }
+    finally {
+        if (signal !== undefined && onAbort !== undefined) {
+            signal.removeEventListener("abort", onAbort);
+        }
+    }
+    if (result.code !== 0) {
+        throw new Error(`Command failed (${result.code ?? result.signal}): ${formatCommand(command)}`);
+    }
+}
+function sendSignal(handle, signal) {
+    const processId = handle.child.pid;
+    if (processId === undefined || handle.getResult() !== undefined)
+        return;
+    try {
+        if (process.platform !== "win32") {
+            process.kill(-processId, signal);
+        }
+        else {
+            handle.child.kill(signal);
+        }
+    }
+    catch (error) {
+        if (!(error instanceof Error &&
+            "code" in error &&
+            error.code === "ESRCH")) {
+            throw error;
+        }
+    }
+}
+async function stopForegroundProcess(handle, gracePeriodMs = 5_000) {
+    if (handle.getResult() !== undefined)
+        return;
+    sendSignal(handle, "SIGTERM");
+    const graceful = await Promise.race([
+        handle.closed.then(() => true),
+        new Promise((resolve) => setTimeout(() => resolve(false), gracePeriodMs)),
+    ]);
+    if (graceful)
+        return;
+    sendSignal(handle, "SIGKILL");
+    await handle.closed;
+}
+async function waitUntilReady(server, baseUrl, processHandle, signal) {
+    const target = new URL(server.readyPath ?? "/", baseUrl).href;
+    const deadline = Date.now() + (server.timeoutMs ?? 30_000);
+    let lastError = "no HTTP response";
+    while (Date.now() < deadline) {
+        signal.throwIfAborted();
+        const result = processHandle.getResult();
+        if (result && result.code !== 0) {
+            throw new Error(`Server start command exited (${result.code ?? result.signal}) before the site became ready.`);
+        }
+        try {
+            const response = await fetch(target, {
+                signal: AbortSignal.any([signal, AbortSignal.timeout(1_000)]),
+            });
+            if (response.status < 500) {
+                await response.body?.cancel();
+                return;
+            }
+            lastError = `HTTP ${response.status}`;
+            await response.body?.cancel();
+        }
+        catch (error) {
+            signal.throwIfAborted();
+            lastError = error instanceof Error ? error.message : String(error);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    throw new Error(`Site did not become ready at ${target} within ${server.timeoutMs ?? 30_000}ms (${lastError}).`);
+}
+/** Runs configured preparation and server commands around a site operation. */
+export async function withCheckEnvironment(check, baseUrl, useExistingServer, operation, options = {}) {
+    const server = check.server;
+    const cwd = server?.cwd ?? check.configDirectory;
+    const environment = {
+        ...process.env,
+        ...(server?.env ?? {}),
+    };
+    const controller = new AbortController();
+    let processHandle;
+    let startAttempted = false;
+    let interruptError;
+    let childSignal = "SIGTERM";
+    let workFinished = false;
+    const interrupt = (label) => {
+        if (interruptError !== undefined || workFinished)
+            return;
+        childSignal = label === "SIGINT" || label === "SIGTERM" ? label : "SIGTERM";
+        interruptError = new Error(`Site check interrupted by ${label}.`);
+        controller.abort(interruptError);
+        if (processHandle !== undefined) {
+            sendSignal(processHandle, childSignal);
+        }
+    };
+    const onInterrupt = () => interrupt("SIGINT");
+    const onTerminate = () => interrupt("SIGTERM");
+    const onExternalAbort = () => interrupt("external cancellation");
+    const signals = options.signals ?? process;
+    signals.on("SIGINT", onInterrupt);
+    signals.on("SIGTERM", onTerminate);
+    options.signal?.addEventListener("abort", onExternalAbort, { once: true });
+    let outcome;
+    try {
+        if (options.signal?.aborted)
+            interrupt("external cancellation");
+        if (!useExistingServer) {
+            for (const command of check.prepare ?? []) {
+                await runCommand(command, cwd, environment, controller.signal);
+            }
+        }
+        if (!useExistingServer && server !== undefined) {
+            const launched = await launchCommand(server.start, cwd, environment);
+            processHandle = launched;
+            startAttempted = true;
+            if (interruptError !== undefined)
+                sendSignal(launched, childSignal);
+            await waitUntilReady(server, baseUrl, launched, controller.signal);
+        }
+        controller.signal.throwIfAborted();
+        const value = await operation(controller.signal);
+        controller.signal.throwIfAborted();
+        outcome = { ok: true, value };
+    }
+    catch (error) {
+        outcome = { ok: false, error: interruptError ?? error };
+    }
+    finally {
+        workFinished = true;
+    }
+    let cleanupError;
+    if (processHandle !== undefined) {
+        try {
+            await stopForegroundProcess(processHandle, options.stopGracePeriodMs);
+        }
+        catch (error) {
+            cleanupError = error;
+        }
+    }
+    if (startAttempted && server?.stop !== undefined) {
+        try {
+            await runCommand(server.stop, cwd, environment);
+        }
+        catch (error) {
+            cleanupError =
+                cleanupError === undefined
+                    ? error
+                    : new AggregateError([cleanupError, error], "Server cleanup failed.");
+        }
+    }
+    signals.removeListener("SIGINT", onInterrupt);
+    signals.removeListener("SIGTERM", onTerminate);
+    options.signal?.removeEventListener("abort", onExternalAbort);
+    if (cleanupError !== undefined) {
+        if (!outcome.ok) {
+            throw new AggregateError([outcome.error, cleanupError], "Site check failed and server cleanup also failed.");
+        }
+        throw cleanupError;
+    }
+    if (!outcome.ok) {
+        if (interruptError !== undefined)
+            throw interruptError;
+        throw outcome.error;
+    }
+    return outcome.value;
+}
+//# sourceMappingURL=site-environment.js.map

package/dist/cli/site-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-environment.js","sourceRoot":"","sources":["../../src/cli/site-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAsB9D,SAAS,aAAa,CACpB,OAAuB,EACvB,GAAW,EACX,WAA8B;IAE9B,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC;IAC5C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE;QAC1C,GAAG;QACH,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;QACtC,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,IAAI,MAAiC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QACpD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzB,KAAK;QACL,MAAM;QACN,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,OAAuB;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,OAAuB,EACvB,GAAW,EACX,WAA8B,EAC9B,MAAoB;IAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACrE,IAAI,MAAqB,CAAC;IAC1B,IAAI,OAAiC,CAAC;IACtC,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;gBACjD,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACnC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1D,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,qBAAqB,CAAC,aAAa,CAAC,CAAC;gBAC3C,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,MAAM,aAAa,CAAC,OAAO,CAAC,EAAE,CAC9E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAuB,EAAE,MAAsB;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IACnC,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,SAAS;QAAE,OAAO;IACxE,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CACH,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACf,KAAK,CAAC,IAAI,KAAK,OAAO,CACvB,EAAE,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,MAAuB,EACvB,aAAa,GAAG,KAAK;IAErB,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,SAAS;QAAE,OAAO;IAC7C,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC9B,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAChD;KACF,CAAC,CAAC;IACH,IAAI,QAAQ;QAAE,OAAO;IAErB,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,MAAM,MAAM,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAyD,EACzD,OAAe,EACf,aAA8B,EAC9B,MAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;IAC3D,IAAI,SAAS,GAAG,kBAAkB,CAAC;IAEnC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,iCAAiC,CAC9F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;gBACnC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;aAC9D,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC1B,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,SAAS,GAAG,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,WAAW,MAAM,CAAC,SAAS,IAAI,MAAM,OAAO,SAAS,IAAI,CAChG,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAiC,EACjC,OAAe,EACf,iBAA0B,EAC1B,SAA8C,EAC9C,OAAO,GAIH,EAAE;IAEN,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC;IACjD,MAAM,WAAW,GAAG;QAClB,GAAG,OAAO,CAAC,GAAG;QACd,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;KACvB,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,aAA0C,CAAC;IAC/C,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,cAAiC,CAAC;IACtC,IAAI,WAAW,GAAmB,SAAS,CAAC;IAC5C,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE;QAClC,IAAI,cAAc,KAAK,SAAS,IAAI,YAAY;YAAE,OAAO;QACzD,WAAW,GAAG,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,cAAc,GAAG,IAAI,KAAK,CAAC,6BAA6B,KAAK,GAAG,CAAC,CAAC;QAClE,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACjC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,UAAU,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3E,IAAI,OAA+D,CAAC;IACpE,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAChE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBAC1C,MAAM,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;YACrE,aAAa,GAAG,QAAQ,CAAC;YACzB,cAAc,GAAG,IAAI,CAAC;YACtB,IAAI,cAAc,KAAK,SAAS;gBAAE,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACpE,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QAED,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjD,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnC,OAAO,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,IAAI,KAAK,EAAE,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,IAAI,YAAqB,CAAC;IAC1B,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,qBAAqB,CAAC,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,cAAc,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY;gBACV,YAAY,KAAK,SAAS;oBACxB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAE9D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,cAAc,CACtB,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,EAC7B,mDAAmD,CACpD,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,IAAI,cAAc,KAAK,SAAS;YAAE,MAAM,cAAc,CAAC;QACvD,MAAM,OAAO,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC"}

package/dist/cli/url-manifest.d.ts

@@ -0,0 +1,18 @@
+import { Readable } from "node:stream";
+export type UrlManifestIssue = {
+    type: "manifest";
+    source: string;
+    message: string;
+} | {
+    type: "entry";
+    source: string;
+    line: number;
+    value: string;
+    message: string;
+};
+export interface UrlManifestParseResult {
+    paths: string[];
+    issues: UrlManifestIssue[];
+}
+export declare function readUrlManifest(source: string, stdin?: Readable): Promise<string>;
+export declare function parseUrlManifest(content: string, baseUrl: string, source: string): UrlManifestParseResult;

package/dist/cli/url-manifest.js

@@ -0,0 +1,63 @@
+import { readFile } from "node:fs/promises";
+import { resolveUrlPaths } from "@cleaver/breakcheck-core";
+export async function readUrlManifest(source, stdin = process.stdin) {
+    try {
+        if (source !== "-") {
+            return await readFile(source, "utf8");
+        }
+        stdin.setEncoding("utf8");
+        const chunks = [];
+        const input = stdin;
+        for await (const chunk of input) {
+            if (typeof chunk === "string") {
+                chunks.push(chunk);
+            }
+            else if (chunk instanceof Uint8Array) {
+                chunks.push(Buffer.from(chunk).toString("utf8"));
+            }
+            else {
+                throw new Error("stdin produced a non-text chunk");
+            }
+        }
+        return chunks.join("");
+    }
+    catch (error) {
+        const sourceLabel = source === "-" ? "stdin" : source;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to read URL manifest from ${sourceLabel}: ${message}`, {
+            cause: error,
+        });
+    }
+}
+export function parseUrlManifest(content, baseUrl, source) {
+    const entries = content
+        .split(/\r?\n/)
+        .map((line, index) => ({ line: index + 1, value: line.trim() }))
+        .filter(({ value }) => value !== "" && !value.startsWith("#"));
+    const resolution = resolveUrlPaths(baseUrl, entries.map(({ value }) => value));
+    const issues = resolution.issues.map((issue) => toManifestIssue(issue, entries, source));
+    return {
+        paths: resolution.paths,
+        issues,
+    };
+}
+function toManifestIssue(issue, entries, source) {
+    if (issue.type === "entry") {
+        const entry = entries[issue.index];
+        return {
+            type: "entry",
+            source,
+            line: entry?.line ?? issue.index + 1,
+            value: entry?.value ?? issue.value,
+            message: issue.message,
+        };
+    }
+    return {
+        type: "manifest",
+        source,
+        message: issue.type === "base"
+            ? `${issue.message}: ${issue.value}`
+            : issue.message,
+    };
+}
+//# sourceMappingURL=url-manifest.js.map

package/dist/cli/url-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-manifest.js","sourceRoot":"","sources":["../../src/cli/url-manifest.ts"],"names":[],"mappings":"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"}

package/dist/cli/utils.d.ts

@@ -4,6 +4,7 @@
 export declare function configureLogger(options: {
     jsonLogs?: boolean;
     noJsonLogs?: boolean;
+    silent?: boolean;
 }): import("pino").Logger<never, boolean>;
 /**
  * Get the current CLI logger instance

package/dist/cli/utils.js

@@ -1,4 +1,4 @@
-import { createLogger, logger } from "@cleaver/breakcheck-core";
+import { configureLogger as configureCoreLogger, logger, } from "@cleaver/breakcheck-core";
 // Global logger instance that can be reconfigured
 let cliLogger = logger;
 /**
@@ -9,7 +9,10 @@ export function configureLogger(options) {
     // --json-logs takes precedence over --no-json-logs
     const useJsonLogs = options.jsonLogs || false;
     // Create a new logger instance with the specified configuration
-    cliLogger = createLogger({ useJsonLogs });
+    cliLogger = configureCoreLogger({
+        useJsonLogs,
+        ...(options.silent ? { level: "silent" } : {}),
+    });
     return cliLogger;
 }
 /**

package/dist/cli/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEhE,kDAAkD;AAClD,IAAI,SAAS,GAAG,MAAM,CAAC;AAEvB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAG/B;IACC,uCAAuC;IACvC,mDAAmD;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAE9C,gEAAgE;IAChE,SAAS,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE1C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,IAAI,mBAAmB,EACtC,MAAM,GACP,MAAM,0BAA0B,CAAC;AAElC,kDAAkD;AAClD,IAAI,SAAS,GAAG,MAAM,CAAC;AAEvB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAI/B;IACC,uCAAuC;IACvC,mDAAmD;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAE9C,gEAAgE;IAChE,SAAS,GAAG,mBAAmB,CAAC;QAC9B,WAAW;QACX,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.js

@@ -2,8 +2,14 @@
 import { createRequire } from "node:module";
 import { InteractiveCommand } from "interactive-commander";
 import { compareCommand } from "./cli/commands/compare.js";
+import { baselineCommand } from "./cli/commands/baseline.js";
+import { checkCommand } from "./cli/commands/check.js";
+import { cleanCommand } from "./cli/commands/clean.js";
+import { compileCommand } from "./cli/commands/compile.js";
 import { helpCommand } from "./cli/commands/help.js";
+import { initCommand } from "./cli/commands/init.js";
 import { listSnapshotsCommand } from "./cli/commands/list-snapshots.js";
+import { newCommand } from "./cli/commands/new.js";
 import { snapshotCommand } from "./cli/commands/snapshot.js";
 import { viewCommand } from "./cli/commands/view.js";
 const require = createRequire(import.meta.url);
@@ -14,10 +20,18 @@ const program = new InteractiveCommand();
 program
     .name("breakcheck")
     .description("A tool for comparing website states before and after changes")
+    .option("--config <file>", "Use this configuration file instead of discovering one")
+    .option("--no-config", "Disable project configuration discovery")
     .version(packageJson.version);
 // Add the commands to the program
 program.addCommand(snapshotCommand);
+program.addCommand(checkCommand);
+program.addCommand(baselineCommand);
 program.addCommand(compareCommand);
+program.addCommand(cleanCommand);
+program.addCommand(compileCommand);
+program.addCommand(initCommand);
+program.addCommand(newCommand);
 program.addCommand(listSnapshotsCommand);
 program.addCommand(viewCommand);
 program.addCommand(helpCommand);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,0BAA0B;AAC1B,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAEzC,wBAAwB;AACxB,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAEhC,kCAAkC;AAClC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,6EAA6E;AAC7E,0EAA0E;AAC1E,+DAA+D;AAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;KAAM,CAAC;IACN,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,0BAA0B;AAC1B,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAEzC,wBAAwB;AACxB,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,MAAM,CACL,iBAAiB,EACjB,wDAAwD,CACzD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAEhC,kCAAkC;AAClC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,6EAA6E;AAC7E,0EAA0E;AAC1E,+DAA+D;AAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;KAAM,CAAC;IACN,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleaver/breakcheck",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -17,7 +17,8 @@
   "homepage": "https://github.com/cleaver/breakcheck",
   "bugs": "https://github.com/cleaver/breakcheck/issues",
   "files": [
-    "dist"
+    "dist",
+    "agent-guide.md"
   ],
   "bin": {
     "breakcheck": "dist/index.js"
@@ -28,11 +29,11 @@
     "start:test-server:after": "node src/__test_server__/server-after.js"
   },
   "dependencies": {
-    "@cleaver/breakcheck-core": "^0.2.4",
-    "commander": "^12.1.0",
-    "ejs": "^3.1.10",
-    "express": "^4.22.2",
+    "@cleaver/breakcheck-core": "^0.3.0",
+    "commander": "^14.0.3",
+    "ejs": "^7.0.1",
+    "express": "^5.3.0",
     "interactive-commander": "^0.6.0",
-    "pino-pretty": "^11.2.1"
+    "pino-pretty": "^13.2.0"
   }
 }