whisker-ux 0.1.0

package/dist/browser.js

@@ -0,0 +1,231 @@
+import { chromium } from "playwright";
+function mapKeyNames(key) {
+    const keyMap = {
+        return: "Enter",
+        enter: "Enter",
+        ctrl: "Control",
+        control: "Control",
+        super: "Meta",
+        cmd: "Meta",
+        command: "Meta",
+        alt: "Alt",
+        shift: "Shift",
+        tab: "Tab",
+        escape: "Escape",
+        esc: "Escape",
+        backspace: "Backspace",
+        delete: "Delete",
+        space: " ",
+        arrowup: "ArrowUp",
+        arrowdown: "ArrowDown",
+        arrowleft: "ArrowLeft",
+        arrowright: "ArrowRight",
+        up: "ArrowUp",
+        down: "ArrowDown",
+        left: "ArrowLeft",
+        right: "ArrowRight",
+        pageup: "PageUp",
+        pagedown: "PageDown",
+        page_up: "PageUp",
+        page_down: "PageDown",
+        home: "Home",
+        end: "End",
+    };
+    return key
+        .split("+")
+        .map((part) => {
+        const lower = part.trim().toLowerCase();
+        return keyMap[lower] ?? part.trim();
+    })
+        .join("+");
+}
+export class BrowserManager {
+    config;
+    browser = null;
+    context = null;
+    page = null;
+    consoleErrors = [];
+    networkFailures = [];
+    constructor(config) {
+        this.config = config;
+    }
+    async launch() {
+        this.browser = await chromium.launch({
+            headless: false,
+            args: [
+                `--window-size=${this.config.viewport.width},${this.config.viewport.height + 100}`,
+            ],
+        });
+        this.context = await this.browser.newContext({
+            viewport: {
+                width: this.config.viewport.width,
+                height: this.config.viewport.height,
+            },
+        });
+        this.page = await this.context.newPage();
+        // Capture console errors
+        this.page.on("console", (msg) => {
+            if (msg.type() === "error") {
+                this.consoleErrors.push(`[${new Date().toISOString()}] ${msg.text()}`);
+            }
+        });
+        // Capture unhandled page errors
+        this.page.on("pageerror", (err) => {
+            this.consoleErrors.push(`[${new Date().toISOString()}] Uncaught: ${err.message}`);
+        });
+        // Capture network failures (4xx/5xx)
+        this.page.on("response", (response) => {
+            if (response.status() >= 400) {
+                this.networkFailures.push({
+                    url: response.url(),
+                    method: response.request().method(),
+                    status: response.status(),
+                    statusText: response.statusText(),
+                    timestamp: Date.now(),
+                });
+            }
+        });
+        // Capture failed requests (network errors)
+        this.page.on("requestfailed", (request) => {
+            this.networkFailures.push({
+                url: request.url(),
+                method: request.method(),
+                status: 0,
+                statusText: request.failure()?.errorText ?? "Request failed",
+                timestamp: Date.now(),
+            });
+        });
+        // Handle popups - switch to new page
+        this.context.on("page", (newPage) => {
+            this.page = newPage;
+            newPage.on("console", (msg) => {
+                if (msg.type() === "error") {
+                    this.consoleErrors.push(`[${new Date().toISOString()}] ${msg.text()}`);
+                }
+            });
+            newPage.on("pageerror", (err) => {
+                this.consoleErrors.push(`[${new Date().toISOString()}] Uncaught: ${err.message}`);
+            });
+        });
+        await this.page.goto(this.config.url, { waitUntil: "domcontentloaded" });
+    }
+    async takeScreenshot() {
+        if (!this.page)
+            throw new Error("Browser not launched");
+        const buffer = await this.page.screenshot({
+            type: "png",
+            fullPage: false,
+        });
+        return buffer.toString("base64");
+    }
+    async executeAction(action) {
+        if (!this.page)
+            throw new Error("Browser not launched");
+        const page = this.page;
+        switch (action.action) {
+            case "screenshot":
+                // No-op: screenshot is taken separately by the caller
+                break;
+            case "left_click":
+                if (action.coordinate) {
+                    await page.mouse.click(action.coordinate[0], action.coordinate[1], {
+                        button: "left",
+                    });
+                }
+                break;
+            case "right_click":
+                if (action.coordinate) {
+                    await page.mouse.click(action.coordinate[0], action.coordinate[1], {
+                        button: "right",
+                    });
+                }
+                break;
+            case "middle_click":
+                if (action.coordinate) {
+                    await page.mouse.click(action.coordinate[0], action.coordinate[1], {
+                        button: "middle",
+                    });
+                }
+                break;
+            case "double_click":
+                if (action.coordinate) {
+                    await page.mouse.dblclick(action.coordinate[0], action.coordinate[1]);
+                }
+                break;
+            case "triple_click":
+                if (action.coordinate) {
+                    await page.mouse.click(action.coordinate[0], action.coordinate[1], {
+                        clickCount: 3,
+                    });
+                }
+                break;
+            case "type":
+                if (action.text) {
+                    await page.keyboard.type(action.text, { delay: 30 });
+                }
+                break;
+            case "key":
+                if (action.text) {
+                    const mapped = mapKeyNames(action.text);
+                    await page.keyboard.press(mapped);
+                }
+                break;
+            case "mouse_move":
+                if (action.coordinate) {
+                    await page.mouse.move(action.coordinate[0], action.coordinate[1]);
+                }
+                break;
+            case "scroll":
+                if (action.coordinate && action.scroll_direction) {
+                    await page.mouse.move(action.coordinate[0], action.coordinate[1]);
+                    const amount = (action.scroll_amount ?? 3) * 100;
+                    const deltaX = action.scroll_direction === "left"
+                        ? -amount
+                        : action.scroll_direction === "right"
+                            ? amount
+                            : 0;
+                    const deltaY = action.scroll_direction === "down"
+                        ? amount
+                        : action.scroll_direction === "up"
+                            ? -amount
+                            : 0;
+                    await page.mouse.wheel(deltaX, deltaY);
+                }
+                break;
+            case "left_click_drag":
+                if (action.coordinate) {
+                    const startX = action.start_coordinate?.[0] ?? 0;
+                    const startY = action.start_coordinate?.[1] ?? 0;
+                    await page.mouse.move(startX, startY);
+                    await page.mouse.down();
+                    await page.mouse.move(action.coordinate[0], action.coordinate[1]);
+                    await page.mouse.up();
+                }
+                break;
+            case "wait":
+                await new Promise((resolve) => setTimeout(resolve, 2000));
+                break;
+            default:
+                console.warn(`  Unknown action type: ${action.action}`);
+        }
+        // Brief pause after actions to let the page settle
+        if (action.action !== "screenshot" && action.action !== "wait") {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+    }
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.context = null;
+            this.page = null;
+        }
+    }
+    getConsoleErrors() {
+        return [...this.consoleErrors];
+    }
+    getNetworkFailures() {
+        return [...this.networkFailures];
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import path from "path";
+import { runSession } from "./agent.js";
+import { writeReport } from "./report.js";
+import { getApiKey, runSetup, getConfigPath, deleteApiKey } from "./config.js";
+import { printBanner, printConfig, printResults, printError } from "./ui.js";
+const program = new Command();
+program
+    .name("whisker")
+    .description("AI-powered usability testing CLI using Claude computer use")
+    .version("0.1.0");
+// Setup command
+program
+    .command("setup")
+    .description("Configure your Anthropic API key")
+    .action(async () => {
+    await runSetup();
+});
+// Logout command
+program
+    .command("logout")
+    .description("Remove stored API key")
+    .action(() => {
+    const deleted = deleteApiKey();
+    if (deleted) {
+        console.log("API key removed from", getConfigPath());
+    }
+    else {
+        console.log("No stored API key found.");
+    }
+});
+// Run command (main functionality)
+program
+    .command("run", { isDefault: true })
+    .description("Run a usability test")
+    .argument("<task>", "Task description (e.g., 'Add a product to cart')")
+    .requiredOption("-u, --url <url>", "URL of the site to test")
+    .option("-p, --persona <persona>", "Persona description for the tester")
+    .option("-m, --max-steps <number>", "Maximum number of steps", "50")
+    .option("-v, --viewport <WxH>", "Viewport size (e.g., 1280x800)", "1280x800")
+    .option("-o, --output <dir>", "Output directory", ".whisker")
+    .action(async (task, opts) => {
+    // Get API key from config or environment
+    const apiKey = getApiKey();
+    if (!apiKey) {
+        printError(`No Anthropic API key configured.\n\nRun setup: npx tsx src/cli.ts setup\nOr set env: export ANTHROPIC_API_KEY=sk-ant-...\n\nConfig: ${getConfigPath()}`);
+        process.exit(1);
+    }
+    // Set for the Anthropic SDK to pick up
+    process.env.ANTHROPIC_API_KEY = apiKey;
+    // Parse viewport
+    const viewportParts = opts.viewport.split("x");
+    if (viewportParts.length !== 2) {
+        printError("Invalid viewport format. Use WxH (e.g., 1280x800)");
+        process.exit(1);
+    }
+    const width = parseInt(viewportParts[0], 10);
+    const height = parseInt(viewportParts[1], 10);
+    if (isNaN(width) || isNaN(height) || width <= 0 || height <= 0) {
+        printError("Invalid viewport dimensions. Use positive integers.");
+        process.exit(1);
+    }
+    // Parse max steps
+    const maxSteps = parseInt(opts.maxSteps, 10);
+    if (isNaN(maxSteps) || maxSteps <= 0) {
+        printError("max-steps must be a positive integer");
+        process.exit(1);
+    }
+    const config = {
+        task,
+        url: opts.url,
+        persona: opts.persona,
+        maxSteps,
+        viewport: { width, height },
+        outputDir: opts.output,
+    };
+    // Print banner and config
+    printBanner();
+    printConfig(config.task, config.url, config.persona, config.maxSteps, `${config.viewport.width}x${config.viewport.height}`);
+    try {
+        const { report, sessionLog } = await runSession(config);
+        const { markdownPath, jsonPath, screenshotDir } = await writeReport(report, sessionLog, config.outputDir);
+        // Print results with the new UI
+        const absoluteOutputDir = path.resolve(config.outputDir);
+        printResults(report.taskCompleted, report.summary, report.findings, config.outputDir, absoluteOutputDir);
+    }
+    catch (err) {
+        printError(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export declare function getApiKey(): string | undefined;
+export declare function saveApiKey(apiKey: string): void;
+export declare function runSetup(): Promise<void>;
+export declare function getConfigPath(): string;
+export declare function deleteApiKey(): boolean;

package/dist/config.js

@@ -0,0 +1,104 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import * as readline from "node:readline";
+const CONFIG_DIR = path.join(os.homedir(), ".config", "whisker");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+export function getApiKey() {
+    // Environment variable takes precedence
+    if (process.env.ANTHROPIC_API_KEY) {
+        return process.env.ANTHROPIC_API_KEY;
+    }
+    // Try reading from config file
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const content = fs.readFileSync(CONFIG_FILE, "utf-8");
+            const config = JSON.parse(content);
+            return config.anthropicApiKey;
+        }
+    }
+    catch {
+        // Ignore errors reading config
+    }
+    return undefined;
+}
+export function saveApiKey(apiKey) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    let config = {};
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const content = fs.readFileSync(CONFIG_FILE, "utf-8");
+            config = JSON.parse(content);
+        }
+    }
+    catch {
+        // Start fresh if config is corrupted
+    }
+    config.anthropicApiKey = apiKey;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    fs.chmodSync(CONFIG_FILE, 0o600); // Read/write only for owner
+}
+export async function runSetup() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (prompt) => new Promise((resolve) => rl.question(prompt, resolve));
+    console.log("");
+    console.log("Whisker Setup");
+    console.log("─────────────");
+    console.log("");
+    console.log("Whisker needs an Anthropic API key to use Claude for testing.");
+    console.log("Get one at: https://console.anthropic.com/settings/keys");
+    console.log("");
+    const existingKey = getApiKey();
+    if (existingKey) {
+        console.log(`Current key: ${existingKey.slice(0, 12)}...${existingKey.slice(-4)}`);
+        const overwrite = await question("Replace existing key? (y/N): ");
+        if (overwrite.toLowerCase() !== "y") {
+            console.log("Setup cancelled.");
+            rl.close();
+            return;
+        }
+    }
+    const apiKey = await question("Enter your Anthropic API key: ");
+    rl.close();
+    if (!apiKey.trim()) {
+        console.log("No key provided. Setup cancelled.");
+        return;
+    }
+    if (!apiKey.startsWith("sk-ant-")) {
+        console.log("Warning: Key doesn't look like an Anthropic API key (should start with sk-ant-)");
+    }
+    saveApiKey(apiKey.trim());
+    console.log("");
+    console.log(`API key saved to ${CONFIG_FILE}`);
+    console.log("You're ready to use Whisker!");
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export function deleteApiKey() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const content = fs.readFileSync(CONFIG_FILE, "utf-8");
+            const config = JSON.parse(content);
+            if (config.anthropicApiKey) {
+                delete config.anthropicApiKey;
+                // If config is now empty, delete the file
+                if (Object.keys(config).length === 0) {
+                    fs.unlinkSync(CONFIG_FILE);
+                }
+                else {
+                    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+                }
+                return true;
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return false;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { runSession } from "./agent.js";
+export { writeReport } from "./report.js";
+export type { WhiskerConfig, WhiskerReport, Finding, SessionLog, SessionStep, NetworkFailure, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+// Main exports for programmatic usage
+export { runSession } from "./agent.js";
+export { writeReport } from "./report.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,3 @@
+import { WhiskerConfig } from "./types.js";
+export declare function getNavigationSystemPrompt(config: WhiskerConfig): string;
+export declare function getReportSystemPrompt(): string;

package/dist/prompts.js

@@ -0,0 +1,81 @@
+export function getNavigationSystemPrompt(config) {
+    const personaSection = config.persona
+        ? `\n\n## Persona\nYou are acting as the following persona: ${config.persona}\nConsider this persona's technical ability, familiarity with similar products, and expectations when evaluating the experience.`
+        : "";
+    return `You are an expert usability tester evaluating a web application. Your job is to complete a specific task while carefully observing and narrating the user experience.
+
+## Your Task
+${config.task}
+
+## Starting URL
+${config.url}
+${personaSection}
+
+## Instructions
+
+1. **Think aloud**: Before each action, describe what you see on screen, what you're trying to do, and any observations about the UX. Be specific and detailed about what you observe.
+
+2. **Act like a real user**: Navigate the site naturally. Don't use shortcuts a normal user wouldn't know about. If something is confusing, say so explicitly.
+
+3. **Watch for issues** as you navigate:
+   - **Bugs**: Broken buttons, errors, incorrect behavior, console errors
+   - **UX friction**: Confusing labels, unexpected flows, too many steps, missing feedback
+   - **Accessibility**: Missing labels, poor contrast, keyboard navigation issues
+   - **Performance**: Slow loads, unresponsive elements, layout shifts
+   - **Visual issues**: Overlapping elements, misalignment, truncated text, broken layouts
+   - **Copy issues**: Confusing or misleading text, typos, jargon
+
+4. **Take a screenshot after each action** to verify the result. If something didn't work as expected, note it clearly and try an alternative approach.
+
+5. **Complete the task or explain why you cannot**. If you get stuck after 3 attempts at the same thing, describe what blocked you and stop.
+
+6. **When finished**, provide a clear final summary of:
+   - Whether the task was completed successfully
+   - The overall experience quality
+   - The most significant issues encountered
+
+Start by taking a screenshot to see the current state of the page.`;
+}
+export function getReportSystemPrompt() {
+    return `You are an expert usability analyst. You are given the session log and screenshots from an AI-driven usability test of a web application. Your job is to analyze the session and produce a structured JSON report of findings.
+
+Carefully examine each screenshot to identify visual issues, layout problems, confusing UI elements, accessibility concerns, and bugs that may not be obvious from the text observations alone.
+
+## Output Format
+
+Return ONLY a valid JSON object (no markdown fences, no extra text) matching this exact schema:
+
+{
+  "summary": "2-3 sentence overview of the test session and overall UX quality",
+  "taskCompleted": true or false,
+  "taskCompletionNotes": "Explanation of whether and how the task was completed, or what blocked it",
+  "findings": [
+    {
+      "id": "F001",
+      "severity": "critical | major | minor | suggestion",
+      "category": "bug | ux-friction | accessibility | performance | visual | copy",
+      "title": "Short descriptive title",
+      "description": "Detailed description of the issue, including what was expected vs what happened",
+      "stepsToReproduce": ["Step 1", "Step 2"],
+      "screenshotStepNumber": 5,
+      "suggestedFix": "Actionable suggestion for how to fix this",
+      "grepPatterns": ["patterns to search the codebase for relevant code"]
+    }
+  ]
+}
+
+## Severity Definitions
+- **critical**: Completely blocks the user from completing the task
+- **major**: Significant friction or confusion that most users would struggle with
+- **minor**: Noticeable issue but doesn't significantly impede the task
+- **suggestion**: Improvement idea that would enhance the experience
+
+## Guidelines
+- Assign IDs sequentially: F001, F002, etc.
+- Be specific about which step number demonstrated each issue (screenshotStepNumber)
+- For grepPatterns, suggest patterns that would help find relevant code: CSS class names, button text, component names, API endpoints
+- Only report genuine issues backed by evidence from the session, not speculative concerns
+- Consolidate duplicate or overlapping observations into single findings
+- Order findings by severity (critical first, then major, minor, suggestion)`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAAC,MAAqB;IAC7D,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO;QACnC,CAAC,CAAC,4DAA4D,MAAM,CAAC,OAAO,kIAAkI;QAC9M,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;EAGP,MAAM,CAAC,IAAI;;;EAGX,MAAM,CAAC,GAAG;EACV,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;mEAyBmD,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EAuCoE,CAAC;AAC9E,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,6 @@
+import { WhiskerReport, SessionLog } from "./types.js";
+export declare function writeReport(report: WhiskerReport, sessionLog: SessionLog, outputDir: string): Promise<{
+    markdownPath: string;
+    jsonPath: string;
+    screenshotDir: string;
+}>;