ccqa 1.51.0 → 1.52.0

package/dist/spawn-ab-CR_Sr7wh.mjs

@@ -1,199 +0,0 @@
-import { createRequire } from "node:module";
-import { statSync } from "node:fs";
-import { delimiter, dirname, join } from "node:path";
-import { spawnSync } from "node:child_process";
-//#region src/runtime/agent-browser-bin.ts
-const require = createRequire(import.meta.url);
-function hasAgentBrowserShim(dir) {
-	try {
-		statSync(join(dir, "agent-browser"));
-		return true;
-	} catch {
-		return false;
-	}
-}
-/**
-* Walks up from `start` looking for a `node_modules/.bin/agent-browser` shim.
-* Returns the .bin directory containing the shim, or null if none is found.
-*/
-function findNodeModulesBin(start) {
-	let cur = start;
-	while (true) {
-		const candidate = join(cur, "node_modules", ".bin");
-		if (hasAgentBrowserShim(candidate)) return candidate;
-		const parent = dirname(cur);
-		if (parent === cur) return null;
-		cur = parent;
-	}
-}
-/** The shim-directory walk shared by every resolution below (no env override). */
-function resolveShimDir() {
-	const fromCwd = findNodeModulesBin(process.cwd());
-	if (fromCwd) return fromCwd;
-	const fromSelf = findNodeModulesBin(dirname(require.resolve("agent-browser/package.json")));
-	if (fromSelf) return fromSelf;
-	try {
-		const candidate = join(dirname(require.resolve("agent-browser/package.json")), "node_modules", ".bin");
-		if (hasAgentBrowserShim(candidate)) return candidate;
-	} catch {}
-	return null;
-}
-/**
-* INVARIANT: every agent-browser invocation in one ccqa process — the host
-* side (`spawnAB`: state load, replay probes, …) and the Claude subprocess
-* (via the PATH prepended by `pathWithAgentBrowserShim`) — must resolve to
-* the SAME binary. agent-browser runs one daemon per binary, and a state
-* loaded into one daemon's session is invisible to a same-named session on
-* another daemon, so a split resolution silently loses session restores.
-* Both entry points below therefore share one resolution order:
-* `CCQA_AB_BIN` (explicit override, e.g. the e2e harness or a dev build
-* driving a consumer project's agent-browser) → the peer-installed shim
-* (consumer project first, then ccqa's own tree).
-*/
-/**
-* Resolves the executable `spawnAB` should invoke. Falls back to the package
-* JS entry (resolvable whenever the peer dependency is installed) when no
-* shim directory exists; throws only if agent-browser is missing entirely.
-*/
-function resolveAgentBrowserBin() {
-	const override = process.env["CCQA_AB_BIN"];
-	if (override) return override;
-	const shimDir = resolveShimDir();
-	if (shimDir) return join(shimDir, "agent-browser");
-	return require.resolve("agent-browser/bin/agent-browser.js");
-}
-/**
-* Resolves the directory containing the `agent-browser` shim that npm/pnpm
-* exposes on PATH for the peer-installed package. Used by `ccqa trace` /
-* `ccqa run` to prepend this directory to PATH so the Claude subprocess can
-* invoke `agent-browser ...` without requiring a global install.
-*
-* Returns null if agent-browser cannot be located.
-*/
-function resolveAgentBrowserBinDir() {
-	const override = process.env["CCQA_AB_BIN"];
-	if (override) return dirname(override);
-	return resolveShimDir();
-}
-/**
-* Returns a PATH string with the agent-browser shim directory prepended,
-* so `agent-browser ...` resolves without a global install. Falls back to
-* the original PATH when the package can't be resolved.
-*/
-function pathWithAgentBrowserShim(currentPath) {
-	const path = currentPath ?? "";
-	const dir = resolveAgentBrowserBinDir();
-	if (!dir) return path;
-	if (path.split(delimiter).includes(dir)) return path;
-	return dir + delimiter + path;
-}
-/**
-* Confirms before launching Claude that an `agent-browser` shim is reachable
-* via PATH. We do this up front so a missing peer dependency fails fast with
-* a clear message, instead of Claude burning tokens probing the system with
-* `which`, `find`, `npm install`, etc.
-*
-* The `resolver` argument is for tests; production calls take no args.
-*/
-function assertAgentBrowserAvailable(resolver = resolveAgentBrowserBinDir) {
-	const probe = process.env["CCQA_AB_BIN"] ?? (() => {
-		const dir = resolver();
-		return dir === null ? null : join(dir, "agent-browser");
-	})();
-	if (!probe) throw new AgentBrowserUnavailableError();
-	try {
-		const s = statSync(probe);
-		if (!s.isFile() && !s.isSymbolicLink()) throw new AgentBrowserUnavailableError();
-	} catch {
-		throw new AgentBrowserUnavailableError();
-	}
-	return dirname(probe);
-}
-var AgentBrowserUnavailableError = class extends Error {
-	constructor() {
-		super("agent-browser binary not found on PATH");
-		this.name = "AgentBrowserUnavailableError";
-	}
-};
-/** Human-readable explanation shown to the user when the guard fires. */
-function formatAgentBrowserUnavailableMessage() {
-	return [
-		"agent-browser is not installed or not on PATH.",
-		"",
-		"ccqa drives the browser via the peer-installed `agent-browser` package.",
-		"Install it in this project:",
-		"",
-		"  pnpm add -D agent-browser",
-		"  # or",
-		"  npm install -D agent-browser",
-		"",
-		"If it is already installed, make sure you are running ccqa from the",
-		"project root (or via your package runner, e.g. `pnpm exec ccqa ...`)."
-	].join("\n");
-}
-//#endregion
-//#region src/runtime/spawn-ab.ts
-const AB = resolveAgentBrowserBin();
-const EAGAIN_PATTERN = /Resource temporarily unavailable|os error 35/i;
-const EAGAIN_TOTAL_BUDGET_MS = 3e4;
-const EAGAIN_BACKOFF_MS = [
-	100,
-	200,
-	300,
-	500,
-	700,
-	1e3,
-	1500,
-	2e3,
-	2500,
-	3e3,
-	3e3,
-	3e3,
-	3e3,
-	3e3,
-	3e3
-];
-const PROCESS_HARD_TIMEOUT_MS = 35e3;
-function sleepSync(ms) {
-	const buf = new SharedArrayBuffer(4);
-	Atomics.wait(new Int32Array(buf), 0, 0, ms);
-}
-function spawnABOnce(args) {
-	const result = spawnSync(AB, args, {
-		stdio: "pipe",
-		timeout: PROCESS_HARD_TIMEOUT_MS
-	});
-	const wedged = result.error?.code === "ETIMEDOUT";
-	return {
-		status: result.status,
-		stdout: result.stdout?.toString() ?? "",
-		stderr: (result.stderr?.toString() ?? "") + (wedged ? "\n[ccqa] agent-browser killed after hard timeout" : ""),
-		wedged
-	};
-}
-/**
-* Invoke `agent-browser` once and return its exit status/stdout/stderr,
-* retrying internally up to ~30s while the daemon's state file is in the
-* "Resource temporarily unavailable" race window. Used by both the test
-* runtime (`test-helpers.ts`) and the post-trace replay validation
-* (`replay-validate.ts`). Kept out of `test-helpers.ts` because that
-* module is also the public surface for generated test scripts — exposing
-* the raw spawner there would widen the contract for end users.
-*/
-function spawnAB(args) {
-	let result = spawnABOnce(args);
-	let elapsed = 0;
-	let attempt = 0;
-	while (result.status !== 0 && elapsed < EAGAIN_TOTAL_BUDGET_MS) {
-		const combined = `${result.stdout}\n${result.stderr}`;
-		if (!EAGAIN_PATTERN.test(combined)) return result;
-		const wait = EAGAIN_BACKOFF_MS[attempt] ?? 3e3;
-		sleepSync(wait);
-		elapsed += wait;
-		attempt++;
-		result = spawnABOnce(args);
-	}
-	return result;
-}
-//#endregion
-export { formatAgentBrowserUnavailableMessage as a, assertAgentBrowserAvailable as i, spawnAB as n, pathWithAgentBrowserShim as o, AgentBrowserUnavailableError as r, resolveAgentBrowserBin as s, sleepSync as t };