codeceptjs 4.0.4 → 4.0.6

package/docs/agents.md

@@ -23,6 +23,38 @@ Agents get full control over test and browser execution:
 
 CodeceptJS is token-efficient: it stores HTML, ARIA, logs, and HTTP request data as files instead of streaming them through MCP. Agents read these files with their native shell tools—no extra API calls, no redundant context.
 
+## Essential Setup
+
+Two things make agent testing work: the **skills** that teach the agent CodeceptJS, and the **MCP server** that lets it drive the browser. Set both up once, from your project directory.
+
+Install the skills:
+
+```bash
+npx skills add codeceptjs/skills
+```
+
+Connect the MCP server (`npx codeceptjs-mcp`).
+
+**Claude Code:**
+
+```bash
+claude mcp add codeceptjs -- npx codeceptjs-mcp
+```
+
+**Codex:**
+
+```bash
+codex mcp add codeceptjs -- npx codeceptjs-mcp
+```
+
+**Cursor** — add to `.cursor/mcp.json`:
+
+```json
+{ "mcpServers": { "codeceptjs": { "command": "npx", "args": ["codeceptjs-mcp"] } } }
+```
+
+See [/mcp](/mcp) for full client setup. Now the agent is ready to run the loop.
+
 ## The loop
 
 Whether the agent is writing a new test or fixing an old one, it follows the same cycle.
@@ -96,31 +128,6 @@ Only `url` is inline. The rest are paths the agent opens with the right tool:
 
 Saved HTML is formatted, with non-semantic elements stripped out: `<style>`, `<script>`, Tailwind-style trash classes, and inline `style=""` attributes. `grep` can then effectively find the correct tree branch in raw page source. ARIA snapshots are smaller and more structured than HTML, which is why the agent prefers them when picking locators.
 
-## Setup
-
-When CodeceptJS is installed, the MCP server can be launched with this command:
-
-```bash
-npx codeceptjs-mcp
-```
-
-> See [/mcp](/mcp) for detailed client setup.
-
-We recommend pairing CodeceptJS MCP with the skills bundle.
-
-Install for any agent:
-
-```bash
-npx skills add codeceptjs/skills
-```
-
-Or, in Claude Code:
-
-```text
-/plugin marketplace add codeceptjs/skills
-/plugin install codeceptjs@codeceptjs-skills
-```
-
 ## Usage Examples
 
 When MCP and skills are connected, the agent receives predefined workflows and can act effectively for testing purposes. Common scenarios it handles:

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/pause.js

@@ -105,7 +105,7 @@ async function parseInput(cmd) {
   recorder.session.start('pause')
   if (cmd === '') next = true
   if (!cmd || cmd === 'resume' || cmd === 'exit') {
-    finish()
+    if (typeof finish === 'function') finish()
     recorder.session.restore('pause')
     rl.close()
     history.save()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.0.4",
+  "version": "4.0.6",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
@@ -95,7 +95,7 @@
     "@codeceptjs/helper": "2.0.4",
     "@cucumber/cucumber-expressions": "18",
     "@cucumber/gherkin": "38.0.0",
-    "@cucumber/messages": "32.0.1",
+    "@cucumber/messages": "32.3.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@xmldom/xmldom": "0.9.8",
     "acorn": "8.15.0",
@@ -105,7 +105,7 @@
     "chalk": "4.1.2",
     "cheerio": "^1.0.0",
     "chokidar": "^5.0.0",
-    "commander": "14.0.3",
+    "commander": "15.0.0",
     "cross-spawn": "7.0.6",
     "css-to-xpath": "0.1.0",
     "csstoxpath": "1.6.0",
@@ -183,15 +183,15 @@
     "rosie": "2.1.1",
     "runok": "^0.9.3",
     "semver": "7.7.3",
-    "sinon": "21.0.1",
+    "sinon": "22.0.0",
     "sinon-chai": "^4.0.1",
-    "ts-morph": "27.0.2",
+    "ts-morph": "28.0.0",
     "ts-node": "10.9.2",
     "tsd": "^0.33.0",
     "tsd-jsdoc": "2.5.0",
     "tsx": "^4.19.2",
     "typedoc": "0.28.16",
-    "typedoc-plugin-markdown": "4.9.0",
+    "typedoc-plugin-markdown": "4.12.0",
     "typescript": "5.9.3",
     "wdio-docker-service": "3.2.1",
     "webdriverio": "9.23.0",