ccqa 1.3.0 → 1.3.1

package/dist/bin/ccqa.mjs

@@ -679,10 +679,10 @@ function bundledVitestConfigPath() {
 }
 //#endregion
 //#region src/runtime/spawn-vitest.ts
-const require$1 = createRequire(import.meta.url);
+const require$2 = createRequire(import.meta.url);
 function resolveVitestBin() {
-	const pkgPath = require$1.resolve("vitest/package.json");
-	const pkg = require$1(pkgPath);
+	const pkgPath = require$2.resolve("vitest/package.json");
+	const pkg = require$2(pkgPath);
 	const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.vitest;
 	if (!binRel) throw new Error(`vitest package.json has no bin entry (resolved at ${pkgPath})`);
 	return resolve(dirname(pkgPath), binRel);
@@ -1194,6 +1194,50 @@ function opt(key, value) {
 	return value ? { [key]: value } : {};
 }
 //#endregion
+//#region src/claude/native-binary.ts
+const require$1 = createRequire(import.meta.url);
+/**
+* The agent SDK launches Claude through a native `claude` binary that ships in
+* a per-platform package (`@anthropic-ai/claude-agent-sdk-<platform>-<cpu>`),
+* declared as an *optional* dependency of the SDK. Optional means a consumer's
+* lockfile can omit it without any install-time error — and then every Claude
+* call fails at runtime with a message that never reaches our logs. Resolving
+* the package up front lets us say so once, in a line that names the fix.
+*
+* ccqa's own package.json repeats these packages in `optionalDependencies` for
+* the same reason: a second declaration gives the resolver another chance to
+* record them. Keep that list's version range in step with the SDK's.
+*/
+function nativeBinaryPackage(platform = process.platform, arch = process.arch, musl = isMusl(platform)) {
+	return `@anthropic-ai/claude-agent-sdk-${platform}-${arch === "arm64" ? "arm64" : "x64"}${platform === "linux" && musl ? "-musl" : ""}`;
+}
+/**
+* musl builds (Alpine and friends) need their own binary. Node doesn't expose
+* the libc flavour directly; the absence of `glibcVersionRuntime` in the
+* process report is the usual proxy.
+*/
+function isMusl(platform) {
+	if (platform !== "linux") return false;
+	return !(process.report?.getReport?.())?.header?.glibcVersionRuntime;
+}
+/**
+* Name of the platform package this host needs, or `null` when it resolves.
+* The per-platform packages have no `exports`, so the manifest is reachable.
+*/
+function missingNativeBinaryPackage(resolve = require$1.resolve) {
+	const pkg = nativeBinaryPackage();
+	try {
+		resolve(`${pkg}/package.json`);
+		return null;
+	} catch {
+		return pkg;
+	}
+}
+/** Advice shown when the binary is absent — the package name plus how to fix it. */
+function missingNativeBinaryMessage(pkg) {
+	return `${pkg} is not installed. The Claude Agent SDK needs it to start Claude on this platform, so every Claude-backed command (run in live mode, drift, diagnose) will fail. It ships as an optional dependency of the SDK, which a lockfile can drop silently: reinstall without omitting optional dependencies, or add it to your project as a direct dependency pinned to the same version as @anthropic-ai/claude-agent-sdk.`;
+}
+//#endregion
 //#region src/claude/invoke.ts
 function resolveModel(explicit) {
 	if (explicit) return explicit;
@@ -1230,6 +1274,18 @@ function resolveEndpointEnv() {
 	}
 	return endpointEnv;
 }
+let nativeBinaryWarned = false;
+/**
+* Warn once per process when the SDK's per-platform native binary is missing:
+* every Claude call is about to fail, and the opaque per-step errors alone are
+* expensive to trace back to a lockfile that dropped an optional dependency.
+*/
+function warnOnceIfNativeBinaryMissing() {
+	if (nativeBinaryWarned) return;
+	nativeBinaryWarned = true;
+	const missing = missingNativeBinaryPackage();
+	if (missing) warn(missingNativeBinaryMessage(missing));
+}
 async function invokeClaudeStreaming(options, onEvent) {
 	const { prompt, systemPrompt, allowedTools, disableBuiltinTools = false, disableThinking = false, maxTurns, env, model, cwd, onAbAction, onAbActionFailed, silenceBashLog = false, relaxAbConstraints = false } = options;
 	const resolvedModel = resolveModel(model);
@@ -1312,8 +1368,10 @@ async function invokeClaudeStreaming(options, onEvent) {
 			}] }]
 		} : void 0
 	};
