feat: reins do — delegate a browsing goal to Jev, with benchmark (3/3)

.changeset/reins-do.md

@@ -0,0 +1,6 @@
+---
+"@karnstack/reins": minor
+"@reins/extension": minor
+---
+
+`reins do '<goal>'` hands a small browser task to TypeSafe's Jev model: it reads the page, picks each click, field and dropdown in about 0.2 s, and types only the values the agent passed with `--fill`. It stops and prints the exact next command for risky clicks (buy, send, delete, ...), missing values, dialogs, leaving the site, or no progress. `--continue` resumes the run, and `--confirm '<label>'` pre-approves a click. Exit codes: 0 done, 2 stopped for input, 1 error. On the extension side: the `jev_observe` / `jev_act` handlers (site tier `full`), per-tab JS dialog tracking, and a pre-action re-check of each chosen element. Jev can also submit a search field with Enter (`SUBMIT_SEARCH`, search-like fields only), a click that opens a new tab moves the run to that tab, three stale acts in a row stop the run as `stuck`, and the summary line reports the Jev input tokens used. A click on a link that opens a new tab (`target="_blank"`) — from `reins click` or `reins do` — no longer lets Chrome raise its window over the app you are working in: the extension opens the tab itself, next to the current one and active; `reins click` reports it as `ok — opened tab <id> (now active)` (`openedTabId` in `--json`).

.github/workflows/ci.yml

@@ -9,10 +9,17 @@ jobs:
     steps:
       - uses: actions/checkout@v7.0.0
       - uses: jdx/mise-action@v4.2.0
+      # The extension's real-browser suite (pointer/keys/dialogs, and the
+      # test that password and hidden values never reach a jev_observe
+      # result) is skipped without a Chrome binary; give the runner one.
+      - uses: browser-actions/setup-chrome@v2.2.0
+        id: chrome
       - run: pnpm install --frozen-lockfile
       - run: pnpm lint
       - run: pnpm typecheck
       - run: pnpm test
+        env:
+          REINS_TEST_CHROME: ${{ steps.chrome.outputs.chrome-path }}
       - run: pnpm build
       - run: pnpm zip
       - uses: actions/upload-artifact@v4

.gitignore

@@ -6,3 +6,9 @@ packages/cli/extension/
 coverage/
 *.log
 .DS_Store
+bench-out/
+
+# Planning notes (specs, plans, fix-loop ledgers) stay local; the code is the record.
+docs/superpowers/
+# bench-do.mjs summary output
+bench-do*.json

biome.json

@@ -2,7 +2,15 @@
   "$schema": "https://biomejs.dev/schemas/2.5.1/schema.json",
   "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
   "files": {
-    "includes": ["**", "!**/dist", "!**/.turbo", "!**/*.svg", "!.claude", "!**/routeTree.gen.ts"]
+    "includes": [
+      "**",
+      "!**/dist",
+      "!**/.turbo",
+      "!**/*.svg",
+      "!.claude",
+      "!**/routeTree.gen.ts",
+      "!packages/cli/scripts/bench/fixtures"
+    ]
   },
   "css": { "parser": { "tailwindDirectives": true } },
   "formatter": { "enabled": true, "indentStyle": "space", "indentWidth": 2, "lineWidth": 100 },