@assrt-ai/assrt 0.3.3

package/cli.mjs

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+import {
+  TestAgent,
+  getCredential,
+  shutdownTelemetry,
+  trackEvent
+} from "./chunk-PZ5LLIRQ.mjs";
+
+// src/cli.ts
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { join } from "path";
+function printUsage() {
+  console.error(
+    "Usage:\n  assrt setup                                    Set up MCP server, hooks, and CLAUDE.md\n  assrt run --url <url> [options]                Run QA tests\n\nRun options:\n  --url         URL to test (required)\n  --plan        Test scenarios as inline text\n  --plan-file   Path to a file containing test scenarios\n  --model       LLM model to use (default: claude-haiku-4-5-20251001)\n  --json        Output raw JSON report to stdout\n  --help        Show this help message\n\nAuth: Uses ANTHROPIC_API_KEY env var, or reads Claude Code credentials from macOS Keychain."
+  );
+}
+function parseArgs(argv) {
+  const args = {};
+  const command = argv[0] || "";
+  for (let i = 1; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--help" || arg === "-h") {
+      printUsage();
+      process.exit(0);
+    }
+    if (arg === "--json") {
+      args.json = true;
+      continue;
+    }
+    if (arg.startsWith("--") && i + 1 < argv.length) {
+      args[arg.slice(2)] = argv[++i];
+    }
+  }
+  return {
+    command,
+    url: args.url || "",
+    plan: args.plan,
+    planFile: args["plan-file"],
+    model: args.model,
+    json: !!args.json
+  };
+}
+async function readStdin() {
+  if (process.stdin.isTTY) return "";
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8").trim();
+}
+function createCliEmit(jsonMode) {
+  return (type, data) => {
+    if (jsonMode) return;
+    switch (type) {
+      case "status":
+        console.error(`[status] ${data.message}`);
+        break;
+      case "reasoning":
+        console.error(`[think] ${data.text}`);
+        break;
+      case "step":
+        if (data.status !== "running") {
+          const icon = data.status === "completed" ? "+" : "x";
+          console.error(`  [${icon}] ${data.description}`);
+        }
+        break;
+      case "assertion": {
+        const icon = data.passed ? "PASS" : "FAIL";
+        console.error(`  [${icon}] ${data.description}`);
+        break;
+      }
+      case "scenario_start":
+        console.error(`
+--- Scenario: ${data.name} (${data.index + 1}/${data.total}) ---`);
+        break;
+      case "scenario_complete": {
+        const result = data.passed ? "PASSED" : "FAILED";
+        console.error(`--- ${result}: ${data.name} ---`);
+        break;
+      }
+      case "improvement_suggestion":
+        console.error(`  [issue] ${data.severity}: ${data.title}`);
+        break;
+      case "screenshot":
+      case "page_discovered":
+      case "discovered_cases_chunk":
+      case "discovered_cases_complete":
+        break;
+    }
+  };
+}
+function printReport(report) {
+  console.log("\n========================================");
+  console.log(`  Assrt Test Report`);
+  console.log("========================================");
+  console.log(`  URL:      ${report.url}`);
+  console.log(`  Passed:   ${report.passedCount}`);
+  console.log(`  Failed:   ${report.failedCount}`);
+  console.log(`  Duration: ${(report.totalDuration / 1e3).toFixed(1)}s`);
+  console.log("========================================\n");
+  for (const scenario of report.scenarios) {
+    const icon = scenario.passed ? "PASS" : "FAIL";
+    console.log(`  [${icon}] ${scenario.name}`);
+    if (scenario.summary) {
+      console.log(`         ${scenario.summary}`);
+    }
+    for (const assertion of scenario.assertions) {
+      const aIcon = assertion.passed ? "+" : "x";
+      console.log(`    [${aIcon}] ${assertion.description}`);
+    }
+  }
+  console.log("");
+}
+var POST_COMMIT_HOOK = `#!/bin/bash
+# Assrt: suggest QA testing after git commit/push
+INPUT=$(cat)
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
+if echo "$COMMAND" | grep -qE 'git (commit|push)'; then
+  echo '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":"A git commit/push was just made. If the committed changes affect anything user-facing (UI, routes, forms, APIs), run assrt_test against the local dev server to verify the changes work in a real browser. Use assrt_plan first if you need test cases."}}'
+fi
+`;
+function setupAssrt() {
+  const cwd = process.env.INIT_CWD || process.cwd();
+  console.error("[assrt] Setting up Assrt in this project...\n");
+  console.error("[1/3] Registering MCP server...");
+  try {
+    execSync("which claude", { stdio: ["pipe", "pipe", "pipe"], timeout: 5e3 });
+    try {
+      const mcpConfig = JSON.stringify({
+        type: "stdio",
+        command: "npx",
+        args: ["-y", "-p", "@m13v/assrt", "assrt-mcp"]
+      });
+      execSync(`claude mcp add-json assrt '${mcpConfig}'`, {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 15e3
+      });
+      console.error("      Done: MCP server registered\n");
+    } catch {
+      console.error("      Skipped: MCP server already registered\n");
+    }
+  } catch {
+    console.error("      Skipped: 'claude' CLI not found in PATH\n");
+  }
+  console.error("[2/3] Installing post-commit hook...");
+  const hookDir = join(cwd, ".claude", "hooks");
+  const hookPath = join(hookDir, "assrt-post-commit.sh");
+  if (!existsSync(hookDir)) mkdirSync(hookDir, { recursive: true });
+  writeFileSync(hookPath, POST_COMMIT_HOOK, { mode: 493 });
+  const settingsDir = join(cwd, ".claude");
+  const settingsPath = join(settingsDir, "settings.json");
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+    }
+  }
+  const hooks = settings.hooks || {};
+  const postToolUse = hooks.PostToolUse || [];
+  const alreadyInstalled = postToolUse.some(
+    (h) => JSON.stringify(h).includes("assrt-post-commit")
+  );
+  if (!alreadyInstalled) {
+    postToolUse.push({
+      matcher: "Bash",
+      hooks: [{ type: "command", command: hookPath }]
+    });
+    hooks.PostToolUse = postToolUse;
+    settings.hooks = hooks;
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+    console.error(`      Done: hook installed at ${hookPath}
+`);
+  } else {
+    console.error("      Skipped: hook already installed\n");
+  }
+  console.error("[3/3] Updating CLAUDE.md...");
+  const claudeMdPath = join(cwd, "CLAUDE.md");
+  let claudeMd = "";
+  if (existsSync(claudeMdPath)) {
+    claudeMd = readFileSync(claudeMdPath, "utf-8");
+  }
+  if (!claudeMd.includes("assrt_test") && !claudeMd.includes("## QA Testing")) {
+    const snippet = `
+
+## QA Testing (Assrt)
+
+**CRITICAL: You MUST run \`assrt_test\` after ANY user-facing change.** Do not wait for the user to ask. Do not skip this step. Do not consider a task complete until tests pass.
+
+- **After every UI, route, form, or user flow change**: run \`assrt_test\` against the local dev server to verify it works in a real browser.
+- **New features**: use \`assrt_plan\` to auto-generate test cases, then run them with \`assrt_test\`.
+- **Bug fixes**: write a targeted \`#Case\` that reproduces the bug, run with \`assrt_test\`.
+- **Failed tests**: use \`assrt_diagnose\` to understand root cause before attempting a fix. Do not guess.
+- **Video playback**: \`assrt_test\` records a video of each test run and auto-opens a player in the browser by default (\`autoOpenPlayer: true\`). If the user prefers not to have the video player open automatically, set \`autoOpenPlayer: false\` in subsequent calls.
+`;
+    writeFileSync(claudeMdPath, claudeMd + snippet);
+    console.error("      Done: added QA testing section to CLAUDE.md\n");
+  } else {
+    console.error("      Skipped: CLAUDE.md already has Assrt instructions\n");
+  }
+  console.error("[assrt] Setup complete! Restart Claude Code to activate.\n");
+  console.error("  MCP tools available: assrt_test, assrt_plan, assrt_diagnose");
+  console.error("  Post-commit hook: will suggest testing after git commit/push");
+  console.error("  CLAUDE.md: instructs the agent to test proactively\n");
+}
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.command === "setup") {
+    setupAssrt();
+    await trackEvent("assrt_setup", { source: "cli" });
+    await shutdownTelemetry();
+    return;
+  }
+  if (args.command !== "run") {
+    printUsage();
+    process.exit(args.command === "" ? 1 : 1);
+  }
+  if (!args.url) {
+    console.error("Error: --url is required\n");
+    printUsage();
+    process.exit(1);
+  }
+  let credential;
+  try {
+    credential = getCredential();
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
+  let plan = "";
+  if (args.planFile) {
+    try {
+      plan = readFileSync(args.planFile, "utf-8").trim();
+    } catch (err) {
+      console.error(`Error reading plan file: ${err.message}`);
+      process.exit(1);
+    }
+  } else if (args.plan) {
+    plan = args.plan;
+  } else {
+    plan = await readStdin();
+  }
+  if (!plan) {
+    console.error("Error: provide test scenarios via --plan, --plan-file, or stdin\n");
+    printUsage();
+    process.exit(1);
+  }
+  const emit = createCliEmit(args.json);
+  if (!args.json) {
+    console.error(`[assrt] Testing ${args.url}`);
+    console.error(`[assrt] Model: ${args.model || "default"}`);
+  }
+  const t0 = Date.now();
+  const agent = new TestAgent(credential.token, emit, args.model, "anthropic", null, "local", credential.type);
+  const report = await agent.run(args.url, plan);
+  await trackEvent("assrt_test_run", {
+    url: args.url,
+    model: args.model || "default",
+    passed: report.failedCount === 0,
+    passedCount: report.passedCount,
+    failedCount: report.failedCount,
+    duration_s: +((Date.now() - t0) / 1e3).toFixed(1),
+    scenarioCount: report.scenarios.length,
+    source: "cli"
+  });
+  if (args.json) {
+    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+  } else {
+    printReport(report);
+  }
+  await shutdownTelemetry();
+  process.exit(report.failedCount > 0 ? 1 : 0);
+}
+main().catch(async (err) => {
+  console.error(`Fatal error: ${err.message || err}`);
+  await shutdownTelemetry();
+  process.exit(1);
+});

package/index.mjs

@@ -0,0 +1,20 @@
+import {
+  McpBrowserManager,
+  TestAgent,
+  createTestVm,
+  destroyTestVm,
+  getCredential,
+  isFreestyleConfigured,
+  shutdownTelemetry,
+  trackEvent
+} from "./chunk-PZ5LLIRQ.mjs";
+export {
+  McpBrowserManager,
+  TestAgent,
+  createTestVm,
+  destroyTestVm,
+  getCredential,
+  isFreestyleConfigured,
+  shutdownTelemetry,
+  trackEvent
+};