ccqa 0.1.5 → 0.3.2

package/dist/runtime/vitest.config.mjs

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+//#region src/runtime/vitest.config.ts
+var vitest_config_default = defineConfig({ test: {
+	environment: "node",
+	globals: false
+} });
+//#endregion
+export { vitest_config_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "0.1.5",
+  "version": "0.3.2",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {
@@ -12,14 +12,16 @@
     "url": "https://github.com/shibukazu/ccqa/issues"
   },
   "bin": {
-    "ccqa": "./bin/ccqa.ts"
+    "ccqa": "./dist/bin/ccqa.mjs"
   },
   "exports": {
-    "./test-helpers": "./src/runtime/test-helpers.ts"
+    "./test-helpers": {
+      "types": "./dist/runtime/test-helpers.d.mts",
+      "import": "./dist/runtime/test-helpers.mjs"
+    }
   },
   "files": [
-    "bin/",
-    "src/"
+    "dist/"
   ],
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.87",
@@ -29,8 +31,8 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "vitest": ">=2.0.0",
-    "agent-browser": "*"
+    "agent-browser": "*",
+    "vitest": ">=2.0.0"
   },
   "peerDependenciesMeta": {
     "agent-browser": {
@@ -41,9 +43,28 @@
     }
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/node": "^22",
+    "tsdown": "^0.21.9",
+    "typescript": "^5",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "node --experimental-strip-types ./bin/ccqa.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run src/",
+    "test:e2e": "vitest run tests/e2e",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=22.6"
+    }
   },
-  "trustedDependencies": [
-    "agent-browser"
-  ]
+  "packageManager": "pnpm@10.1.0"
 }

package/bin/ccqa.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-import "../src/cli/index.ts";

package/src/claude/invoke.test.ts

