npm - monomind - Versions diffs - 2.7.12 → 2.7.13 - Mend

monomind 2.7.12 → 2.7.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1159) hide show

package/packages/@monomind/cli/.claude/skills/agent-browser-testing/SKILL.md DELETED Viewed

@@ -1,964 +0,0 @@
----
-name: agent-browser-testing
-description: Comprehensive UI QA and browser automation using the native monomind browse CDP client — full test lifecycle from discovery through performance profiling, with structured pass/fail/warn reporting.
-version: 4.0.0
-triggers:
-  - /agent-browser-testing
-  - /ui-test
-  - /monobrowse
-  - /qa
-  - /crawl
-  - ui test
-  - test the UI
-  - browser test
-  - test this system
-  - walk through
-  - check the UI
-  - QA this
-  - test frontend
-  - visual test
-  - crawl
-  - scrape
-  - browse the website
-  - go to the website
-  - open the website
-  - navigate to
-  - click on the website
-  - do this on the website
-  - automate the browser
-  - fill out the form
-  - log into
-  - sign in to
-tools:
-  - Bash
----
-# Agent Browser Testing — Full QA Suite
-**Engine:** `npx monomind browse` — native TypeScript CDP client. No Playwright, no Puppeteer, no external binary. Every command below goes through this single infrastructure.
-**CRITICAL RULE:** Never use `mcp__claude-in-chrome__*`, `mcp__plugin_playwright__*`, or any other browser tool. Always use `npx monomind browse`.
----
-## Commands at a Glance
-All 55 subcommands — grouped by what they do.
-| Group | Commands |
-|---|---|
-| **Open / Navigate** | `open`, `navigate back\|forward\|reload`, `pushstate`, `connect`, `close` |
-| **Inspect** | `snapshot`, `get url\|title\|text\|html\|value\|attr\|count\|box\|styles`, `errors`, `console` |
-| **Find** | `find role\|text\|label\|placeholder\|testid\|alttext\|title\|selector` |
-| **Assert** | `is visible\|enabled\|checked`, `isvisible`, `isenabled`, `ischecked` |
-| **Click / Tap** | `click`, `dblclick`, `tap`, `hover`, `focus` |
-| **Type / Fill** | `fill`, `type`, `keyboard type\|inserttext`, `keydown`, `keyup`, `press` |
-| **Form** | `select`, `check`, `uncheck`, `upload` |
-| **Scroll / Drag** | `scroll`, `scrollintoview`, `drag`, `swipe up\|down\|left\|right` |
-| **Mouse (raw)** | `mouse move\|down\|up\|wheel` |
-| **Wait** | `wait --text\|--not-text\|--url\|--selector\|--load\|--ms\|--fn\|--download` |
-| **Download** | `download <ref> <path>`, `wait --download <path>` |
-| **Screenshot / PDF** | `screenshot`, `pdf`, `highlight`, `diff url` |
-| **Clipboard** | `clipboard read\|write\|copy\|paste` |
-| **Dialogs** | `dialog accept\|dismiss\|status` |
-| **Tabs** | `tab list\|new\|close\|<targetId>` |
-| **Windows** | `window new [url]` (isolated context / incognito) |
-| **Frames** | `frame <ref>\|main` |
-| **Storage** | `storage local\|session`, `cookies list\|set\|clear` |
-| **Network** | `network route\|unroute\|headers\|capture\|requests\|request` |
-| **Emulation** | `set device\|media\|geo\|offline\|useragent\|viewport\|credentials`, `resize` |
-| **Session** | `state save\|load\|list\|show\|clear\|rename\|clean`, `open --session\|--state` |
-| **JS / Init** | `eval`, `eval --stdin`, `addinitscript`, `removeinitscript` |
-| **Record** | `record start\|stop\|restart\|status` |
-| **Performance** | `vitals`, `trace start\|stop\|status`, `profiler start\|stop\|heap`, `har start\|stop\|status` |
-| **Batch** | `batch "cmd1" "cmd2" ...` |
----
-## QA Execution Protocol
-When this skill is invoked, run ALL phases unless the user specifies a subset.
-### Phase 0 — Pre-flight
-```bash
-# Verify server is reachable before starting
-npx monomind browse open <url>
-npx monomind browse get url          # confirm we landed on the right page
-npx monomind browse get title
-npx monomind browse errors           # baseline — clear before testing
-```
-### Phase 1 — Discovery & Structure Audit
-```bash
-npx monomind browse snapshot         # full AX tree — understand page structure
-npx monomind browse snapshot -i      # interactive-only (93% less context)
-npx monomind browse find role link   # enumerate all links
-npx monomind browse find role button # enumerate all buttons
-npx monomind browse find role heading # heading hierarchy
-npx monomind browse find role form   # form elements
-npx monomind browse find role image  # images (check alt text in snapshot)
-```
-**Report:** page structure, heading hierarchy, interactive element count, any obvious missing landmarks.
-### Phase 2 — Golden Path Testing
-Execute the primary user flow end-to-end. Pattern:
-```bash
-npx monomind browse open <url>
-npx monomind browse snapshot -i
-# identify refs → act → re-snapshot → verify
-npx monomind browse fill @e1 "value"
-npx monomind browse click @e2
-npx monomind browse wait --text "expected result"
-npx monomind browse snapshot -i
-npx monomind browse errors           # check after every major action
-```
-**Report:** each step result, any deviations from expected state.
-### Phase 3 — Edge Case & Validation Testing
-```bash
-# Empty submission
-npx monomind browse click @submit_btn
-npx monomind browse wait --text "required" --timeout 3000
-npx monomind browse snapshot -i
-# Invalid input
-npx monomind browse fill @email_field "not-an-email"
-npx monomind browse click @submit_btn
-npx monomind browse snapshot -i
-# Boundary values
-npx monomind browse fill @text_field ""               # empty
-npx monomind browse fill @text_field "a"              # min
-npx monomind browse fill @text_field "$(python3 -c 'print("x"*1000)')"  # overflow
-# Element state checks
-npx monomind browse is visible @e5
-npx monomind browse is enabled @e3
-npx monomind browse is checked @e7
-```
-### Phase 4 — Cross-Device & Responsive
-```bash
-# Mobile
-npx monomind browse set device "iPhone 14"
-npx monomind browse screenshot mobile-portrait.png
-npx monomind browse snapshot -i
-# Tablet
-npx monomind browse set device "iPad Pro"
-npx monomind browse screenshot tablet.png
-# Desktop wide
-npx monomind browse resize 1920 1080
-npx monomind browse screenshot desktop-wide.png
-# Dark mode
-npx monomind browse set media dark
-npx monomind browse screenshot dark-mode.png
-npx monomind browse set media light
-# Reset
-npx monomind browse resize 1280 800
-```
-### Phase 5 — Keyboard & Accessibility
-```bash
-# Tab order — tab through every focusable element
-npx monomind browse focus @e1
-npx monomind browse press Tab
-npx monomind browse snapshot -i       # repeat until full cycle
-# ARIA roles present
-npx monomind browse find role navigation
-npx monomind browse find role main
-npx monomind browse find role banner
-# Keyboard activation
-npx monomind browse press Enter        # activate focused element
-npx monomind browse press Escape       # close modals/dropdowns
-npx monomind browse press Space        # toggle checkboxes
-# Keyboard combos (key combos must use press, not keyboard)
-npx monomind browse press "Control+A"
-npx monomind browse press "Control+Z"
-```
-### Phase 6 — Network & Error Monitoring
-```bash
-# Start network capture before the flow
-npx monomind browse har start
-# ... run the flow ...
-npx monomind browse har stop --bodies --json   # --bodies only valid on stop
-# Check for failed requests during testing
-npx monomind browse network requests --json
-# Simulate offline
-npx monomind browse set offline true
-npx monomind browse snapshot -i        # should show graceful offline state
-npx monomind browse set offline false
-# Final error check
-npx monomind browse console           # all console output
-npx monomind browse errors            # JS exceptions only
-```
-### Phase 7 — Performance Audit
-```bash
-# Core Web Vitals
-npx monomind browse vitals --wait 3000 --json
-# Full trace (open DevTools-compatible)
-npx monomind browse trace start --screenshots
-# ... trigger the critical user flow ...
-npx monomind browse trace stop ./qa-trace.json
-# HAR for waterfall analysis
-npx monomind browse har start
-npx monomind browse navigate reload
-npx monomind browse wait --load networkidle
-npx monomind browse har stop --bodies --json
-```
-**Report vitals thresholds:**
-- LCP < 2.5s = PASS, 2.5–4s = WARN, >4s = FAIL
-- CLS < 0.1 = PASS, 0.1–0.25 = WARN, >0.25 = FAIL
-- FCP < 1.8s = PASS, 1.8–3s = WARN, >3s = FAIL
----
-## Core Testing Loop
-```
-OPEN → SNAPSHOT → ACT → SNAPSHOT → VERIFY → REPEAT
-```
-```bash
-npx monomind browse open <url>
-npx monomind browse snapshot -i
-npx monomind browse click @e1
-npx monomind browse fill @e2 "value"
-npx monomind browse press Enter
-npx monomind browse snapshot -i
-npx monomind browse get text @e5
-npx monomind browse get url
-npx monomind browse wait --text "Success"
-npx monomind browse errors
-```
----
-## Full Command Reference
-### Navigation & Window
-```bash
-npx monomind browse open <url>                    # open URL (launches Chrome if needed)
-npx monomind browse open <url> --headless         # headless mode
-npx monomind browse open <url> --session <name>   # restore saved session
-npx monomind browse open <url> --state <file>     # restore from state file
-npx monomind browse navigate back
-npx monomind browse navigate forward
-npx monomind browse navigate reload
-npx monomind browse pushstate /path               # SPA client-side nav
-npx monomind browse resize 1280 800
-npx monomind browse connect --port 9222           # attach to running Chrome
-npx monomind browse connect --port 9222 --target <id>
-npx monomind browse close
-```
-### Snapshot & Element Discovery
-```bash
-npx monomind browse snapshot                      # full AX tree
-npx monomind browse snapshot -i                   # interactive elements only
-npx monomind browse snapshot --compact            # compact format
-npx monomind browse snapshot --json               # machine-readable
-npx monomind browse snapshot --depth 3            # limit tree depth
-npx monomind browse snapshot --selector "#modal"  # scope to element
-npx monomind browse get url
-npx monomind browse get title
-npx monomind browse get text               # full page text
-npx monomind browse get text @eN          # element text
-npx monomind browse get html               # full page HTML (ref arg is ignored — always returns full doc)
-# for element HTML: npx monomind browse eval "document.querySelector('...').outerHTML"
-npx monomind browse get value @eN
-npx monomind browse get attr @eN href
-npx monomind browse get count "button"    # count elements matching CSS selector
-npx monomind browse get box @eN           # bounding box {x,y,width,height}
-npx monomind browse get styles @eN        # computed styles
-npx monomind browse is checked @eN
-```
-### Element Finders (semantic — no CSS selectors needed)
-```bash
-npx monomind browse find role button              # by ARIA role
-npx monomind browse find role button --name "Submit"
-npx monomind browse find text "Delete"            # by visible text
-npx monomind browse find label "Email"            # by label text
-npx monomind browse find testid "submit-btn"      # by data-testid
-npx monomind browse find alttext "Company logo"   # by alt attribute (images)
-npx monomind browse find title "More options"     # by title attribute (tooltips)
-npx monomind browse find role link --nth 2        # nth match
-npx monomind browse find role image --last        # last match
-npx monomind browse find placeholder "Search..."  # by placeholder text
-npx monomind browse find selector "div.modal"     # by CSS selector
-# Inline action after find
-npx monomind browse find role button --name "Submit" click
-npx monomind browse find label "Email" fill "test@example.com"
-npx monomind browse find text "Delete" click
-# State checks
-npx monomind browse is visible @eN
-npx monomind browse is enabled @eN
-npx monomind browse is checked @eN
-```
-### Window Management (Isolated Contexts)
-```bash
-# Open a new isolated browser window (like incognito — separate cookies/storage)
-npx monomind browse window new
-npx monomind browse window new https://app.example.com
-# Useful for multi-user testing (e.g. admin + regular user simultaneously):
-# 1. Connect once, then open isolated windows for each user role
-npx monomind browse connect --port 9222
-npx monomind browse window new                 # switches to new isolated context
-npx monomind browse open https://app.example.com/login
-npx monomind browse fill @e1 "admin@example.com"
-# ...
-# Tab management (within the same context)
-npx monomind browse tab                        # list all tabs
-npx monomind browse tab new https://example.com
-npx monomind browse tab close <tabId>
-npx monomind browse tab <tabId>               # switch to tab
-```
-### Interaction
-```bash
-npx monomind browse click @eN
-npx monomind browse click @eN --right            # right-click
-npx monomind browse click @eN --double           # double-click (or dblclick)
-npx monomind browse dblclick @eN
-npx monomind browse hover @eN
-npx monomind browse focus @eN
-npx monomind browse fill @eN "text"              # clear + type (fast)
-npx monomind browse type @eN "text"              # char-by-char (triggers keypress)
-npx monomind browse press Enter                  # key on focused element
-npx monomind browse press Tab
-npx monomind browse press Escape
-npx monomind browse press "Control+A"
-npx monomind browse press "Control+Shift+I"      # key combos always use press
-npx monomind browse keyboard type "Hello"        # insert text without targeting an element
-npx monomind browse keyboard inserttext "Hello"  # alias for keyboard type
-npx monomind browse keydown "Shift"
-npx monomind browse keyup "Shift"
-npx monomind browse select @eN "Option A"        # select dropdown option
-npx monomind browse check @eN
-npx monomind browse uncheck @eN
-npx monomind browse scroll down 300                     # positional amount (shorthand)
-npx monomind browse scroll down --amount 600            # scroll page
-npx monomind browse scroll down --ref eN --amount 400   # scroll within element ref
-npx monomind browse scroll down --selector ".sidebar" 300  # scroll within CSS selector
-npx monomind browse scrollintoview @eN
-npx monomind browse drag @eN @eM                 # drag source to target
-npx monomind browse upload @eN ./file.pdf        # file input
-npx monomind browse download @eN ./report.pdf   # click element, capture file download
-npx monomind browse download ".export-btn" ./data.csv --timeout 15000
-npx monomind browse highlight @eN               # visual debug highlight
-```
-### Low-Level Mouse
-```bash
-npx monomind browse mouse move 400 300
-npx monomind browse mouse down --button left
-npx monomind browse mouse down --button right
-npx monomind browse mouse up
-npx monomind browse mouse wheel 0 0 200          # x y deltaY [deltaX] — scroll down 200px
-```
-### Clipboard
-```bash
-npx monomind browse clipboard read
-npx monomind browse clipboard write "paste me"
-npx monomind browse clipboard copy    # copy selected text
-npx monomind browse clipboard paste   # paste at focused element
-```
-### Wait & Assertions
-```bash
-npx monomind browse wait --text "Success"
-npx monomind browse wait --not-text "Loading"
-npx monomind browse wait --url "**/dashboard"
-npx monomind browse wait --selector "#modal"
-npx monomind browse wait --load networkidle
-npx monomind browse wait --load load
-npx monomind browse wait --load domcontentloaded
-npx monomind browse wait --ms 500
-npx monomind browse wait --fn "window.__ready === true"
-npx monomind browse wait --text "Done" --timeout 10000
-npx monomind browse wait --download ./report.pdf    # wait for browser-triggered download to complete
-npx monomind browse wait --download ./data.csv --timeout 15000
-```
-### Element State Checks (Assertions)
-```bash
-npx monomind browse isvisible @e3          # true/false — is element visible?
-npx monomind browse isenabled @e2          # true/false — is element enabled (not disabled)?
-npx monomind browse ischecked @e1          # true/false — is checkbox/radio checked?
-# Also accepts CSS selectors
-npx monomind browse isvisible ".submit-btn"
-npx monomind browse isenabled "#email-input"
-npx monomind browse ischecked "input[name='agree']"
-# JSON output for scripting
-npx monomind browse isvisible @e4 --json   # → {"visible": true}
-```
-**Use in test scripts:**
-```bash
-# Run snapshot, then assert expected state
-npx monomind browse snapshot -i
-npx monomind browse click @e3             # click submit
-npx monomind browse wait --text "Success"
-npx monomind browse isvisible ".success-banner" --json
-```
-### Snapshot Regression Testing
-```bash
-# Save current snapshot as baseline
-npx monomind browse snapshot -i --save ./baselines/homepage.txt
-# Later: compare against baseline (colored diff: green=added, red=removed)
-npx monomind browse snapshot -i --diff ./baselines/homepage.txt
-# → Snapshot changed: +2 lines, -1 lines
-# + button "Sign Out" [@e12]
-# - button "Sign In" [@e8]
-# JSON output
-npx monomind browse snapshot -i --diff ./baselines/homepage.txt --json
-# Content-safety flags (for agentic pipelines with untrusted pages)
-npx monomind browse snapshot --content-boundaries          # wrap output in sentinel markers to prevent injection
-npx monomind browse snapshot --max-output 10000            # truncate to 10k chars (prevents context blowout)
-npx monomind browse snapshot --content-boundaries --max-output 8000  # both together
-# Compare two URLs side-by-side (navigates to each, diffs their snapshots)
-npx monomind browse diff url https://staging.example.com https://prod.example.com
-npx monomind browse diff url https://app.com/v1 https://app.com/v2 --interactive
-npx monomind browse diff url https://before.com https://after.com --json
-```
-### Mobile Testing (Touch Events)
-```bash
-# Tap with touch event — useful for mobile-emulated layouts
-npx monomind browse tap @e4
-npx monomind browse tap ".mobile-nav-toggle"
-# Swipe gestures — 10-step smooth touchMove sequence
-npx monomind browse swipe up                        # swipe up 300px from center
-npx monomind browse swipe down 500                  # swipe down 500px
-npx monomind browse swipe left --x 300 --y 400     # swipe left from (300,400)
-npx monomind browse swipe right 200 --x 50 --y 300 # swipe right 200px
-# Combine with device emulation
-npx monomind browse set device "iPhone 14"
-npx monomind browse snapshot -i
-npx monomind browse tap @e2
-npx monomind browse swipe up 400                    # scroll via swipe on mobile
-```
-### Screenshots & Visual Evidence
-```bash
-npx monomind browse screenshot before.png
-npx monomind browse screenshot --full page.png             # full-page
-npx monomind browse screenshot --annotate out.png          # overlay @eN numbered labels (requires prior snapshot -i)
-npx monomind browse screenshot --hide-scrollbars clean.png # hide native scrollbars via CSS injection
-npx monomind browse screenshot --format webp --quality 90 out.webp
-npx monomind browse screenshot --json                      # returns path as JSON
-npx monomind browse pdf ./output.pdf
-npx monomind browse pdf --landscape ./report.pdf
-```
-**`--annotate` pattern:** always run `snapshot -i` first to populate refs, then `screenshot --annotate` to produce a screenshot with numbered labels at each element's position. Numbers match the `@eN` refs from the snapshot, so you can point to elements by number in bug reports.
-> **Note:** `--annotate` uses viewport-relative coordinates — do not combine with `--full`. On full-page captures, badges will be misaligned below the fold.
-```bash
-npx monomind browse snapshot -i
-npx monomind browse screenshot --annotate ./issue-001.png
-# → labels [1] [2] [3]... appear at each interactive element
-```
-### Console, Errors & JavaScript
-> **Console capture is always-on.** As soon as you `open` or `connect`, monobrowse hooks `Runtime.consoleAPICalled`, `Log.entryAdded`, and `Runtime.exceptionThrown` automatically. No `capture start` needed — messages accumulate in memory and `console`/`errors` read from that buffer at any time.
-```bash
-npx monomind browse console                      # all log/warn/error/info messages since connect
-npx monomind browse console --errors-only        # filter to error level only
-npx monomind browse console --clear              # reset the buffer
-npx monomind browse console --json               # machine-readable [{type, text, timestamp}]
-npx monomind browse errors                       # uncaught JS exceptions (Runtime.exceptionThrown)
-npx monomind browse errors --json                # [{text, url, lineNumber, columnNumber, timestamp}]
-npx monomind browse errors --clear
-npx monomind browse eval "document.title"
-npx monomind browse eval "document.querySelectorAll('button').length"
-npx monomind browse eval "window.__store.getState()" --json
-# Multiline JS via heredoc (--stdin reads from stdin)
-cat <<'EOF' | npx monomind browse eval --stdin
-  const items = document.querySelectorAll('li');
-  JSON.stringify([...items].map(i => i.textContent.trim()))
-EOF
-npx monomind browse addinitscript "window.__TEST__ = true"   # runs on every page load
-npx monomind browse removeinitscript <id>
-```
-### Network
-```bash
-# Route interception
-npx monomind browse network route --pattern "https://api.*" --abort
-npx monomind browse network route --pattern "*/graphql" --fulfill '{"data":{}}' --status 200
-npx monomind browse network route --pattern "*.png" --abort
-npx monomind browse network unroute                           # disable ALL interception (pattern arg is ignored)
-# Extra headers for all requests
-npx monomind browse network headers --headers '{"X-Test":"true"}'
-# Request log
-npx monomind browse network capture start
-npx monomind browse network capture stop
-npx monomind browse network capture clear
-npx monomind browse network requests --json
-npx monomind browse network requests --filter "api/users"            # filter by URL substring
-npx monomind browse network requests --method POST                   # filter by HTTP method
-npx monomind browse network requests --status-code 200               # filter by status code
-npx monomind browse network requests --type xhr                      # filter by resource type
-npx monomind browse network request <requestId>                      # full detail for one request
-npx monomind browse network cookies             # cookies via network layer
-```
-### Tabs & Frames
-```bash
-npx monomind browse tab list
-npx monomind browse tab new https://example.com
-npx monomind browse tab <targetId>               # switch to tab by id
-npx monomind browse tab close <targetId>
-npx monomind browse frame @eN                    # switch into iframe
-npx monomind browse frame main                   # back to main frame
-```
-### Dialogs
-```bash
-# Auto-accepted by default. Override:
-npx monomind browse dialog accept
-npx monomind browse dialog accept "confirm text"
-npx monomind browse dialog dismiss
-npx monomind browse dialog status
-```
-### Storage & Cookies
-```bash
-npx monomind browse storage local                        # list all entries
-npx monomind browse storage local <key>                  # get a specific key
-npx monomind browse storage local <key> --set "value"    # set a key
-npx monomind browse storage local <key> --remove         # remove a key
-npx monomind browse storage local --clear                # clear all
-npx monomind browse storage session                      # list all session entries
-npx monomind browse storage session <key>                # get session key
-npx monomind browse cookies list
-npx monomind browse cookies set --name token --value abc123
-npx monomind browse cookies clear
-```
-### Device & Emulation
-```bash
-npx monomind browse set device "iPhone 14"
-npx monomind browse set device "Galaxy S21"
-npx monomind browse set device "iPad Pro"
-npx monomind browse set media dark
-npx monomind browse set media light
-npx monomind browse set geo 37.7749 -122.4194
-npx monomind browse set offline true
-npx monomind browse set offline false
-npx monomind browse set useragent "Mozilla/5.0 ..."
-npx monomind browse set viewport 1440 900          # width height [deviceScaleFactor]
-npx monomind browse set credentials user pass
-```
-### Session Persistence
-```bash
-npx monomind browse state save <name>
-npx monomind browse state load <name>
-npx monomind browse state list
-npx monomind browse state show        # inspect current active session
-npx monomind browse state clear       # clear current active session
-npx monomind browse state rename <old> <new>           # rename a saved session
-npx monomind browse state clean --older-than 7         # delete sessions older than N days (default: 7)
-```
-### Performance & Diagnostics
-> **DevTools panel coverage:**
-> ✅ Console panel — `console` / `errors` (always-on, see above)
-> ✅ Network panel — `network requests` + filters, `network request <id>`, `har start/stop --bodies`
-> ✅ Performance panel — `trace start/stop` (exports Chrome DevTools-compatible `.json`)
-> ✅ Memory panel — `profiler heap ./heap.json` (heap snapshot)
-> ✅ Application panel — `storage`, `cookies`
-> ✅ Sources / JS eval — `eval`, `eval --stdin`, `addinitscript`
-> ❌ Not available: source-map resolution for error stacks, live network waterfall, Lighthouse audit scores, Total Blocking Time metric
-```bash
-# Core Web Vitals (LCP < 2.5s PASS, 2.5–4s WARN, >4s FAIL)
-npx monomind browse vitals --wait 3000 --json
-# CPU profiler
-npx monomind browse profiler start --interval 1000   # interval in microseconds (1000µs = 1ms)
-npx monomind browse profiler stop --json
-# Heap snapshot
-npx monomind browse profiler heap ./heap.json
-# Chrome trace (load in chrome://tracing or Perfetto)
-npx monomind browse trace start --screenshots
-npx monomind browse trace stop ./trace.json
-npx monomind browse trace status
-# HAR (full HTTP archive with request/response bodies)
-npx monomind browse har start
-npx monomind browse har status
-npx monomind browse har stop --bodies --json   # --bodies only valid on stop
-# Screen recording (frame sequence)
-npx monomind browse record start --format jpeg --quality 80
-npx monomind browse record status
-npx monomind browse record stop --json
-npx monomind browse record restart ./take2.mp4   # atomically stop+start (no page reload)
-```
-### Batch Execution
-```bash
-# Run multiple commands in one CDP session (fastest for scripted flows)
-npx monomind browse batch "open https://app.com" "snapshot -i" "click @e3" "wait --text Done"
-npx monomind browse batch --bail "open https://app.com" "click @e3"   # stop on first error
-# Note: --json stdin pipe flag is declared but not implemented; use positional args only
-```
----
-## Common QA Patterns
-### Login / Auth Flow
-```bash
-npx monomind browse open <login-url>
-npx monomind browse snapshot -i
-npx monomind browse fill @e1 "user@test.com"
-npx monomind browse fill @e2 "TestPass123!"
-npx monomind browse click @e3
-npx monomind browse wait --url "**/dashboard" --timeout 8000
-npx monomind browse errors
-npx monomind browse screenshot post-login.png
-```
-### Form with Validation
-```bash
-npx monomind browse open <form-url>
-npx monomind browse snapshot -i
-# Happy path
-npx monomind browse fill @e1 "John Doe"
-npx monomind browse fill @e2 "john@test.com"
-npx monomind browse select @e3 "Option A"
-npx monomind browse check @e4
-npx monomind browse click @e5
-npx monomind browse wait --text "submitted"
-npx monomind browse screenshot form-success.png
-# Validation
-npx monomind browse navigate back
-npx monomind browse click @e5                    # submit empty
-npx monomind browse snapshot -i                  # should show errors
-```
-### Multi-Step Wizard
-```bash
-npx monomind browse open <wizard-url>
-npx monomind browse snapshot -i
-npx monomind browse fill @e1 "value"
-npx monomind browse click @e2
-npx monomind browse wait --text "Step 2"
-npx monomind browse snapshot -i
-npx monomind browse select @e3 "choice"
-npx monomind browse click @e4
-npx monomind browse wait --text "Complete"
-npx monomind browse screenshot wizard-complete.png
-```
-### CRUD Operations
-```bash
-# Create
-npx monomind browse click @new_btn
-npx monomind browse fill @name_field "New Item"
-npx monomind browse click @save_btn
-npx monomind browse wait --text "New Item"
-# Update
-npx monomind browse find text "Edit" click
-npx monomind browse fill @name_field "Updated Item"
-npx monomind browse click @save_btn
-npx monomind browse wait --text "Updated Item"
-# Delete
-npx monomind browse find text "Delete" click
-npx monomind browse wait --text "Are you sure"
-npx monomind browse click @confirm_btn
-npx monomind browse wait --load networkidle
-```
-### API Mock Testing
-```bash
-# Intercept API, return controlled data
-npx monomind browse network route --pattern "*/api/users" --fulfill '{"users":[]}' --status 200
-npx monomind browse open <url>
-npx monomind browse snapshot -i           # should show empty state UI
-npx monomind browse screenshot empty-state.png
-# Intercept with error
-npx monomind browse network route --pattern "*/api/users" --fulfill '{"error":"forbidden"}' --status 403
-npx monomind browse navigate reload
-npx monomind browse snapshot -i           # should show error state
-```
----
-## Dogfood / Exploratory QA Mode
-When asked to "dogfood", "QA", "find bugs", "exploratory test", or "bug hunt" a web app:
-### Setup
-```bash
-mkdir -p ./dogfood-output/screenshots ./dogfood-output/videos
-```
-### Workflow
-```
-1. Orient    → open URL, initial annotated screenshot, snapshot -i
-2. Explore   → visit each major section, test interactive elements
-3. Document  → screenshot + record for each issue found (as you go, not at end)
-4. Wrap up   → re-check console errors, write summary
-```
-### At each page
-```bash
-npx monomind browse snapshot -i                                              # find interactive elements
-npx monomind browse screenshot --annotate ./dogfood-output/screenshots/<page>.png  # annotated overview
-npx monomind browse errors                                                   # check for JS errors
-npx monomind browse console                                                  # check console output
-```
-### Documenting an issue (repro-first)
-For **interactive/behavioral bugs** (require clicking or typing to reproduce):
-```bash
-# 1. Start recording before reproducing
-npx monomind browse record start
-# 2. Walk through the steps (use type not fill during recording — shows keystrokes)
-npx monomind browse screenshot ./dogfood-output/screenshots/issue-001-step1.png
-npx monomind browse type @eN "input value"
-npx monomind browse click @eM
-npx monomind browse screenshot --annotate ./dogfood-output/screenshots/issue-001-result.png
-# 3. Stop recording
-npx monomind browse record stop --json   # returns path to frames JSON
-```
-For **static/visible-on-load bugs** (typos, layout, placeholder text):
-```bash
-npx monomind browse screenshot --annotate ./dogfood-output/screenshots/issue-001.png
-# Single annotated screenshot is sufficient — no recording needed
-```
-### `type` vs `fill` during recording
-Use `type` (character-by-character) when recording a video so keystrokes are visible in the recording. Use `fill` (instant clear + set) for speed outside recording.
-### Reporting
-Aim for 5–10 well-documented issues. Depth of evidence (annotated screenshots, step-by-step repro) beats quantity. Append each issue as you find it — never batch for the end.
----
-## Task Walkthrough Mode
-When helping a user accomplish a task in a live UI:
-1. Ask for the URL if not provided
-2. `open` + `snapshot -i` — describe what's on screen (title, sections, available actions)
-3. Propose the steps to accomplish the task
-4. Execute step by step, narrating each action and what changed
-5. Confirm completion with a screenshot
-```bash
-npx monomind browse open https://app.example.com
-npx monomind browse snapshot -i
-# → "I see: navbar with 'New Project' @e3, project list below with 2 items"
-npx monomind browse click @e3
-npx monomind browse snapshot -i
-# → "Modal opened: Name field @e8, Template selector @e9, Create @e11"
-npx monomind browse fill @e8 "My Project"
-npx monomind browse click @e11
-npx monomind browse wait --text "My Project"
-npx monomind browse screenshot created.png
-# → "Project created — visible in list"
-```
----
-## QA Report Format
-After every test session output a structured report:
-```
-## QA Report — <url> — <date>
-### Summary
-- Pages tested: N
-- Total checks: N
-- PASS: N  WARN: N  FAIL: N
-### Results
-PASS  Login flow completes and redirects to /dashboard
-PASS  Form validation shows errors on empty submit
-WARN  LCP = 3.2s (threshold: 2.5s) — images not lazy-loaded
-FAIL  Delete confirmation dialog blocks further automation — avoid triggering
-FAIL  Mobile layout: navigation overflows viewport at 375px
-### JS Errors
-<list from `npx monomind browse errors`>
-### Performance
-LCP: Xs  CLS: X  FCP: Xs  TTFB: Xms
-### Screenshots
-- before-action.png
-- after-action.png
-- mobile-portrait.png
-```
----
-## Memory Integration
-```bash
-# Store successful test patterns after a passing run
-npx monomind memory store \
-  --namespace ui-testing \
-  --key "login-flow-<app-name>" \
-  --value "open→snapshot -i→fill @e1 email→fill @e2 pass→click @e3→wait dashboard"
-# Retrieve before re-testing the same app
-npx monomind memory search --query "login flow" --namespace ui-testing
-```
----
-## Electron App Automation
-Automate any Electron desktop app (VS Code, Slack, Discord, Figma, Notion, Spotify) via CDP — same snapshot-interact workflow as for web pages.
-### Launch with CDP port
-```bash
-# macOS — quit the app first if already running
-open -a "Slack"   --args --remote-debugging-port=9222
-open -a "Visual Studio Code" --args --remote-debugging-port=9223
-open -a "Discord" --args --remote-debugging-port=9224
-open -a "Figma"   --args --remote-debugging-port=9225
-open -a "Notion"  --args --remote-debugging-port=9226
-# Linux
-slack --remote-debugging-port=9222
-code  --remote-debugging-port=9223
-# Windows
-"C:\...\slack.exe" --remote-debugging-port=9222
-```
-### Connect and interact
-```bash
-# Connect to a specific port
-npx monomind browse connect --port 9222
-# Auto-discover any running Chromium-based app on ports 9222 or 9229
-npx monomind browse connect --auto-connect
-# Standard workflow from here
-npx monomind browse snapshot -i
-npx monomind browse click @e5
-npx monomind browse screenshot --annotate slack-desktop.png
-```
-`--auto-connect` probes ports 9222 and 9229 in order and connects to the first responding Chrome/Electron instance.
-### Tab and webview management
-Electron apps often have multiple windows or embedded webviews:
-```bash
-npx monomind browse tab                  # list all tabs/webviews (shows targetId for each)
-npx monomind browse tab <targetId>       # switch to tab by its targetId
-npx monomind browse tab new              # open a new tab
-```
----
-## Activation Checklist
-When this skill fires:
-- [ ] Get the URL (ask if not provided — or use `--auto-connect` for Electron apps)
-- [ ] Run `open` + `errors` baseline
-- [ ] Run all 7 QA phases (or subset the user requested)
-- [ ] Screenshot key states: initial, post-action, errors, mobile
-- [ ] Run `vitals` for any performance claim
-- [ ] Output structured QA report with PASS/WARN/FAIL
-- [ ] Store patterns in memory if the flow was new and successful