codeceptjs 4.0.5 → 4.0.7

package/docs/migration-4.md

@@ -7,9 +7,31 @@ title: Migrating from 3.x to 4.x
 
 CodeceptJS 4.x is a major release. It moves the codebase from CommonJS to native ESM, drops several long-deprecated helpers and plugins, replaces legacy plugins with first-class APIs, and bumps most third-party dependencies.
 
-> Migrate automatically! Install CodeceptJS skills `npx skills add codeceptjs/skills` and run `/codeceptjs-3-to-4-migration` in your coding agent
+## Migrate Automatically with an Agent
 
-This guide tells you exactly what to change in your project to upgrade.
+The fastest way to upgrade is to let an AI agent do it. This release is mechanical enough that an agent handles most of it end-to-end.
+
+Install CodeceptJS 4:
+
+```bash
+npm install codeceptjs@4
+```
+
+Then install the skills bundle. It works the same in Claude Code or any other agent:
+
+```bash
+npx skills add codeceptjs/skills
+```
+
+The bundle ships a `migrate-codeceptjs-4` skill. Point an agent at the project and run it:
+
+```bash
+claude "/migrate-codeceptjs-4"
+```
+
+It reads your config and tests, applies the mechanical changes, runs the suite, and fixes what breaks.
+
+The rest of this guide documents every change the skill makes — read it if you prefer to migrate by hand, or to review what the agent did.
 
 ## 1. Update Node and Package
 

package/lib/command/init.js

@@ -206,7 +206,7 @@ export default async function (initPath, options = {}) {
     const stepFile = `./steps_file.${extension}`
     fs.writeFileSync(path.join(testsPath, stepFile), extension === 'ts' ? defaultActorTs : defaultActor)
 
-    config.include = { I: isTypeScript ? './steps_file' : stepFile }
+    config.include = { I: isTypeScript ? './steps_file.ts' : stepFile }
 
     print(`Steps file created at ${stepFile}`)
 
@@ -317,6 +317,8 @@ export default async function (initPath, options = {}) {
       return
     }
 
+    if (process.env.CODECEPT_TEST) return
+
     const generatedTest = generateTest(testsPath)
     if (!generatedTest) return
     generatedTest.then(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
@@ -137,11 +137,9 @@
     "xpath": "0.0.34",
     "zod": "^4.1.11"
   },
-  "optionalDependencies": {
-    "@codeceptjs/detox-helper": "1.1.14"
-  },
   "devDependencies": {
     "@apollo/server": "^5",
+    "@codeceptjs/detox-helper": "1.1.14",
     "@codeceptjs/expect-helper": "^4.0.0-beta.5",
     "@codeceptjs/mock-request": "0.3.1",
     "@eslint/eslintrc": "3.3.3",