@@ -1,167 +0,0 @@
-import { describe, test, expect } from "bun:test";
-import { extractAbActionFromBashCommand, isBlockedAbSubcommand, hasRefSelector, shellTokenize } from "./invoke.ts";
-
-describe("extractAbActionFromBashCommand", () => {
-  test("returns null for non-agent-browser commands", () => {
-    expect(extractAbActionFromBashCommand("ls -la")).toBeNull();
-    expect(extractAbActionFromBashCommand("echo hello")).toBeNull();
-  });
-
-  test("parses cookies clear", () => {
-    expect(
-      extractAbActionFromBashCommand("agent-browser --session s1 cookies clear"),
-    ).toBe("AB_ACTION|cookies_clear");
-  });
-
-  test("parses open", () => {
-    expect(
-      extractAbActionFromBashCommand("agent-browser --session s1 open https://example.com"),
-    ).toBe("AB_ACTION|open|https://example.com");
-  });
-
-  test("parses click with quoted selector", () => {
-    expect(
-      extractAbActionFromBashCommand(`agent-browser --session s1 click "[aria-label='Submit']" "Submit"`),
-    ).toBe("AB_ACTION|click|[aria-label='Submit']|Submit");
-  });
-
-  test("parses fill", () => {
-    expect(
-      extractAbActionFromBashCommand(`agent-browser --session s1 fill "[placeholder='Email']" "test@example.com" "Email"`),
-    ).toBe("AB_ACTION|fill|[placeholder='Email']|test@example.com|Email");
-  });
-
-  test("parses snapshot as null", () => {
-    expect(
-      extractAbActionFromBashCommand("agent-browser --session s1 snapshot"),
-    ).toBeNull();
-  });
-
-  test("parses press", () => {
-    expect(
-      extractAbActionFromBashCommand("agent-browser --session s1 press Enter"),
-    ).toBe("AB_ACTION|press|Enter");
-  });
-
-  test("parses wait", () => {
-    expect(
-      extractAbActionFromBashCommand(`agent-browser --session s1 wait --text "Done"`),
-    ).toBe("AB_ACTION|wait|--text|Done");
-  });
-});
-
-describe("isBlockedAbSubcommand", () => {
-  test("blocks eval with session", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 eval "document.querySelector('.btn').click()"`)).toBe(true);
-  });
-
-  test("blocks js with session", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 js "window.scrollTo(0, 100)"`)).toBe(true);
-  });
-
-  test("blocks eval without session flag", () => {
-    expect(isBlockedAbSubcommand(`agent-browser eval "document.click()"`)).toBe(true);
-  });
-
-  test("does not block click", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 click "[aria-label='Submit']"`)).toBe(false);
-  });
-
-  test("does not block snapshot", () => {
-    expect(isBlockedAbSubcommand("agent-browser --session s1 snapshot")).toBe(false);
-  });
-
-  test("does not block fill", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 fill "[placeholder='Email']" "test@example.com"`)).toBe(false);
-  });
-
-  test("blocks find command", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 find text "Select category" click`)).toBe(true);
-  });
-
-  test("blocks label command", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 label "Settings" click`)).toBe(true);
-  });
-
-  test("blocks textbox command", () => {
-    expect(isBlockedAbSubcommand(`agent-browser --session s1 textbox "Search"`)).toBe(true);
-  });
-
-  test("does not block non-agent-browser commands", () => {
-    expect(isBlockedAbSubcommand("ls -la")).toBe(false);
-    expect(isBlockedAbSubcommand("echo hello")).toBe(false);
-  });
-});
-
-describe("hasRefSelector", () => {
-  test("detects @ref in click", () => {
-    expect(hasRefSelector(`agent-browser --session s1 click "@e14"`)).toBe(true);
-  });
-
-  test("detects @ref in check", () => {
-    expect(hasRefSelector(`agent-browser --session s1 check @e7`)).toBe(true);
-  });
-
-  test("detects @ref in fill", () => {
-    expect(hasRefSelector(`agent-browser --session s1 fill "@e6" "value"`)).toBe(true);
-  });
-
-  test("does not flag aria-label selector", () => {
-    expect(hasRefSelector(`agent-browser --session s1 click "[aria-label='Submit']"`)).toBe(false);
-  });
-
-  test("does not flag text= selector", () => {
-    expect(hasRefSelector(`agent-browser --session s1 click "text=Select category"`)).toBe(false);
-  });
-
-  test("does not flag non-agent-browser commands", () => {
-    expect(hasRefSelector("ls -la")).toBe(false);
-  });
-
-  test("does not flag snapshot (no args)", () => {
-    expect(hasRefSelector("agent-browser --session s1 snapshot")).toBe(false);
-  });
-});
-
-describe("shellTokenize", () => {
-  test("splits simple tokens", () => {
-    expect(shellTokenize("click foo bar")).toEqual(["click", "foo", "bar"]);
-  });
-
-  test("preserves spaces inside double quotes", () => {
-    expect(shellTokenize(`click "[role='dialog'] button:last-child"`)).toEqual([
-      "click",
-      "[role='dialog'] button:last-child",
-    ]);
-  });
-
-  test("preserves spaces inside single quotes", () => {
-    expect(shellTokenize("fill 'text=hello world' value")).toEqual([
-      "fill",
-      "text=hello world",
-      "value",
-    ]);
-  });
-
-  test("handles empty string", () => {
-    expect(shellTokenize("")).toEqual([]);
-  });
-
-  test("handles multiple spaces", () => {
-    expect(shellTokenize("click  foo")).toEqual(["click", "foo"]);
-  });
-});
-
-describe("extractAbActionFromBashCommand with compound selectors", () => {
-  test("parses click with compound selector containing spaces", () => {
-    expect(
-      extractAbActionFromBashCommand(`agent-browser --session s1 click "[role='dialog'] button:last-child"`),
-    ).toBe("AB_ACTION|click|[role='dialog'] button:last-child|");
-  });
-
-  test("parses fill with placeholder containing spaces", () => {
-    expect(
-      extractAbActionFromBashCommand(`agent-browser --session s1 fill ".modal-footer button" "OK"`),
-    ).toBe("AB_ACTION|fill|.modal-footer button|OK|");
-  });
-});

package/src/claude/invoke.ts

