refactor: start webServer as part of Codecept bootstrap/teardown

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: DavertMik

docs/configuration.md

@@ -123,7 +123,7 @@ webServer: [
 ],
 ```
 
-The server starts once in the main process for `run`, `run-workers`, `run-multiple` and `run-rerun`, before `bootstrapAll`/`bootstrap`, and stops after `teardownAll`/`teardown`. Workers and child processes reuse it. `dry-run`, `list`, `check`, `def` and `info` don't start it. CodeceptJS stops the command and every process it spawned, including when the run is interrupted with Ctrl+C.
+The server is started as part of bootstrap, right before the `bootstrap` hook (or `bootstrapAll` for `run-workers` and `run-multiple`), and stopped after `teardown` (`teardownAll`). It starts once in the main process; workers and child processes reuse it. The interactive `shell` starts it too, `dry-run` and `check` only with `--bootstrap`. CodeceptJS stops the command and every process it spawned, including when the run is interrupted with Ctrl+C.
 
 ## Dynamic configuration
 

docs/plugins/aiTrace.md

@@ -1,10 +1,3 @@
----
-permalink: /plugins/aiTrace
-editLink: false
-sidebar: auto
-title: aiTrace
----
-
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
 ## aiTrace
@@ -46,4 +39,4 @@ Possible config options:
 
 ### Parameters
 
-*   `config` **any**  
+*   `config` **any**  (optional, default `{}`)

lib/codecept.js

@@ -6,6 +6,7 @@ import { resolve } from 'path'
 import { fileURLToPath, pathToFileURL } from 'url'
 import { dirname } from 'path'
 import { createRequire } from 'module'
+import { isMainThread } from 'worker_threads'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
@@ -23,6 +24,7 @@ import loadTests from './mocha/loadTests.js'
 import { validateTypeScriptSetup, getTSNodeESMWarning } from './utils/loaderCheck.js'
 import recorder from './recorder.js'
 import store from './store.js'
+import WebServer from './webServer.js'
 
 import storeListener from './listener/store.js'
 import stepsListener from './listener/steps.js'
@@ -159,6 +161,7 @@ class Codecept {
    * @returns {Promise<void>}
    */
   async bootstrap() {
+    if (isMainThread && !this.opts?.child) await WebServer.startAll(this.config.webServer)
     return runHook(this.config.bootstrap, 'bootstrap')
   }
 
@@ -168,7 +171,11 @@ class Codecept {
    * @returns {Promise<void>}
    */
   async teardown() {
-    return runHook(this.config.teardown, 'teardown')
+    try {
+      return await runHook(this.config.teardown, 'teardown')
+    } finally {
+      await WebServer.stopAll()
+    }
   }
 
   /**

lib/command/run-rerun.js

@@ -1,7 +1,6 @@
 import { getConfig, getTestRoot, printError, createOutputDir } from './utils.js'
 import Config from '../config.js'
 import Codecept from '../rerun.js'
-import WebServer from '../webServer.js'
 
 export default async function (test, options) {
   // registering options globally to use in config
@@ -22,7 +21,7 @@ export default async function (test, options) {
 
   try {
     await codecept.init(testRoot)
-    await WebServer.startAll(config.webServer)
+
     await codecept.bootstrap()
     codecept.loadTests(test)
     await codecept.run()
@@ -31,6 +30,5 @@ export default async function (test, options) {
     process.exitCode = 1
   } finally {
     await codecept.teardown()
-    await WebServer.stopAll()
   }
 }

lib/command/run.js

@@ -2,7 +2,6 @@ import { getConfig, printError, getTestRoot, createOutputDir, autoExit } from '.
 import Config from '../config.js'
 import store from '../store.js'
 import Codecept from '../codecept.js'
-import WebServer from '../webServer.js'
 
 export default async function (test, options) {
   // registering options globally to use in config
@@ -28,7 +27,6 @@ export default async function (test, options) {
 
   try {
     await codecept.init(testRoot)
-    if (!options.child) await WebServer.startAll(config.webServer)
     await codecept.bootstrap()
     codecept.loadTests(test)
 
@@ -44,7 +42,6 @@ export default async function (test, options) {
     process.exitCode = 1
   } finally {
     await codecept.teardown()
-    await WebServer.stopAll()
     await autoExit()
   }
 }