merge: resolve conflict with next branch

Use --legacy-peer-deps from next branch for cnpmcore E2E install.

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

Author: elrrrrrrr

.github/workflows/e2e-test.yml

@@ -47,7 +47,7 @@ jobs:
           - name: cnpmcore
             node-version: 24
             command: |
-              npm install --force
+              npm install --legacy-peer-deps
               npm run typecheck
               npm run build
               npm run prepublishOnly

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/monorepo",
-  "version": "4.1.2-beta.7",
+  "version": "4.1.2-beta.9",
   "private": true,
   "description": "Eggjs framework monorepo",
   "license": "MIT",

packages/cluster/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/cluster",
-  "version": "4.0.2-beta.7",
+  "version": "4.0.2-beta.9",
   "description": "cluster manager for egg",
   "keywords": [
     "cluster",

packages/cluster/src/master.ts

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import module from 'node:module';
 import net from 'node:net';
 import os from 'node:os';
 import path from 'node:path';
@@ -57,6 +58,20 @@ export class Master extends ReadyEventEmitter {
 
   async #start(options?: ClusterOptions) {
     this.options = await parseOptions(options);
+
+    // Enable compile cache — env vars propagate to forked workers automatically.
+    // Duplicated from ManifestStore.enableCompileCache (@eggjs/core is not a dependency).
+    if (!process.env.NODE_COMPILE_CACHE && !process.env.NODE_DISABLE_COMPILE_CACHE) {
+      const cacheDir = path.join(this.options.baseDir, '.egg', 'compile-cache');
+      process.env.NODE_COMPILE_CACHE = cacheDir;
+      process.env.NODE_COMPILE_CACHE_PORTABLE = '1';
+      try {
+        module.enableCompileCache?.(cacheDir);
+      } catch {
+        /* non-fatal */
+      }
+    }
+
     this.workerManager = new WorkerManager();
     this.messenger = new Messenger(this, this.workerManager);
     this.isProduction = isProduction(this.options);

packages/cookies/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/cookies",
-  "version": "4.0.2-beta.7",
+  "version": "4.0.2-beta.9",
   "description": "cookies module for egg",
   "homepage": "https://github.com/eggjs/egg/tree/next/packages/cookies",
   "license": "MIT",

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/core",
-  "version": "7.0.2-beta.7",
+  "version": "7.0.2-beta.9",
   "description": "A core plugin framework based on @eggjs/koa",
   "keywords": [
     "egg",

packages/core/src/egg.ts

@@ -33,6 +33,14 @@ export interface EggCoreOptions {
   env?: string;
   /** Skip lifecycle hooks, only trigger loadMetadata for manifest generation */
   metadataOnly?: boolean;
+  /**
+   * When true, lifecycle stops after the `configWillLoad` phase.
+   * `configDidLoad`, `didLoad`, `willReady`, `didReady`, and `serverDidReady`
+   * are skipped. Used for V8 startup snapshot construction — SDKs typically
+   * execute during `configDidLoad`, opening connections and starting timers
+   * which are not serializable. Analogous to `metadataOnly` mode.
+   */
+  snapshot?: boolean;
 }
 
 export type EggCoreInitOptions = Partial<EggCoreOptions>;
@@ -191,6 +199,7 @@ export class EggCore extends KoaApplication {
       baseDir: options.baseDir,
       app: this,
       logger: this.console,
+      snapshot: options.snapshot,
     });
     this.lifecycle.on('error', (err) => this.emit('error', err));
     this.lifecycle.on('ready_timeout', (id) => this.emit('ready_timeout', id));

packages/core/src/lifecycle.ts

@@ -69,6 +69,15 @@ export interface LifecycleOptions {
   baseDir: string;
   app: EggCore;
   logger: EggConsoleLogger;
+  /**
+   * When true, the lifecycle stops after configWillLoad phase completes.
+   * configDidLoad, didLoad, willReady, didReady, and serverDidReady hooks
+   * are NOT called. Used for V8 startup snapshot construction — SDKs
+   * typically execute during configDidLoad, opening connections and starting
+   * timers which are not serializable. The handling is analogous to
+   * metadataOnly mode: both short-circuit the lifecycle chain early.
+   */
+  snapshot?: boolean;
 }
 
 export type FunWithFullPath = Fun & { fullPath?: string };
@@ -119,7 +128,7 @@ export class Lifecycle extends EventEmitter {
     });
 
     this.ready((err) => {
-      if (!this.#metadataOnly) {
+      if (!this.#metadataOnly && !this.options.snapshot) {
         void this.triggerDidReady(err);
       }
       debug('app ready');
@@ -251,6 +260,14 @@ export class Lifecycle extends EventEmitter {
       }
     }
     debug('trigger configWillLoad end');
+    if (this.options.snapshot) {
+      // Snapshot mode: stop AFTER configWillLoad, BEFORE configDidLoad.
+      // SDKs typically execute during configDidLoad hooks — these open connections
+      // and start timers which are not serializable in V8 startup snapshots.
+      debug('snapshot mode: stopping after configWillLoad, skipping configDidLoad and later phases');
+      this.ready(true);
+      return;
+    }
     this.triggerConfigDidLoad();
   }
 

packages/core/src/loader/manifest.ts

@@ -1,6 +1,7 @@
 import { createHash } from 'node:crypto';
 import fs from 'node:fs';
 import fsp from 'node:fs/promises';
+import module from 'node:module';
 import path from 'node:path';
 import { debuglog } from 'node:util';
 
@@ -240,6 +241,48 @@ export class ManifestStore {
     } catch (err: any) {
       if (err.code !== 'ENOENT') throw err;
     }
+    ManifestStore.cleanCompileCache(baseDir);
+  }
+
+  // --- Compile Cache ---
+
+  /**
+   * Enable Node.js module compile cache for the current process.
+   * Sets NODE_COMPILE_CACHE and NODE_COMPILE_CACHE_PORTABLE env vars
+   * so forked child processes also inherit compile cache.
+   */
+  static enableCompileCache(baseDir: string): void {
+    if (process.env.NODE_COMPILE_CACHE || process.env.NODE_DISABLE_COMPILE_CACHE) return;
+    const cacheDir = path.join(baseDir, '.egg', 'compile-cache');
+    process.env.NODE_COMPILE_CACHE = cacheDir;
+    process.env.NODE_COMPILE_CACHE_PORTABLE = '1';
+    try {
+      const result = module.enableCompileCache?.(cacheDir);
+      debug('compile cache enabled: %o', result);
+    } catch (err) {
+      debug('compile cache enable failed: %o', err);
+    }
+  }
+
+  /**
+   * Flush accumulated compile cache entries to disk.
+   */
+  static flushCompileCache(): void {
+    try {
+      module.flushCompileCache?.();
+      debug('compile cache flushed');
+    } catch (err) {
+      debug('compile cache flush failed: %o', err);
+    }
+  }
+
+  /**
+   * Remove the compile cache directory.
+   */
+  static cleanCompileCache(baseDir: string): void {
+    const compileCacheDir = path.join(baseDir, '.egg', 'compile-cache');
+    fs.rmSync(compileCacheDir, { recursive: true, force: true });
+    debug('compile cache removed: %s', compileCacheDir);
   }
 
   // --- Path Utilities ---

packages/core/test/fixtures/compile-cache-target/index.cjs

@@ -0,0 +1 @@
+module.exports = { compiled: true };