@hasna/testers 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrei Hasna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+# open-testers
+
+AI-powered QA testing CLI — spawns cheap AI agents to test web apps with headless browsers.
+
+## What is this?
+
+`testers` is a CLI tool that creates AI testing agents (Claude Haiku 4.5 by default) to click through your website like a real human. Tests are stored in SQLite, screenshots are captured at every step, and results are queryable.
+
+Part of the [@hasna](https://www.npmjs.com/org/hasnaxyz) open-source ecosystem.
+
+## Install
+
+```bash
+npm install -g @hasna/testers
+
+# Install browser (first time only)
+testers install-browser
+```
+
+## Quick Start
+
+```bash
+# Create a test scenario
+testers add "Login flow" --description "Test login with valid creds" --tag auth --priority high
+
+# Run all scenarios against your app
+testers run http://localhost:3000
+
+# Run with live browser (non-headless)
+testers run http://localhost:3000 --headed
+
+# Run a quick ad-hoc test
+testers run http://localhost:3000 "verify the signup page loads and shows a form"
+
+# Use a smarter model for complex scenarios
+testers run http://localhost:3000 --model sonnet
+```
+
+## Features
+
+- **SQLite-backed scenarios** — Define, tag, filter, and reuse test scenarios
+- **AI-powered** — Agents navigate, click, fill forms, and verify results autonomously
+- **Screenshot-first** — Every action captured and organized by run/scenario/step
+- **Cheap by default** — Haiku 4.5 (~$0.001/test), configurable per scenario
+- **Headless by default** — Opt-in `--headed` mode to watch AI test live
+- **open-todos integration** — Pull QA tasks as test scenarios
+- **MCP server** — Let Claude Code trigger tests inline
+- **Dashboard** — Web UI for browsing results and screenshots
+
+## CLI Reference
+
+### Scenario Management
+
+```bash
+testers add <name> [options]           # Create a test scenario
+  --description <desc>                 # Scenario description
+  --steps <step>                       # Add a step (repeatable)
+  --tag <tag>                          # Add a tag (repeatable)
+  --priority <low|medium|high|critical>
+  --model <preset|model-id>            # Override model
+  --path <path>                        # Target path (e.g., /login)
+  --auth                               # Requires authentication
+  --timeout <ms>                       # Custom timeout
+
+testers list [options]                 # List scenarios
+  --tag <tag>                          # Filter by tag
+  --priority <priority>                # Filter by priority
+
+testers show <id>                      # Show scenario details
+testers update <id> [options]          # Update scenario
+testers delete <id>                    # Delete scenario
+```
+
+### Running Tests
+
+```bash
+testers run <url> [description]        # Run tests
+  --tag <tag>                          # Run scenarios with tag
+  --scenario <id>                      # Run specific scenario
+  --priority <priority>                # Run by priority
+  --headed                             # Watch browser live
+  --model <quick|thorough|deep>        # Model preset
+  --parallel <n>                       # Concurrent agents (default: 1)
+  --json                               # JSON output
+  --output <file>                      # Write JSON to file
+  --from-todos                         # Pull from open-todos
+  --project <name>                     # Filter by project
+```
+
+### Results
+
+```bash
+testers runs                           # List past runs
+testers results <run-id>               # Show run results
+testers screenshots <id>               # List screenshots
+```
+
+### Utilities
+
+```bash
+testers config                         # Show config
+testers status                         # Show auth & DB status
+testers install-browser                # Install Playwright chromium
+testers import <dir>                   # Import markdown tests to DB
+testers serve                          # Start dashboard
+```
+
+## Model Presets
+
+| Preset | Model | Use Case |
+|--------|-------|----------|
+| `quick` (default) | Claude Haiku 4.5 | Fast, cheap tests |
+| `thorough` | Claude Sonnet 4.6 | Complex flows |
+| `deep` | Claude Opus 4.6 | Multi-step critical paths |
+
+## Configuration
+
+Config file: `~/.testers/config.json`
+
+```json
+{
+  "defaultModel": "claude-haiku-4-5-20251001",
+  "browser": {
+    "headless": true,
+    "viewport": { "width": 1280, "height": 720 }
+  },
+  "screenshots": {
+    "dir": "~/.testers/screenshots",
+    "format": "png"
+  }
+}
+```
+
+Environment variables:
+- `ANTHROPIC_API_KEY` — Your Anthropic API key (required)
+- `TESTERS_DB_PATH` — Custom database path
+- `TESTERS_MODEL` — Override default model
+- `TESTERS_SCREENSHOTS_DIR` — Custom screenshot directory
+- `TESTERS_PORT` — Dashboard server port (default: 19450)
+
+## Screenshots
+
+Screenshots are saved to `~/.testers/screenshots/` organized by:
+
+```
+{run-id}/
+  {scenario-slug}/
+    001-navigate-homepage.png
+    002-click-login-button.png
+    003-fill-email-field.png
+    004-submit-form.png
+    005-verify-dashboard.png
+```
+
+## MCP Server
+
+Install for Claude Code:
+
+```bash
+claude mcp add --transport stdio --scope user testers-mcp -- testers-mcp
+```
+
+Available tools: `create_scenario`, `list_scenarios`, `run_scenarios`, `get_results`, `get_screenshots`, and more.
+
+## open-todos Integration
+
+Pull QA tasks from [open-todos](https://github.com/hasna/open-todos) as test scenarios:
+
+```bash
+testers run http://localhost:3000 --from-todos --project myapp
+```
+
+Tasks tagged with `qa`, `test`, or `testing` are automatically imported.
+
+## Dashboard
+
+```bash
+testers serve
+# Open http://localhost:19450
+```
+
+Browse scenarios, runs, results, and screenshots in a web UI.
+
+## Stack
+
+- **Runtime**: Bun
+- **Language**: TypeScript
+- **Database**: SQLite (bun:sqlite)
+- **Browser**: Playwright (Chromium)
+- **AI**: Anthropic Claude API
+- **CLI**: Commander.js
+- **Dashboard**: React + Vite + Tailwind CSS
+
+## License
+
+MIT

package/dashboard/dist/assets/index-CDcHt94n.css

@@ -0,0 +1 @@
+/*! tailwindcss v4.2.1 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid}}}@layer theme{:root,:host{--font-sans:ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--spacing:.25rem;--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.fixed{position:fixed}.start{inset-inline-start:var(--spacing)}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.border{border-style:var(--tw-border-style);border-width:1px}}:root{--bg:#0a0a0a;--bg-card:#141414;--bg-hover:#1a1a1a;--border:#262626;--text:#e5e5e5;--text-muted:#737373;--green:#22c55e;--red:#ef4444;--yellow:#eab308;--blue:#3b82f6;--cyan:#06b6d4}body{background:var(--bg);color:var(--text);margin:0;font-family:system-ui,-apple-system,sans-serif}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}