@questpie/probe 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,111 @@
+# QUESTPIE Probe
+
+Dev testing CLI for AI coding agents. Orchestrates dev servers, aggregates logs, controls browsers, sends HTTP requests, records and replays tests.
+
+**[Documentation](https://probe.questpie.com/docs)** | **[GitHub](https://github.com/questpie/probe)**
+
+## Install
+
+```bash
+# Install the CLI
+bun add -g @questpie/probe
+
+# Install the AI skill (for Claude Code, Cursor, Windsurf)
+bunx skills add questpie/probe
+```
+
+## Quick Start
+
+```bash
+# Initialize config
+qprobe init
+
+# Start a server with ready detection
+qprobe start server "bun dev" --ready "ready on" --port 3000
+
+# Check health
+qprobe health http://localhost:3000/api/health
+
+# Make HTTP requests
+qprobe http GET /api/users --status 200
+qprobe http POST /api/users -d '{"name":"test"}' --jq ".id"
+
+# Read logs
+qprobe logs server --grep "ERROR"
+qprobe logs --all --level error
+
+# Browser control
+qprobe browser open http://localhost:3000
+qprobe browser snapshot -i
+qprobe browser click @e1
+qprobe browser fill @e2 "hello"
+
+# Record & replay
+qprobe record start "login-flow"
+qprobe record stop
+qprobe replay "login-flow"
+
+# Compose (from qprobe.config.ts)
+qprobe compose up
+qprobe compose status
+qprobe compose down
+
+# Assertions
+qprobe assert status 200 /api/health
+qprobe assert no-errors
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `qprobe start` | Start a background process with ready detection |
+| `qprobe stop` | Stop a process (SIGTERM → SIGKILL) |
+| `qprobe restart` | Restart with saved config |
+| `qprobe ps` | List running processes |
+| `qprobe health` | Poll URL until it responds |
+| `qprobe logs` | Read logs with grep, level, follow |
+| `qprobe http` | HTTP requests with assertions |
+| `qprobe check` | Quick health + status overview |
+| `qprobe compose` | Manage service stack from config |
+| `qprobe browser` | 27 browser control subcommands |
+| `qprobe record` | Record browser actions |
+| `qprobe replay` | Replay as Playwright tests |
+| `qprobe recordings` | Manage recordings |
+| `qprobe assert` | Run assertions |
+| `qprobe init` | Scaffold config |
+
+## Config
+
+```typescript
+// qprobe.config.ts
+import { defineConfig } from '@questpie/probe'
+
+export default defineConfig({
+  services: {
+    db: {
+      cmd: 'docker compose up postgres',
+      ready: 'ready to accept connections',
+      health: 'http://localhost:5432',
+    },
+    server: {
+      cmd: 'bun dev',
+      ready: 'ready on http://localhost:3000',
+      port: 3000,
+      health: '/api/health',
+      depends: ['db'],
+    },
+  },
+  browser: {
+    driver: 'agent-browser',
+    baseUrl: 'http://localhost:3000',
+  },
+  http: {
+    baseUrl: 'http://localhost:3000',
+  },
+})
+```
+
+## License
+
+MIT

package/dist/{check-Cny-3lkZ.js → check-1Y6cPMkN.js}

@@ -2,7 +2,7 @@ import "./duration-DUrbfMLK.js";
 import { loadProbeConfig, resolveBaseUrl } from "./config-BUEMgFYN.js";
 import { error, info, success, warn } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { listProcesses } from "./process-manager-CzexpFO4.js";
+import { listProcesses } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 import { ofetch } from "ofetch";
 

package/dist/cli.js

@@ -1,28 +1,55 @@
-import { defineCommand, runMain } from "citty";
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { defineCommand, runMain, showUsage } from "citty";
+import { consola } from "consola";
 
 //#region src/cli.ts
 const main = defineCommand({
 	meta: {
 		name: "qprobe",
-		version: "0.1.0",
+		version: "0.1.2",
 		description: "Dev testing CLI for AI coding agents"
 	},
 	subCommands: {
-		start: () => import("./start-BClY6oJq.js").then((m) => m.default),
-		stop: () => import("./stop-QAP6gbDe.js").then((m) => m.default),
-		restart: () => import("./restart-By3Edj5X.js").then((m) => m.default),
-		ps: () => import("./ps-DuHF7vmE.js").then((m) => m.default),
+		start: () => import("./start-BJnzhZp9.js").then((m) => m.default),
+		stop: () => import("./stop-C0xDWnnB.js").then((m) => m.default),
+		restart: () => import("./restart-CEzd2Mgn.js").then((m) => m.default),
+		ps: () => import("./ps-UFZx0jy0.js").then((m) => m.default),
 		health: () => import("./health-B36ufFzJ.js").then((m) => m.default),
-		compose: () => import("./compose-D5a8qHkg.js").then((m) => m.default),
-		logs: () => import("./logs-BCgur07G.js").then((m) => m.default),
+		compose: () => import("./compose-1CYahcRa.js").then((m) => m.default),
+		logs: () => import("./logs-BIt5sCky.js").then((m) => m.default),
 		http: () => import("./http-BZouO1Cj.js").then((m) => m.default),
-		check: () => import("./check-Cny-3lkZ.js").then((m) => m.default),
+		check: () => import("./check-1Y6cPMkN.js").then((m) => m.default),
 		browser: () => import("./browser-DoCXU5Bs.js").then((m) => m.default),
 		record: () => import("./record-C4SmoPsT.js").then((m) => m.default),
 		replay: () => import("./replay-Dg9PHNrg.js").then((m) => m.default),
 		recordings: () => import("./recordings-Cb31alos.js").then((m) => m.default),
 		assert: () => import("./assert-BLP5_JwC.js").then((m) => m.default),
 		init: () => import("./init-BjTfn_-A.js").then((m) => m.default)
+	},
+	async run({ cmd }) {
+		const hasConfig = existsSync("qprobe.config.ts") || existsSync("qprobe.config.js") || existsSync("qprobe.config.mjs");
+		if (hasConfig) {
+			await showUsage(cmd);
+			return;
+		}
+		consola.log("");
+		consola.log("\x1B[1m\x1B[38;2;183;0;255m  QUESTPIE Probe\x1B[0m  \x1B[2mv0.1.2\x1B[0m");
+		consola.log("  Dev testing CLI for AI coding agents");
+		consola.log("");
+		consola.log("  \x1B[1mGet started:\x1B[0m");
+		consola.log("");
+		consola.log("    \x1B[36mqprobe init\x1B[0m                          Scaffold qprobe.config.ts");
+		consola.log("    \x1B[36mbunx skills add questpie/probe\x1B[0m       Teach your AI agent to use Probe");
+		consola.log("");
+		consola.log("  \x1B[2mOr skip the config and start using it:\x1B[0m");
+		consola.log("");
+		consola.log("    \x1B[36mqprobe start server \"bun dev\" --ready \"ready on\" --port 3000\x1B[0m");
+		consola.log("    \x1B[36mqprobe http GET /api/health --status 200\x1B[0m");
+		consola.log("    \x1B[36mqprobe logs server --grep \"ERROR\"\x1B[0m");
+		consola.log("");
+		consola.log("  \x1B[2mDocs:\x1B[0m \x1B[4mhttps://probe.questpie.com/docs\x1B[0m");
+		consola.log("");
 	}
 });
 runMain(main);

package/dist/{compose-D5a8qHkg.js → compose-1CYahcRa.js}

@@ -2,7 +2,7 @@ import "./duration-DUrbfMLK.js";
 import { loadProbeConfig } from "./config-BUEMgFYN.js";
 import { error, info, json, success, table } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { listProcesses, startProcess, stopProcess } from "./process-manager-CzexpFO4.js";
+import { listProcesses, startProcess, stopProcess } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 import { ofetch } from "ofetch";
 
@@ -163,7 +163,7 @@ const restart = defineCommand({
 					error(`Unknown service: "${args.name}"`);
 					process.exit(1);
 				}
-				const { stopProcess: stopProcess$1, startProcess: startProcess$1 } = await import("./process-manager-zzltWvZ0.js");
+				const { stopProcess: stopProcess$1, startProcess: startProcess$1 } = await import("./process-manager-BVSQm3gK.js");
 				try {
 					await stopProcess$1(args.name);
 				} catch {}

package/dist/{logs-BCgur07G.js → logs-BIt5sCky.js}

@@ -2,8 +2,8 @@ import { parseDuration } from "./duration-DUrbfMLK.js";
 import { error, info, json, log } from "./output-CHUjdVDf.js";
 import { getLogPath, listProcessNames } from "./state-DRTSIt_r.js";
 import { defineCommand } from "citty";
-import { readFile, stat } from "node:fs/promises";
 import { consola } from "consola";
+import { readFile, stat } from "node:fs/promises";
 import { watch } from "chokidar";
 
 //#region src/core/log-reader.ts

package/dist/{process-manager-zzltWvZ0.js → process-manager-BVSQm3gK.js}

@@ -1,4 +1,4 @@
 import "./state-DRTSIt_r.js";
-import { getProcessState, listProcesses, startProcess, stopAll, stopProcess } from "./process-manager-CzexpFO4.js";
+import { getProcessState, listProcesses, startProcess, stopAll, stopProcess } from "./process-manager-CITbaM9X.js";
 
 export { startProcess, stopProcess };

package/dist/{process-manager-CzexpFO4.js → process-manager-CITbaM9X.js}

@@ -1,7 +1,7 @@
 import { ensureLogsDir, getLogPath, listProcessNames, readPid, readState, removePid, removeState, savePid, saveState } from "./state-DRTSIt_r.js";
+import { openSync } from "node:fs";
 import { appendFile } from "node:fs/promises";
 import { spawn } from "node:child_process";
-import { openSync } from "node:fs";
 
 //#region src/core/log-writer.ts
 function timestamp() {

package/dist/{ps-DuHF7vmE.js → ps-UFZx0jy0.js}

@@ -1,6 +1,6 @@
 import { info, json, table } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { listProcesses } from "./process-manager-CzexpFO4.js";
+import { listProcesses } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 
 //#region src/commands/ps.ts

package/dist/{restart-By3Edj5X.js → restart-CEzd2Mgn.js}

@@ -1,6 +1,6 @@
 import { error, success } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { getProcessState, startProcess, stopProcess } from "./process-manager-CzexpFO4.js";
+import { getProcessState, startProcess, stopProcess } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 
 //#region src/commands/restart.ts

package/dist/{start-BClY6oJq.js → start-BJnzhZp9.js}

@@ -1,7 +1,7 @@
 import { parseDuration } from "./duration-DUrbfMLK.js";
 import { error, success } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { startProcess } from "./process-manager-CzexpFO4.js";
+import { startProcess } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 
 //#region src/commands/start.ts

package/dist/{stop-QAP6gbDe.js → stop-C0xDWnnB.js}

@@ -1,6 +1,6 @@
 import { error, success } from "./output-CHUjdVDf.js";
 import "./state-DRTSIt_r.js";
-import { stopAll, stopProcess } from "./process-manager-CzexpFO4.js";
+import { stopAll, stopProcess } from "./process-manager-CITbaM9X.js";
 import { defineCommand } from "citty";
 
 //#region src/commands/stop.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@questpie/probe",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Dev testing CLI for AI coding agents",
   "license": "MIT",
   "type": "module",
@@ -50,7 +50,7 @@
       "optional": false
     },
     "@playwright/test": {
-      "optional": true
+      "optional": false
     }
   },
   "keywords": [

package/skills/qprobe/SKILL.md

@@ -7,7 +7,8 @@ description: "QUESTPIE Probe — dev testing CLI for AI coding agents. Orchestra
 
 Dev testing CLI. Manages dev servers, reads logs, controls browsers, sends HTTP requests, records and replays tests.
 
-**Install:** `npm install -g @questpie/probe`
+**Install CLI:** `bun add -g @questpie/probe`
+**Install skill:** `bunx skills add questpie/probe`
 
 ## Core Principle
 

package/skills/{qprobe-ux/SKILL.md → qprobe/references/ux.md}

@@ -1,7 +1,3 @@
----
-name: qprobe-ux
-description: "UX testing and evaluation using QUESTPIE Probe. Run heuristic evaluations, task completion tests, navigation audits, accessibility checks, and A/B comparisons on running web apps. Use when: evaluating usability, checking UX quality, auditing user flows, comparing two versions, finding UX issues, testing if users can complete tasks. Triggers: 'review the UX', 'is this usable', 'can a user find X', 'compare these two versions', 'UX audit', 'heuristic evaluation', 'test the onboarding flow', 'is the checkout intuitive', 'find usability problems', 'accessibility check'. Use even for 'does this make sense' or 'is this confusing' in context of a web UI."
----
 
 # qprobe-ux — UX Testing Skill
 

package/skills/qprobe-browser/SKILL.md

@@ -1,87 +0,0 @@
----
-name: qprobe-browser
-description: "QUESTPIE Probe browser control. Accessibility tree snapshots with @e refs, click, fill, screenshot, console logs, network monitoring, JS errors, snapshot diffs. Powered by agent-browser. Use when: testing web UI, checking browser console, inspecting network requests, taking screenshots, filling forms, clicking buttons, checking for JS errors. Triggers: 'open the browser', 'check the page', 'click the button', 'fill the form', 'any console errors', 'network tab', 'screenshot', 'what does the page look like'. Use even for 'check if the UI works' or 'test the frontend'."
----
-
-# qprobe — Browser Control
-
-Token-efficient browser automation via accessibility tree snapshots and `@e` refs.
-
-**Install:** `npm install -g @questpie/probe`
-
-## Core Workflow
-
-```bash
-qprobe browser open http://localhost:3000/login
-qprobe browser snapshot -i            # interactive elements only (~200 tokens)
-# - textbox "Email" [@e1]
-# - textbox "Password" [@e2]
-# - button "Sign In" [@e3]
-
-qprobe browser fill @e1 "admin@test.com"
-qprobe browser fill @e2 "password123"
-qprobe browser click @e3
-qprobe browser wait --url "/dashboard"
-qprobe browser snapshot --diff         # only what changed
-```
-
-## Snapshot Flags
-
-| Flag | Short | Effect |
-|------|-------|--------|
-| `--interactive` | `-i` | Only buttons, inputs, links (recommended) |
-| `--compact` | `-c` | Remove empty structural elements |
-| `--depth <n>` | `-d` | Limit tree depth |
-| `--selector <css>` | `-s` | Scope to element |
-| `--diff` | | Show changes since last snapshot |
-
-**Always use `-i` by default.** Full snapshots waste tokens on decorative elements.
-
-## Interaction (via @e refs or CSS selectors)
-
-```bash
-qprobe browser click @e3
-qprobe browser fill @e1 "text"
-qprobe browser select @e4 "value"
-qprobe browser check @e5
-qprobe browser press Enter
-qprobe browser type "hello"
-qprobe browser hover @e2
-qprobe browser scroll down 500
-```
-
-## Inspection (NO BROWSER WINDOW NEEDED)
-
-```bash
-qprobe browser console                # console messages (log, warn, error)
-qprobe browser console --level error  # only errors
-qprobe browser errors                 # uncaught JS exceptions
-qprobe browser network                # HTTP request log
-qprobe browser network --failed       # only 4xx/5xx
-qprobe browser eval "document.title"  # execute JS
-qprobe browser text "#main"           # extract text content
-```
-
-## Screenshots
-
-```bash
-qprobe browser screenshot             # basic
-qprobe browser screenshot --annotate  # with @e labels overlaid
-qprobe browser screenshot --full      # full page scroll
-```
-
-## Waiting
-
-```bash
-qprobe browser wait @e1               # element exists
-qprobe browser wait --url "/dashboard" # URL changed
-qprobe browser wait --text "Welcome"   # text appeared
-qprobe browser wait --network idle     # no pending requests
-```
-
-## Tips for Agents
-
-- `snapshot -i` saves tokens — use it always
-- `snapshot --diff` after actions — see only changes
-- Check `console --level error` and `network --failed` before visual debugging
-- `screenshot --annotate` is useful when you need visual context

package/skills/qprobe-compose/SKILL.md

@@ -1,81 +0,0 @@
----
-name: qprobe-compose
-description: "QUESTPIE Probe compose — multi-service orchestration with dependency graphs. Start DB, server, admin, workers in correct order with health checks. Config via qprobe.config.ts. Use when: starting a full dev stack, managing multiple services, need database + server + frontend running together. Triggers: 'start everything', 'compose up', 'start the stack', 'bring up the dev environment', 'start db and server'. Use when project has multiple services that need to start in order."
----
-
-# qprobe — Compose
-
-Multi-service orchestration with dependency resolution and health checks.
-
-**Install:** `npm install -g @questpie/probe`
-
-## Usage
-
-```bash
-qprobe compose up          # start all services in dependency order
-qprobe compose down        # stop all in reverse order
-qprobe compose restart     # restart all
-qprobe compose status      # show service states
-```
-
-## Config (`qprobe.config.ts`)
-
-```typescript
-import { defineConfig } from '@questpie/probe'
-
-export default defineConfig({
-  services: {
-    db: {
-      cmd: 'docker compose up postgres',
-      ready: 'ready to accept connections',
-    },
-    server: {
-      cmd: 'bun dev',
-      ready: 'ready on http://localhost:3000',
-      port: 3000,
-      health: '/api/health',
-      depends: ['db'],
-    },
-    admin: {
-      cmd: 'bun run admin:dev',
-      ready: 'ready on http://localhost:3001',
-      port: 3001,
-      depends: ['server'],
-    },
-  },
-})
-```
-
-## What Happens
-
-```bash
-qprobe compose up
-# ⏳ Starting db... ready (2.3s)
-# ⏳ Starting server... ready (4.1s)    ← waited for db first
-# ⏳ Starting admin... ready (3.5s)     ← waited for server first
-# ✅ All 3 services ready (9.9s)
-```
-
-Dependency graph resolved automatically. Parallel start where possible.
-
-## Flags
-
-| Flag | Description |
-|------|-------------|
-| `--only <names>` | Start only these (+ dependencies) |
-| `--skip <names>` | Skip these services |
-| `--no-health` | Don't wait for health checks |
-
-```bash
-qprobe compose up --only server     # starts db (dep) + server
-qprobe compose up --skip admin      # starts db + server, skips admin
-```
-
-## Inline (No Config File)
-
-```bash
-qprobe compose up \
-  --service "db: docker compose up postgres | ready to accept" \
-  --service "server: bun dev | ready on" \
-  --depends "server:db"
-```

package/skills/qprobe-http/SKILL.md

@@ -1,67 +0,0 @@
----
-name: qprobe-http
-description: "QUESTPIE Probe HTTP requests. Send API requests against running dev servers with auto baseUrl, Bearer auth, status assertions, JQ filtering, verbose mode. Cheaper than browser for API testing. Use when: testing API endpoints, checking server responses, CRUD operations, verifying auth, debugging 500 errors. Triggers: 'call the API', 'test the endpoint', 'POST to /api/users', 'check if the API works', 'what does the server return', 'send a request'. Prefer this over browser for any API-only testing."
----
-
-# qprobe — HTTP Requests
-
-API testing with auto-resolved baseUrl. Cheaper than browser for backend testing.
-
-**Install:** `npm install -g @questpie/probe`
-
-## Usage
-
-```bash
-qprobe http <METHOD> <path> [flags]
-```
-
-Path is relative — baseUrl auto-resolved from config or running services.
-
-## Examples
-
-```bash
-# Basic
-qprobe http GET /api/users
-qprobe http GET /api/users/1
-
-# POST with body
-qprobe http POST /api/users -d '{"name":"New","email":"new@test.com"}'
-
-# Auth
-qprobe http GET /api/admin/stats --token "eyJhbGci..."
-qprobe http GET /api/data -H "X-API-Key: abc123"
-
-# Assert status (exit 1 if different)
-qprobe http GET /api/health --status 200
-qprobe http DELETE /api/users/1 --status 204
-
-# Filter response
-qprobe http GET /api/users --jq ".[0].name"
-qprobe http GET /api/stats --jq ".revenue.total"
-
-# Verbose (show headers)
-qprobe http POST /api/login -d '{"email":"a@b.com","pass":"123"}' -v
-
-# Raw output (for piping)
-qprobe http GET /api/users --raw | jq '.[].email'
-```
-
-## Flags
-
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--data <json>` | `-d` | JSON request body |
-| `--header <k:v>` | `-H` | Header (repeatable) |
-| `--token <jwt>` | | Bearer auth shortcut |
-| `--status <code>` | | Assert expected status |
-| `--jq <expr>` | | JQ filter on response |
-| `--raw` | | No formatting (for pipes) |
-| `--verbose` | `-v` | Full request/response headers |
-| `--base <url>` | | Override baseUrl |
-
-## Tips
-
-- **Use `qprobe http` instead of browser** for API testing — much cheaper on tokens
-- **`--status` for assertions** — `qprobe http GET /api/health --status 200`
-- **`--jq` for extraction** — `qprobe http GET /api/me --jq ".user.role"`
-- **Chain with login** — extract token, use in subsequent requests

package/skills/qprobe-process/SKILL.md

@@ -1,58 +0,0 @@
----
-name: qprobe-process
-description: "QUESTPIE Probe process management. Start dev servers with ready-pattern detection, stop, restart, health checks, list running processes. Use when: starting a dev server, checking if server is running, waiting for service to be ready, restarting after code change. Triggers: 'start the server', 'bun dev', 'is it running', 'restart', 'health check', 'wait for ready', 'server crashed'. Use even when user just says 'run it' or 'start it up' in context of a dev project."
----
-
-# qprobe — Process Management
-
-Start dev servers with ready-pattern detection, health checks, and lifecycle management.
-
-**Install:** `npm install -g @questpie/probe`
-
-## Commands
-
-```bash
-# Start with ready detection
-qprobe start <n> "<cmd>" --ready "<pattern>" [--port <n>] [--timeout 60s]
-
-# Examples
-qprobe start server "bun dev" --ready "ready on" --port 3000
-qprobe start db "docker compose up postgres" --ready "ready to accept"
-
-# Lifecycle
-qprobe stop <n|--all>
-qprobe restart <n>
-qprobe ps                    # list running processes
-qprobe ps --json             # machine-readable
-
-# Health check — poll URL until 200
-qprobe health http://localhost:3000/api/health --timeout 30s
-
-# Read logs
-qprobe logs <n>              # last 50 lines
-qprobe logs <n> --follow     # tail -f
-qprobe logs <n> --grep "ERROR"
-qprobe logs --all            # all processes merged
-```
-
-## How It Works
-
-- Spawns child process as daemon (survives between CLI calls)
-- Pipes stdout/stderr to `tmp/qprobe/logs/<n>.log` (timestamped)
-- Monitors output for `--ready` pattern, returns when matched
-- PID saved to `tmp/qprobe/pids/<n>.pid`
-- `qprobe stop` sends SIGTERM → SIGKILL after 5s
-
-## Common Patterns
-
-```bash
-# Start, wait, test
-qprobe start server "bun dev" --ready "ready on" --port 3000
-qprobe health http://localhost:3000/api/health
-qprobe http GET /api/users
-
-# Check what crashed
-qprobe ps
-qprobe logs server --lines 100 --grep "ERROR"
-qprobe restart server
-```

package/skills/qprobe-recording/SKILL.md

@@ -1,63 +0,0 @@
----
-name: qprobe-recording
-description: "QUESTPIE Probe test recording and replay. Record browser interactions, auto-generate Playwright tests, replay without AI tokens for regression testing. Use when: recording a test flow, creating regression tests, replaying tests, running test suite, checking for regressions after code changes. Triggers: 'record a test', 'save this as a test', 'replay tests', 'run regression', 'check if it still works', 'run all tests'. Use whenever user wants to capture a flow for future verification."
----
-
-# qprobe — Recording & Replay
-
-Record browser flows → generate Playwright tests → replay with zero AI tokens.
-
-**Install:** `npm install -g @questpie/probe`
-
-## Record
-
-```bash
-qprobe record start "login-flow"
-# ... do browser actions (they're automatically captured) ...
-qprobe browser open /login
-qprobe browser fill @e1 "admin@test.com"
-qprobe browser fill @e2 "password123"
-qprobe browser click @e3
-qprobe browser wait --url "/dashboard"
-qprobe assert text "Dashboard"
-qprobe record stop
-# ✅ Recording saved: tests/qprobe/recordings/login-flow.json
-# ✅ Playwright test: tests/qprobe/recordings/login-flow.spec.ts
-```
-
-## Replay (Zero AI Tokens)
-
-```bash
-qprobe replay "login-flow"              # run one test
-qprobe replay --all                     # run all recordings
-qprobe replay --all --headed            # visible browser
-qprobe replay --all --browser firefox   # cross-browser
-qprobe replay --all --report            # HTML report
-qprobe replay --all --retries 2         # retry flaky tests
-qprobe replay --all --base https://staging.myapp.com  # against staging
-```
-
-## Manage Recordings
-
-```bash
-qprobe recordings list                  # list all
-qprobe recordings show "login-flow"     # show steps
-qprobe recordings delete "old-test"     # delete
-qprobe recordings export "login-flow"   # standalone Playwright project
-```
-
-## How It Works
-
-1. `record start` activates capture mode
-2. Every `qprobe browser` command is recorded with both `@e` ref AND CSS selector
-3. `record stop` saves JSON recording + generates `.spec.ts` Playwright test
-4. `replay` runs the Playwright test directly — no AI, no LLM, no tokens
-5. Tests are committed to repo in `tests/qprobe/recordings/`
-
-## Tips
-
-- **Record early** — capture login, CRUD, critical paths as you build them
-- **Replay after every change** — `qprobe replay --all` catches regressions instantly
-- **Replay is free** — pure Playwright, runs in <5s per test
-- **Edit `.spec.ts`** to add custom assertions beyond what was recorded
-- **Export for CI** — `qprobe recordings export` creates standalone test project