meocord 4.2.1 → 4.2.3

package/dist/cli.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "meocordVersion": "4.2.1",
+  "meocordVersion": "4.2.3",
   "name": "meocord",
   "description": "CLI for managing the MeoCord application",
   "usage": "[options] [command]",

package/dist/esm/bin/app-template/package.json.template

@@ -18,26 +18,26 @@
   },
   "dependencies": {
     "discord.js": "^14.27.0",
-    "dotenv": "^18.0.5",
+    "dotenv": "^18.0.7",
     "meocord": "^{{version}}"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^26.6.3",
-    "@typescript-eslint/parser": "^8.71.0",
-    "@vitest/coverage-istanbul": "^5.0.3",
-    "eslint": "^10.11.0",
+    "@types/node": "^26.6.5",
+    "@typescript-eslint/parser": "^8.71.2",
+    "@vitest/coverage-istanbul": "^5.0.4",
+    "eslint": "^10.12.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import-x": "^4.17.1",
-    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-prettier": "^5.5.7",
     "eslint-plugin-unused-imports": "^4.4.1",
     "globals": "^17.13.0",
-    "prettier": "^3.9.9",
+    "prettier": "^3.9.10",
     "reflect-metadata": "^0.2.2",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.71.0",
+    "typescript-eslint": "^8.71.2",
     "unplugin-swc": "^2.0.0",
-    "vitest": "^5.0.3"
+    "vitest": "^5.0.4"
   }
 }

package/dist/esm/bin/app-template/src/main.ts.template

@@ -11,8 +11,9 @@ async function bootstrap() {
   logger.log('Application started')
 }
 
-// An error MeoCord explained, such as an app it refuses or a token Discord refused, is already logged
+// An error MeoCord explained, such as an app it refuses or a token Discord refused, is already logged, with the exit code set
 bootstrap().catch(error => {
-  if (!isExplainedError(error)) logger.error('Error during startup:', error)
+  if (isExplainedError(error)) return
+  logger.error('Error during startup:', error)
   process.exitCode = 1
 })

package/dist/esm/bin/generator.js

@@ -4,20 +4,22 @@ import { Argument } from 'commander';
 import { ControllerType } from '../enum/controller.enum.js';
 import { ControllerGeneratorHelper } from './helper/controller-generator.helper.js';
 import { Logger } from '../common/logger.js';
-import '../core/theme-scope.js';
-import '../core/theme-validation.js';
+import '../common/theme.js';
 import '../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../common/deprecation.js';
 import '../common/response/response-state.js';
+import '../core/theme-scope.js';
 import '../common/errors.js';
+import '../common/cooldown-store.js';
 import 'node:crypto';
 import '../decorator/controller.decorator.js';
 import '../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../util/refusal.util.js';
 import '../common/translator.js';
 import '../common/meocord-text.js';
+import '../core/theme-resolvers.js';
 import { ServiceGeneratorHelper } from './helper/service-generator.helper.js';
 import { GuardGeneratorHelper } from './helper/guard-generator.helper.js';
 import { InterceptorGeneratorHelper } from './helper/interceptor-generator.helper.js';