+	warnOnceIfNativeBinaryMissing();
 	let result = "";
 	let isError = false;
+	let errorDetail = null;
 	let cost = {
 		totalCostUsd: null,
 		durationMs: null,
@@ -1336,18 +1394,24 @@ async function invokeClaudeStreaming(options, onEvent) {
 				}
 			}
 			if (msg.type === "result") {
-				result = msg.subtype === "success" ? msg.result : "";
 				isError = msg.is_error ?? false;
+				if (msg.subtype === "success") result = msg.result;
+				else {
+					result = "";
+					errorDetail = `SDK reported ${msg.subtype}`;
+				}
 				cost = extractInvocationCost(msg);
 			}
 		}
 	} catch (err) {
 		isError = true;
-		if (!result) result = err instanceof Error ? err.message : String(err);
+		errorDetail = err instanceof Error ? err.message : String(err);
+		if (!result) result = errorDetail;
 	}
 	return {
 		result,
 		isError,
+		errorDetail,
 		cost
 	};
 }
@@ -5101,6 +5165,7 @@ async function runLiveExecutor(input) {
 		const transcriptParts = [];
 		const commandParts = [];
 		let isError = false;
+		let errorDetail = null;
 		let cost = emptyStepCost();
 		try {
 			const result = await invokeClaudeStreaming({
@@ -5120,6 +5185,7 @@ async function runLiveExecutor(input) {
 				}
 			});
 			isError = result.isError;
+			errorDetail = result.errorDetail;
 			cost = {
 				totalCostUsd: result.cost.totalCostUsd,
 				durationApiMs: result.cost.durationApiMs,
@@ -5132,7 +5198,8 @@ async function runLiveExecutor(input) {
 			};
 		} catch (err) {
 			isError = true;
-			transcriptParts.push(`[ccqa] invokeClaudeStreaming threw: ${err instanceof Error ? err.message : String(err)}`);
+			errorDetail = err instanceof Error ? err.message : String(err);
+			transcriptParts.push(`[ccqa] invokeClaudeStreaming threw: ${errorDetail}`);
 		}
 		const transcript = transcriptParts.join("\n");
 		const after = takeScreenshot(input.sessionName, paths.afterPng, { fullPage: true });
@@ -5141,6 +5208,7 @@ async function runLiveExecutor(input) {
 		const { status, reasoning } = judgeStepOutcome({
 			step,
 			isError,
+			errorDetail,
 			judged: findLastStepResult(transcript)
 		});
 		return {
@@ -5219,11 +5287,14 @@ function sumStepCosts(steps) {
 * Kept as a pure helper so the executor loop stays readable and the
 * branches are individually testable.
 */
-function judgeStepOutcome({ step, isError, judged }) {
-	if (isError) return {
-		status: "failed",
-		reasoning: judged?.reasoning ? `agent error; last reasoning: ${judged.reasoning}` : "Claude invocation returned an error"
-	};
+function judgeStepOutcome({ step, isError, errorDetail, judged }) {
+	if (isError) {
+		const detail = errorDetail ? `: ${errorDetail}` : "";
+		return {
+			status: "failed",
+			reasoning: judged?.reasoning ? `agent error${detail}; last reasoning: ${judged.reasoning}` : `Claude invocation returned an error${detail}`
+		};
+	}
 	if (!judged) return {
 		status: "failed",
 		reasoning: "STEP_RESULT missing"

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {
@@ -34,6 +34,16 @@
     "yaml": "^2.9.0",
     "zod": "^4.3.6"
   },
+  "optionalDependencies": {
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "^0.3.215"
+  },
   "peerDependencies": {
     "agent-browser": "*",
     "vitest": ">=2.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {
@@ -34,6 +34,16 @@
     "yaml": "^2.9.0",
     "zod": "^4.3.6"
   },
+  "optionalDependencies": {
+    "@anthropic-ai/claude-agent-sdk-darwin-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-darwin-x64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-x64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-win32-arm64": "^0.3.215",
+    "@anthropic-ai/claude-agent-sdk-win32-x64": "^0.3.215"
+  },
   "peerDependencies": {
     "agent-browser": "*",
     "vitest": ">=2.0.0"