@@ -1,238 +0,0 @@
-import { query } from "@anthropic-ai/claude-agent-sdk";
-import type { SDKMessage, Options, HookInput } from "@anthropic-ai/claude-agent-sdk";
-import * as log from "../cli/logger.ts";
-
-export interface ClaudeInvokeOptions {
-  prompt: string;
-  systemPrompt?: string;
-  allowedTools?: string[];
-  disableBuiltinTools?: boolean;
-  mcpConfigPath?: string;
-  maxTurns?: number;
-  env?: Record<string, string>;
-  /** Called when an agent-browser command is intercepted; receives the AB_ACTION line. */
-  onAbAction?: (abAction: string) => void;
-  /** Called when an agent-browser command fails (exit non-zero); allows rolling back the last AB_ACTION. */
-  onAbActionFailed?: () => void;
-}
-
-export async function invokeClaudeStreaming(
-  options: ClaudeInvokeOptions,
-  onEvent: (msg: SDKMessage) => void,
-): Promise<{ result: string; isError: boolean }> {
-  const {
-    prompt,
-    systemPrompt,
-    allowedTools,
-    disableBuiltinTools = false,
-    maxTurns,
-    env,
-    onAbAction,
-    onAbActionFailed,
-  } = options;
-
-  // Track the last agent-browser tool_use_id so PostToolUseFailure can roll back
-  let lastAbToolUseId: string | null = null;
-
-  const sdkOptions: Options = {
-    systemPrompt,
-    maxTurns,
-    allowedTools: allowedTools ?? ["Bash(*)"],
-    permissionMode: "bypassPermissions",
-    allowDangerouslySkipPermissions: true,
-    ...(env ? { env: { ...process.env, ...env } as Record<string, string | undefined> } : {}),
-    ...(disableBuiltinTools ? { tools: [] } : {}),
-    hooks:
-      onAbAction || onAbActionFailed
-        ? {
-            PreToolUse: [
-              {
-                hooks: [
-                  async (input: HookInput) => {
-                    if (input.hook_event_name !== "PreToolUse") return {};
-                    if (input.tool_name !== "Bash") return {};
-                    const cmd = (input.tool_input as Record<string, unknown>)?.["command"];
-                    if (typeof cmd !== "string") return {};
-
-                    // Block eval/js/find/etc — they bypass structured action recording
-                    if (isBlockedAbSubcommand(cmd)) {
-                      return {
-                        decision: "block",
-                        reason: "This agent-browser subcommand is not allowed because it cannot be recorded as a structured test action. Use only the standard commands: click, check, fill, select, hover, press, wait. Take a fresh snapshot to find the correct selector.",
-                      };
-                    }
-
-                    // Block @ref selectors — they are session-specific and not replayable
-                    if (hasRefSelector(cmd)) {
-                      return {
-                        decision: "block",
-                        reason: "@ref selectors (like @e14) are session-specific and change every run. They cannot be used in generated tests. Use one of the allowed selector formats instead: [aria-label='...'], text=..., [placeholder='...'], or [type='password']. Take a fresh snapshot and find the element's aria-label or visible text.",
-                      };
-                    }
-
-                    const ab = extractAbActionFromBashCommand(cmd);
-                    if (ab && onAbAction) {
-                      lastAbToolUseId = input.tool_use_id;
-                      onAbAction(ab);
-                    } else {
-                      lastAbToolUseId = null;
-                    }
-                    return {};
-                  },
-                ],
-              },
-            ],
-            PostToolUseFailure: [
-              {
-                hooks: [
-                  async (input: HookInput) => {
-                    if (input.hook_event_name !== "PostToolUseFailure") return {};
-                    if (input.tool_name !== "Bash") return {};
-                    // If the failed Bash command was the one that emitted an AB_ACTION, roll it back
-                    if (input.tool_use_id === lastAbToolUseId && onAbActionFailed) {
-                      onAbActionFailed();
-                      lastAbToolUseId = null;
-                    }
-                    return {};
-                  },
-                ],
-              },
-            ],
-          }
-        : undefined,
-  };
-
-  let result = "";
-  let isError = false;
-
-  const q = query({ prompt, options: sdkOptions });
-
-  for await (const msg of q) {
-    onEvent(msg);
-
-    if (msg.type === "assistant") {
-      for (const block of msg.message.content ?? []) {
-        if (block.type === "tool_use" && block.name === "Bash") {
-          const cmd = (block.input as Record<string, unknown>)?.["command"];
-          if (typeof cmd === "string") log.bash(cmd);
-        }
-      }
-    }
-
-    if (msg.type === "result") {
-      result = msg.subtype === "success" ? msg.result : "";
-      isError = msg.is_error ?? false;
-    }
-  }
-
-  return { result, isError };
-}
-
-const BLOCKED_AB_SUBCOMMANDS = new Set(["eval", "js", "find", "label", "textbox"]);
-
-/**
- * Shell-aware tokenizer: splits a command string into tokens respecting single/double quotes.
- * e.g. `click "[role='dialog'] button:last-child"` → ["click", "[role='dialog'] button:last-child"]
- */
-export function shellTokenize(s: string): string[] {
-  const tokens: string[] = [];
-  let cur = "";
-  let quote: '"' | "'" | null = null;
-  for (let i = 0; i < s.length; i++) {
-    const ch = s[i]!;
-    if (quote) {
-      if (ch === quote) { quote = null; }
-      else { cur += ch; }
-    } else if (ch === '"' || ch === "'") {
-      quote = ch;
-    } else if (ch === " " || ch === "\t") {
-      if (cur) { tokens.push(cur); cur = ""; }
-    } else {
-      cur += ch;
-    }
-  }
-  if (cur) tokens.push(cur);
-  return tokens;
-}
-
-/** Extracts the subcommand from an `agent-browser [flags] <subcommand> [args...]` command string. */
-export function extractAbSubcommand(cmd: string): string | null {
-  const abIdx = cmd.indexOf("agent-browser");
-  if (abIdx === -1) return null;
-  const rest = cmd.slice(abIdx + "agent-browser".length).trim();
-  const parts = shellTokenize(rest);
-  let i = 0;
-  while (i < parts.length && parts[i]!.startsWith("-")) { i += 2; }
-  return parts[i] ?? null;
-}
-
-/** Returns true if the agent-browser subcommand is blocked (eval/js/find/etc). */
-export function isBlockedAbSubcommand(cmd: string): boolean {
-  const sub = extractAbSubcommand(cmd);
-  return sub !== null && BLOCKED_AB_SUBCOMMANDS.has(sub);
-}
-
-/** Returns true if any argument to an agent-browser command uses a @ref selector (e.g. @e14). */
-export function hasRefSelector(cmd: string): boolean {
-  const abIdx = cmd.indexOf("agent-browser");
-  if (abIdx === -1) return false;
-  const rest = cmd.slice(abIdx + "agent-browser".length).trim();
-  const parts = shellTokenize(rest);
-  // Skip flags and subcommand, check remaining args
-  let i = 0;
-  while (i < parts.length && parts[i]!.startsWith("-")) { i += 2; }
-  i++; // skip subcommand
-  for (; i < parts.length; i++) {
-    if (/^@/.test(parts[i]!)) return true;
-  }
-  return false;
-}
-
-/**
- * Parse an `agent-browser --session <name> <cmd> [args...]` bash command
- * and return the corresponding AB_ACTION line, or null if not an agent-browser call.
- */
-export function extractAbActionFromBashCommand(cmd: string): string | null {
-  const subCmd = extractAbSubcommand(cmd);
-  if (!subCmd) return null;
-
-  // Extract everything after "agent-browser" to get args (shell-aware tokenization)
-  const abIdx = cmd.indexOf("agent-browser");
-  const rest = cmd.slice(abIdx + "agent-browser".length).trim();
-  // Filter out shell redirects/pipes (2>&1, >&1, |, >file) that are not agent-browser args
-  const parts = shellTokenize(rest).filter(t => !/^(2?>|[|&>])/.test(t));
-  let i = 0;
-  while (i < parts.length && parts[i]!.startsWith("-")) { i += 2; }
-  const args = parts.slice(i + 1);
-
-  switch (subCmd) {
-    case "cookies":
-      if (args[0] === "clear") return "AB_ACTION|cookies_clear";
-      return null;
-    case "open":
-      return `AB_ACTION|open|${args[0] ?? ""}`;
-    case "press":
-      return `AB_ACTION|press|${args[0] ?? ""}`;
-    case "scroll":
-      return `AB_ACTION|scroll|${args.join("|")}`;
-    case "click":
-    case "dblclick":
-    case "check":
-    case "uncheck":
-    case "hover":
-    case "wait":
-      return `AB_ACTION|${subCmd}|${args[0] ?? ""}|${args[1] ?? ""}`;
-    case "fill":
-    case "type":
-    case "select":
-      return `AB_ACTION|${subCmd}|${args[0] ?? ""}|${args[1] ?? ""}|${args[2] ?? ""}`;
-    case "drag":
-      return `AB_ACTION|drag|${args[0] ?? ""}|${args[1] ?? ""}|${args[2] ?? ""}`;
-    case "snapshot":
-      // snapshot AB_ACTION is emitted by LLM with its own observation
-      return null;
-    default:
-      return null;
-  }
-}
-