package/dist/esm/bin/helper/filter-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class FilterGeneratorHelper {

package/dist/esm/bin/helper/guard-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class GuardGeneratorHelper {

package/dist/esm/bin/helper/interceptor-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class InterceptorGeneratorHelper {

package/dist/esm/bin/helper/observer-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class ObserverGeneratorHelper {

package/dist/esm/bin/helper/pipe-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class PipeGeneratorHelper {

package/dist/esm/bin/helper/service-generator.helper.js

@@ -1,19 +1,21 @@
 import path from 'path';
 import { Logger } from '../../common/logger.js';
-import '../../core/theme-scope.js';
-import '../../core/theme-validation.js';
+import '../../common/theme.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../../common/deprecation.js';
 import '../../common/response/response-state.js';
+import '../../core/theme-scope.js';
 import '../../common/errors.js';
+import '../../common/cooldown-store.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
-import 'node:fs';
-import 'node:url';
+import '../../util/refusal.util.js';
 import '../../common/translator.js';
 import '../../common/meocord-text.js';
+import '../../core/theme-resolvers.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class ServiceGeneratorHelper {

package/dist/esm/bin/meocord.js

@@ -3,25 +3,29 @@ import path from 'path';
 import { createRsbuild } from '@rsbuild/core';
 import { createHash } from 'node:crypto';
 import { Logger } from '../common/logger.js';
-import '../core/theme-scope.js';
-import '../core/theme-validation.js';
+import '../common/theme.js';
 import '../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
+import '../common/deprecation.js';
 import '../common/response/response-state.js';
+import '../core/theme-scope.js';
 import '../common/errors.js';
+import '../common/cooldown-store.js';
 import '../decorator/controller.decorator.js';
 import '../core/scalar-types.js';
-import * as fs from 'node:fs';
-import 'node:url';
+import '../util/refusal.util.js';
 import '../common/translator.js';
 import '../common/meocord-text.js';
+import '../core/theme-resolvers.js';
 import { spawn } from 'node:child_process';
+import { constants } from 'node:os';
 import { capitalize } from 'lodash-es';
 import wait from '../util/wait.util.js';
 import { GeneratorCLI } from './generator.js';
 import { runtimePrefixFor, AppGeneratorHelper } from './helper/app-generator.helper.js';
 import { makeInitialCommit } from './helper/initial-commit.helper.js';
+import * as fs from 'node:fs';
 import { setEnvironment, compileAndValidateConfig, validateRunConfig, validateDiscordToken, checkSourceConfig, reportConfigProblem } from '../util/common.util.js';
 import { Command } from 'commander';
 import { execSync } from 'child_process';
@@ -37,11 +41,11 @@ import { isDevRunnerMessage, DEV_RUNNER_ENV } from '../util/dev-runner.util.js';
 import packageJson from '../package.json.js';
 import { fileURLToPath } from 'url';
 import { assertNoWebpackHook, createRsbuildConfig, optionalExternalConflicts, optionalExternalNames } from '../build/rsbuild-config.js';
-import { createNativeExternals, packageNameOfRequest, installedPackages, copyPackagesInto, bundledModuleFiles, assertNoBundledNativeAddons, findBundledNativeAddons } from '../build/native-addons.js';
+import { createNativeExternals, packageNameOfRequest, installedPackages, copyPackagesInto, bundledModuleFiles, assertNoBundledNativeAddons, findBundledNativeAddons, otherCopiesWarning } from '../build/native-addons.js';
 import { writePlatformManifest, PLATFORM_MANIFEST } from '../util/platform.util.js';
 import { loadMeoCordSourceConfig } from '../util/meocord-source-config.util.js';
 import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
-import { FORCE_REGISTER_ENV, REGISTER_ONLY_ENV, REGISTER_GUILD_ENV } from '../util/registration-mode.util.js';
+import { FORCE_REGISTER_ENV, REGISTER_ONLY_ENV, REGISTER_GUILD_ENV, REGISTER_MODE_ENV } from '../util/registration-mode.util.js';
 
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);
@@ -116,18 +120,22 @@ const UNDECOMPOSED = {
  */ function appDirectoryName(appName) {
     return appName.normalize('NFKD').replace(/\p{M}+/gu, '').replace(/[ßẞæÆœŒøØłŁđĐþÞ]/g, (letter)=>UNDECOMPOSED[letter]).replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
 }
+/** How long watch mode waits after the last save to a file it reloads from before reloading. */ const RELOAD_DEBOUNCE_MS = 300;
+/** The name watch mode taps the compiler's hooks under. */ const WATCH_HOOK_NAME = 'MeoCordWatch';
+/** What a shell adds to a signal's number for the exit code of a process that signal ended. */ const SIGNAL_EXIT_BASE = 128;
 /** A Command Line Interface (CLI) for managing the MeoCord application. */ class MeoCordCLI {
     /**
    * Configures and runs the MeoCord CLI.
    */ async run() {
-        this.program().showHelpAfterError().parse(process.argv);
+        this.program().parse(process.argv);
     }
     /**
    * The CLI's commands, options and arguments, configured but not parsed: what `run` parses, and what the build
    * describes in `dist/cli.json`, so the two cannot differ.
    */ program() {
         let program = new Command();
-        program.name(this.appName.toLowerCase()).description(`CLI for managing the ${this.appName} application`).version(this.version);
+        // Before any command is added: commander copies it to each command as the command is made
+        program.name(this.appName.toLowerCase()).description(`CLI for managing the ${this.appName} application`).version(this.version).showHelpAfterError();
         program.command('show').description('Display information').option('-w, --warranty', 'Display warranty disclaimer').option('-c, --license', 'Display license').action((options)=>{
             if (!options.warranty && !options.license) {
                 const show = `${program.name()} show`;
@@ -438,6 +446,9 @@ copies or substantial portions of the Software.
                 // A safety net behind the externals function: a native addon that still reached the
                 // bundle would run on this machine -- through its node_modules -- and fail in production.
                 assertNoBundledNativeAddons(findBundledNativeAddons(bundledFiles, this.projectRoot));
+                for (const [name, others] of natives.otherCopies){
+                    this.logger.warn(otherCopiesWarning(name, natives.found.get(name).dir, others, this.projectRoot));
+                }
                 this.packDependencies(meocordConfig, natives.found);
             } else if (!meocordConfig?.bundleDependencies) {
                 this.removePackedOutputs();
@@ -563,7 +574,7 @@ copies or substantial portions of the Software.
         this.appEnv[REGISTER_ONLY_ENV] = '1';
         this.appEnv[FORCE_REGISTER_ENV] = '1';
         if (guild) this.appEnv[REGISTER_GUILD_ENV] = guild;
-        const child = this.spawnApp().on('exit', (code)=>process.exit(code ?? 1));
+        const child = this.spawnApp().on('exit', (code, signal)=>process.exit(this.exitCodeOf(code, signal, 1)));
         this.relayStopSignals(()=>child);
     }
     /**
@@ -581,6 +592,7 @@ copies or substantial portions of the Software.
                 const kind = request();
                 if (kind === 'duplicate') return;
                 if (kind === 'first') stopping?.();
+                this.stopRelayed = true;
                 const child = app();
                 if (!stillRunning(child)) {
                     if (kind === 'repeat') process.exit(1);
@@ -598,6 +610,15 @@ copies or substantial portions of the Software.
         }
     }
     /**
+   * The code the CLI exits with once the application has: its own, or for one a signal ended that the CLI didn't pass
+   * on, 128 plus the signal's number, as a shell gives, so a bot killed from outside doesn't read as a clean exit.
+   * @param fallback - For an application that a stop the CLI passed on ended without a code.
+   */ exitCodeOf(code, signal, fallback) {
+        if (code !== null) return code;
+        const number = signal ? constants.signals[signal] : undefined;
+        return number !== undefined && !this.stopRelayed ? SIGNAL_EXIT_BASE + number : fallback;
+    }
+    /**
    * Replaces the running application once it has exited, since two would contend for one gateway session. Builds that
    * finish meanwhile start nothing more: the replacement runs `dist/main.js` as it stands at launch, the latest build.
    * @param build - The digest of the build asking for it; the output the running bot was launched from leaves it running.
@@ -672,7 +693,7 @@ copies or substantial portions of the Software.
         const { command, args } = buildAppCommand(this.runtime, this.mainJSPath, {
             sourceMaps
         });
-        return spawn(command, args, {
+        const child = spawn(command, args, {
             cwd: this.projectRoot,
             env: {
                 ...this.inheritedEnv,
@@ -680,6 +701,8 @@ copies or substantial portions of the Software.
                 ...process.env.NODE_ENV !== undefined && {
                     NODE_ENV: process.env.NODE_ENV
                 },
+                // And where it registers, which a bundle can't read from NODE_ENV: bundleDependencies writes in the build's mode
+                [REGISTER_MODE_ENV]: process.env.NODE_ENV === 'development' ? 'development' : 'production',
                 ...this.appEnv,
                 ...devRunner && {
                     [DEV_RUNNER_ENV]: '1'
@@ -692,6 +715,16 @@ copies or substantial portions of the Software.
                 'ipc'
             ] : 'inherit'
         });
+        // A runtime that can't be started, such as a path that isn't there, is reported as an event, past any caller's try.
+        // So is a signal or a message the running application couldn't be sent; its exit, when it comes, still decides the code
+        child.on('error', (error)=>{
+            if (child.pid !== undefined) {
+                return this.logger.error(`Could not signal or message the running application (process ${child.pid}): ${error.message}`);
+            }
+            this.logger.error(`Failed to start: ${command} could not be run: ${error.message}`);
+            process.exit(1);
+        });
+        return child;
     }
     /**
    * Starts the MeoCord application in development mode with live updates.
@@ -702,28 +735,41 @@ copies or substantial portions of the Software.
             await this.compileConfig({
                 mode: 'development'
             });
-            let isRunning = false;
             let watching;
+            // Settles once the running build has emitted, whatever its errors; a reload waits for it before replacing the build
+            let built = Promise.resolve();
             // The new bundler is made, its plugins set up and its config resolved, before the running build is closed: a
             // config whose rsbuild hook or plugin throws leaves that build watching the sources, and the bot it started running
             const watch = async ()=>{
-                const { rsbuild, meocordConfig } = await this.createBundler('development');
+                const { rsbuild } = await this.createBundler('development');
                 await rsbuild.initConfigs({
                     action: 'build'
                 });
                 // Runs after every rebuild, which is where the application is restarted. A rebuild that fails reports its own
                 // errors, emits nothing, and leaves the running bot alone rather than replacing it with a broken build.
+                let emitted;
+                const firstBuild = new Promise((resolve)=>emitted = resolve);
                 rsbuild.onAfterBuild(({ stats })=>{
-                    isRunning = true;
+                    emitted();
                     if (stats?.hasErrors()) return;
-                    if (!meocordConfig?.bundleDependencies) this.removePackedOutputs();
+                    // A watch build packs nothing, so a previous build's packed copies would shadow the project's packages
+                    this.removePackedOutputs();
                     this.latestBuild = stats ? emittedDigest(stats) : undefined;
                     this.restartApp(this.latestBuild);
                 });
+                // A compile that fails outright never reaches onAfterBuild, so it settles the wait too: a later save still reloads
+                rsbuild.onAfterCreateCompiler(({ compiler })=>{
+                    for (const each of 'compilers' in compiler ? compiler.compilers : [
+                        compiler
+                    ]){
+                        each.hooks.failed.tap(WATCH_HOOK_NAME, ()=>emitted());
+                    }
+                });
                 await watching?.close();
                 watching = await rsbuild.build({
                     watch: true
                 });
+                built = firstBuild;
             };
             await watch();
             // Inputs the bundler does not see: the config, and tsconfig.json, which the build reads through a copy MeoCord
@@ -743,42 +789,53 @@ copies or substantial portions of the Software.
                 ].some((file)=>!restarts.includes(file));
             let debounceWatcher;
             let changed = new Set();
+            // One reload at a time, each taking every file changed since the last began
+            const reload = async ()=>{
+                const files = changed;
+                changed = new Set();
+                if (this.stopping || files.size === 0) return;
+                for (const file of files)this.logger.log(reloads[file]);
+                if (!rebuilds(files)) return this.restartApp();
+                // A config that is refused, as at startup, or doesn't compile, say mid-edit, leaves the running bot and its build
+                // as they are
+                if (files.has('meocord.config.ts')) {
+                    const checked = checkSourceConfig();
+                    if ('problem' in checked) {
+                        // One that doesn't load, say mid-edit, is reported as a failed compile is, and watching goes on
+                        if (checked.loadError !== undefined) return this.logger.error(`Failed to compile meocord.config.ts: ${checked.loadError}`);
+                        return reportConfigProblem(checked.problem);
+                    }
+                    if (!await this.compileConfig({
+                        mode: 'development',
+                        exitOnFailure: false
+                    })) return;
+                }
+                // The new build restarts the bot, whatever its output: the config it was launched with has changed
+                this.launchedFrom = undefined;
+                try {
+                    await watch();
+                } catch (error) {
+                    // As with a failed login: the bot keeps running, and saving the file again tries again
+                    this.logger.error(`Rebuilding failed: ${error instanceof Error ? error.message : String(error)}. The bot keeps running its last ` + 'build; save the file again to retry.');
+                }
+            };
+            let reloading = Promise.resolve();
+            // Whether a reload waits its turn: a later save joins it rather than queueing one of its own
+            let queued = false;
+            const queueReload = ()=>{
+                if (queued) return;
+                queued = true;
+                reloading = reloading.then(()=>built).then(()=>{
+                    queued = false;
+                    return reload();
+                }).catch((error)=>this.logger.error('Reloading failed:', error));
+            };
             // The folder rather than the files, so an editor that saves by replacing a file is still seen
             const fsWatcher = fs.watch(this.projectRoot, (_event, filename)=>{
                 if (!filename || !Object.hasOwn(reloads, filename)) return;
                 changed.add(filename);
                 clearTimeout(debounceWatcher);
-                debounceWatcher = setTimeout(async ()=>{
-                    if (!isRunning) return;
-                    const files = changed;
-                    changed = new Set();
-                    for (const file of files)this.logger.log(reloads[file]);
-                    if (!rebuilds(files)) return this.restartApp();
-                    // A config that is refused, as at startup, or doesn't compile, say mid-edit, leaves the running bot and its build
-                    // as they are
-                    if (files.has('meocord.config.ts')) {
-                        const checked = checkSourceConfig();
-                        if ('problem' in checked) {
-                            // One that doesn't load, say mid-edit, is reported as a failed compile is, and watching goes on
-                            if (checked.loadError !== undefined) return this.logger.error(`Failed to compile meocord.config.ts: ${checked.loadError}`);
-                            return reportConfigProblem(checked.problem);
-                        }
-                        if (!await this.compileConfig({
-                            mode: 'development',
-                            exitOnFailure: false
-                        })) return;
-                    }
-                    isRunning = false;
-                    // The new build restarts the bot, whatever its output: the config it was launched with has changed
-                    this.launchedFrom = undefined;
-                    try {
-                        await watch();
-                    } catch (error) {
-                        // As with a failed login: the bot keeps running, and saving the file again tries again
-                        isRunning = true;
-                        this.logger.error(`Rebuilding failed: ${error instanceof Error ? error.message : String(error)}. The bot keeps running its last ` + 'build; save the file again to retry.');
-                    }
-                }, 300);
+                debounceWatcher = setTimeout(queueReload, RELOAD_DEBOUNCE_MS);
             });
             const stopWatching = ()=>{
                 this.stopping = true;
@@ -818,8 +875,8 @@ copies or substantial portions of the Software.
             }
             this.logger.log('Starting...');
             const start = this.spawnApp();
-            start.on('exit', (code)=>{
-                process.exit(code ?? 0);
+            start.on('exit', (code, signal)=>{
+                process.exit(this.exitCodeOf(code, signal, 0));
             });
             this.relayStopSignals(()=>start);
         } catch (error) {
@@ -859,6 +916,7 @@ copies or substantial portions of the Software.
         /** Binary the application is spawned with: the runtime the user chose, as {@link resolveRuntime} finds it. */ this.runtime = resolveRuntime(process.env, process.execPath);
         /** What a bot this CLI starts inherits, taken before any config is loaded; see {@link inheritedEnvironment}. */ this.inheritedEnv = inheritedEnvironment(process.env, this.projectRoot);
         /** Environment added to the application's own when it is spawned. */ this.appEnv = {};
+        /** Whether the CLI has passed a stop signal on to the application, whose death by it is then the stop asked for. */ this.stopRelayed = false;
         /** The running application, while a watch session owns one, including while it exits to be replaced. */ this.appProcess = null;
         /** Whether the running application is exiting to be replaced; a build that finishes meanwhile joins that restart. */ this.restarting = false;
         /** Whether a watch session is stopping, when a rebuild must not start the application again. */ this.stopping = false;
@@ -895,4 +953,4 @@ if (isProcessEntry()) {
     });
 }
 
-export { MeoCordCLI, appDirectoryName, emittedDigest, stillRunning };
+export { MeoCordCLI, RELOAD_DEBOUNCE_MS, appDirectoryName, emittedDigest, stillRunning };