feat(setCommonPlugins): register browser + aiTrace as discoverable

Add `browser` and `aiTrace` to the common plugins block — registered
without `enabled: true`, so they appear in `cfg.plugins` (discoverable
by `-p all` and tooling) and can be activated ad-hoc via `-p browser:...`
or by toggling `enabled: true` in user config. Drop the legacy
`tryTo`/`retryTo` plugin entries — those are now imported from
`codeceptjs/effects` in 4.x, not enabled as plugins.

Bumps version label to 4.0.0-beta.3.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: DavertMik

CHANGELOG.md

@@ -1,3 +1,7 @@
+4.0.0-beta.3
+
+* `setCommonPlugins` now registers `browser` and `aiTrace` as discoverable plugins (not enabled by default — activate via `-p <name>` on the CLI or `enabled: true` in user config). `tryTo`/`retryTo` are no longer added; in 4.x they are imported from `codeceptjs/effects`.
+
 4.0.0
 
 * ESM-only release targeting CodeceptJS 4.x. Convert package + all hooks + bridge to native ESM (`type: module`).

README.md

@@ -75,12 +75,19 @@ setCommonPlugins();
 
 These plugins will be loaded:
 
-* tryTo (enabled globally)
-* retryFailedStep (enabled globally)
-* retryTo (enabled globally)
-* eachElement (enabled globally)
-* pauseOnFail (disabled, should be turned on when needed)
-* screenshotOnFail (enable globally)
+**Enabled globally**
+
+* `retryFailedStep`
+* `eachElement`
+* `screenshotOnFail`
+
+**Registered but not enabled** — activate ad-hoc via `-p <name>` on the CLI, or by setting `enabled: true` in user config:
+
+* `pauseOnFail` — pause when a step fails (`-p pauseOnFail`)
+* `browser` — override browser helper config from CLI (`-p browser:show`, `-p browser:browser=firefox`, etc.)
+* `aiTrace` — capture AI traces
+
+Note: in CodeceptJS 4.x, `tryTo` and `retryTo` are no longer plugins — import them from `codeceptjs/effects`.
 
 ### setSharedCookies
 

hooks/setCommonPlugins.js

@@ -4,9 +4,15 @@ export default function () {
   config.addHook(cfg => {
     if (!cfg.plugins) cfg.plugins = {}
 
+    // Enabled globally
     cfg.plugins.retryFailedStep = cfg.plugins.retryFailedStep || { enabled: true }
     cfg.plugins.eachElement = cfg.plugins.eachElement || { enabled: true }
-    cfg.plugins.pauseOnFail = cfg.plugins.pauseOnFail || {}
     cfg.plugins.screenshotOnFail = cfg.plugins.screenshotOnFail || {}
+
+    // Registered but not enabled — activate via `-p <name>` on the CLI or by
+    // setting `enabled: true` in user config.
+    cfg.plugins.pauseOnFail = cfg.plugins.pauseOnFail || {}
+    cfg.plugins.browser = cfg.plugins.browser || {}
+    cfg.plugins.aiTrace = cfg.plugins.aiTrace || {}
   })
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeceptjs/configure",
-  "version": "4.0.0",
+  "version": "4.0.0-beta.3",
   "description": "Set of CodeceptJS config hooks to simplify configuration (ESM, CodeceptJS 4.x)",
   "type": "module",
   "main": "index.js",

test/index.test.js

@@ -260,8 +260,17 @@ describe('Hooks tests', () => {
       const config = { helpers: {} }
       setCommonPlugins()
       Config.create(config)
+      // enabled globally
       assert.ok(Config.get().plugins.screenshotOnFail)
       assert.ok(Config.get().plugins.eachElement)
+      assert.equal(Config.get().plugins.eachElement.enabled, true)
+      assert.equal(Config.get().plugins.retryFailedStep.enabled, true)
+      // registered but not enabled
+      assert.ok(Config.get().plugins.pauseOnFail)
+      assert.ok(Config.get().plugins.browser)
+      assert.equal(Config.get().plugins.browser.enabled, undefined)
+      assert.ok(Config.get().plugins.aiTrace)
+      assert.equal(Config.get().plugins.aiTrace.enabled, undefined)
     })
 
     test('should not override plugins', () => {