@verirun/cli 0.2.3 → 0.2.5

package/man/verirun.1

@@ -1,5 +1,5 @@
 .\" Manpage for verirun.
-.TH VERIRUN 1 "2026-09-20" "verirun 0.2.3" "User Commands"
+.TH VERIRUN 1 "2026-09-23" "verirun 0.2.5" "User Commands"
 .\" -------------------------------------------------------------------
 .SH NAME
 verirun \- record a browser workflow, replay it, and capture the backend logs it produced
@@ -31,6 +31,8 @@ verirun \- record a browser workflow, replay it, and capture the backend logs it
 .IR channel ]
 .RB [ \-\-cdp
 .IR url ]
+.RB [ \-\-dialog
+.IR answer ]
 .br
 .B verirun map
 .RB [ \-\-json ]
@@ -98,7 +100,12 @@ click, type, navigate \(em then
 to save the sequence to
 .IR .verirun/workflows/ name .json .
 Closing without doing anything saves nothing. A text field is only captured
-when it loses focus, so tab out of the last field before closing.
+when it loses focus, so tab out of the last field before closing. Answer any
+alert, confirm or prompt dialog as usual; afterwards
+.B record
+asks, for each step that opened one, whether you pressed OK or Cancel, and
+saves the answer on the step as
+.BR \(dqdialog\(dq .
 .TP
 .BI "run " name
 Replay a recorded workflow headless (in the browser kind it was recorded in),
@@ -130,6 +137,15 @@ writes it next to a coverage report, and
 .B \-\-bfs
 walks outward from one page. Import aliases are read from
 .IR tsconfig.json .
+An element whose handler calls the native
+.BR alert() ", " confirm() " or " prompt()
+carries a
+.B dialogs
+list in the graph, printed under its edge by
+.B \-\-bfs
+and listed in the coverage report;
+.B gates
+marks one whose answer changes what the click does.
 .TP
 .BR "log " [ \fIsource\fR ]
 With no source, print which log sources are configured. With
@@ -164,7 +180,14 @@ where the action needs one, and the required
 per action. It also warns when a
 .B navigate
 appears after the first step: walking the app by URL skips the UI, so a dead
-link or a button that stopped submitting still passes. Static only \(em it
+link or a button that stopped submitting still passes. When
+.I .verirun/map/interaction-tree.json
+exists (from
+.BR "map \-\-report" ),
+it also warns about a step that clicks an element known to open a browser
+dialog but has no
+.B dialog
+answer. Static only \(em it
 never opens a browser, so it cannot tell you a selector matches the live page. Use it after writing a workflow by hand or from
 .BR "verirun map" ,
 then run it for the real answer. Non-zero exit if anything is an error.
@@ -185,7 +208,9 @@ for a machine-readable form. Pipe it into your agent's context, e.g.
 .nf
 
 verirun agent > .verirun/AGENT.md
-verirun agent --skill --install   # Claude Code picks it up automatically
+verirun agent --skill --install          # Claude Code: .claude/skills/verirun/SKILL.md
+verirun agent --skill --install cursor   # Cursor: .cursor/rules/verirun.mdc
+verirun agent --skill --install all      # both
 
 .fi
 .RE
@@ -270,6 +295,19 @@ as
 .RB \(dq filter \(dq .
 For Supabase and Railway the filter is pushed to the query when it is a plain
 identifier; for Vercel it is applied after delivery.
+.TP
+.BI \-\-dialog " answer"
+How to answer a browser dialog (alert, confirm, prompt, beforeunload) opened by
+a step that has no saved
+.B dialog
+answer:
+.B accept
+(OK, the default) or
+.B dismiss
+(Cancel). A step's own answer always wins. Every dialog answered is listed in
+.I logs.json
+under
+.RB \(dq dialogs \(dq .
 .SS "log"
 .TP
 .B \-\-reconnect
@@ -507,6 +545,14 @@ Success.
 A replay step failed, a subscription check failed, or the command errored.
 .\" -------------------------------------------------------------------
 .SH NOTES
+A workflow step can carry
+.B \(dqdialog\(dq: { \(dqaction\(dq: \(dqaccept\(dq | \(dqdismiss\(dq, \(dqpromptText\(dq: \(dq...\(dq }
+to fix how replay answers a dialog that step opens.
+.B promptText
+is what an accepted
+.B prompt()
+receives; without it, the prompt's default value is submitted.
+.PP
 Native Windows (cmd, PowerShell) has no
 .BR man ;
 use

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verirun/cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "publishConfig": {
     "access": "public"
   },