chore: migrate to utoo CI

.github/workflows/ci.yml

@@ -1,3 +1,4 @@
+# CI workflow for egg monorepo
 name: CI
 
 on:
@@ -27,31 +28,31 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4
+      - name: Setup utoo
+        uses: utooland/setup-utoo@3a51006d0b66afcc32d1b9177a4b200b74f4a8cb # main
 
       - name: Set up Node.js
         uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6
         with:
           node-version: '24'
 
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: ut install --from pnpm
 
       - name: Run lint
-        run: pnpm run lint
+        run: ut run lint
 
       - name: Run typecheck
-        run: pnpm run typecheck
+        run: ut run typecheck
 
       - name: Run format check
-        run: pnpm run fmtcheck
+        run: ut run fmtcheck
 
       - name: Run build
-        run: pnpm run build
+        run: ut run build
 
       - name: Run site build
-        run: pnpm run site:build
+        run: ut run site:build
 
   test:
     strategy:
@@ -150,24 +151,24 @@ jobs:
           # & mysqladmin -u root password root
           & mysql -uroot -e "CREATE DATABASE IF NOT EXISTS test;"
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4
+      - name: Setup utoo
+        uses: utooland/setup-utoo@3a51006d0b66afcc32d1b9177a4b200b74f4a8cb # main
 
       - name: Set up Node.js
         uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6
         with:
           node-version: ${{ matrix.node }}
 
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: ut install --from pnpm
 
       - name: Run tests
-        run: pnpm run ci
+        run: ut run ci
 
       - name: Run example tests
         if: ${{ matrix.os != 'windows-latest' }}
         run: |
-          pnpm run example:test:all
+          ut run example:test:all
 
       - name: Code Coverage
         # skip on windows, it will hangup on codecov
@@ -194,21 +195,21 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4
+      - name: Setup utoo
+        uses: utooland/setup-utoo@3a51006d0b66afcc32d1b9177a4b200b74f4a8cb # main
 
       - name: Set up Node.js
         uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6
         with:
           node-version: ${{ matrix.node }}
 
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: ut install --from pnpm
 
       - name: Run tests
         run: |
-          pnpm build --workspace ./tools/egg-bin
-          pnpm run --filter ./tools/egg-bin ci
+          ut run build --workspace @eggjs/bin
+          ut run ci --workspace @eggjs/bin
 
       - name: Code Coverage
         # skip on windows, it will hangup on codecov https://github.com/codecov/codecov-action/issues/1787
@@ -235,21 +236,21 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4
+      - name: Setup utoo
+        uses: utooland/setup-utoo@3a51006d0b66afcc32d1b9177a4b200b74f4a8cb # main
 
       - name: Set up Node.js
         uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6
         with:
           node-version: ${{ matrix.node }}
 
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: ut install --from pnpm
 
       - name: Run tests
         run: |
-          pnpm build
-          pnpm run --filter=./tools/scripts ci
+          ut run build
+          ut run ci --workspace tools/scripts
 
       - name: Code Coverage
         if: ${{ matrix.os != 'windows-latest' }}

.gitignore

@@ -118,3 +118,5 @@ tegg/plugin/tegg/test/fixtures/apps/**/*.js
 ecosystem-ci/cnpmcore
 ecosystem-ci/examples
 pnpm-lock.yaml
+.utoo.toml
+.claude/

.oxfmtrc.json

@@ -8,7 +8,8 @@
     "packages/core/test/fixtures/load_dirs/syntax_error/*",
     "packages/core/test/fixtures/syntaxerror/*",
     "packages/core/test/fixtures/load_context_syntax_error/**/*",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "/package.json"
   ],
   "experimentalSortImports": {
     "groups": [

ecosystem-ci/repo.json

@@ -2,7 +2,7 @@
   "cnpmcore": {
     "repository": "https://github.com/cnpm/cnpmcore.git",
     "branch": "master",
-    "hash": "e82df3f4093c0ec9fd5354563605e60f7f613035"
+    "hash": "98463c33188bbd32513a74e6c3a2c4cc559ef5da"
   },
   "examples": {
     "repository": "https://github.com/eggjs/examples.git",

package.json

@@ -13,26 +13,25 @@
   ],
   "type": "module",
   "scripts": {
-    "clean-dist": "pnpm -r --parallel exec rimraf dist",
-    "clean": "pnpm -r --parallel run clean && pnpm clean-dist",
+    "clean-dist": "ut run clean --workspaces",
     "build": "tsdown",
-    "prelint": "pnpm clean-dist",
+    "prelint": "ut run clean-dist",
     "lint": "oxlint --type-aware --type-check --quiet",
     "fmt": "oxfmt",
-    "typecheck": "pnpm clean && pnpm -r run typecheck",
+    "typecheck": "ut run clean-dist && ut run typecheck --workspaces",
     "fmtcheck": "oxfmt --check .",
-    "pretest": "pnpm run clean && pnpm -r run pretest",
+    "pretest": "ut run clean-dist && ut run pretest --workspaces --if-present",
     "test": "vitest run --bail 1 --retry 2 --testTimeout 20000 --hookTimeout 20000",
-    "test:cov": "pnpm run test --coverage",
-    "preci": "pnpm -r --parallel run pretest",
-    "ci": "pnpm run test --coverage",
-    "site:dev": "pnpm --filter=site run dev",
-    "site:build": "pnpm --filter=site run build",
+    "test:cov": "ut run test -- --coverage",
+    "preci": "ut run pretest --workspaces --if-present",
+    "ci": "ut run test -- --coverage",
+    "site:dev": "ut run dev --workspace site",
+    "site:build": "ut run build --workspace site",
     "puml": "puml . --dest ./site",
-    "example:dev:commonjs": "pnpm --filter=helloworld-commonjs run dev",
-    "example:dev:typescript": "pnpm --filter=helloworld-typescript run dev",
-    "example:dev:tegg": "pnpm --filter=helloworld-tegg run dev",
-    "example:test:all": "pnpm --filter=helloworld-* run test",
+    "example:dev:commonjs": "ut run dev --workspace helloworld-commonjs",
+    "example:dev:typescript": "ut run dev --workspace helloworld-typescript",
+    "example:dev:tegg": "ut run dev --workspace helloworld-tegg",
+    "example:test:all": "ut run test --workspace helloworld-typescript && ut run test --workspace helloworld-tegg",
     "prepare": "husky",
     "version:patch": "node scripts/version.js patch",
     "version:minor": "node scripts/version.js minor",

packages/cluster/test/options.test.ts

@@ -239,10 +239,12 @@ describe('test/options.test.ts', () => {
         baseDir,
       });
       const expectPaths = [
-        // run int workspace root
+        // run in workspace root
         path.join(__dirname, '../../egg'),
-        // run in project root
+        // run in project root (pnpm nested)
         path.join(__dirname, '../node_modules/egg'),
+        // run with flat/hoisted node_modules (e.g. ut install)
+        path.join(__dirname, '../../../node_modules/egg'),
       ];
       assert(
         expectPaths.includes(options.framework),

packages/tsconfig/test/index.test.ts

@@ -1,11 +1,14 @@
 import fs from 'node:fs/promises';
+import { createRequire } from 'node:module';
 import path from 'node:path';
 
 import coffee from 'coffee';
 import { test, expect } from 'vitest';
 
+const require = createRequire(import.meta.url);
+
 test('should tsc build work', async () => {
-  const tsc = path.join(import.meta.dirname, '..', 'node_modules', 'typescript', 'bin', 'tsc');
+  const tsc = require.resolve('typescript/bin/tsc');
   const fixturePath = path.join(import.meta.dirname, 'fixtures/apps/ts-proj');
   const tsconfigPath = path.join(fixturePath, 'tsconfig.json');
   console.log('%s -p %s, cwd: %s', tsc, tsconfigPath, fixturePath);

packages/utils/src/import.ts

@@ -350,8 +350,47 @@ export function importResolve(filepath: string, options?: ImportResolveOptions):
       try {
         moduleFilePath = import.meta.resolve(filepath);
       } catch (err) {
+        // === Fallback 1: require.resolve for legacy CJS subpaths ===
+        //
+        // When `import.meta.resolve(filepath)` throws ERR_MODULE_NOT_FOUND,
+        // fall back to `require.resolve(filepath, { paths })` so callers
+        // can still resolve "legacy" CJS subpaths.
+        //
+        // This is reached for two combined reasons:
+        //
+        //   1. Node.js 22+ ESM resolver is strict about packages **without**
+        //      an `exports` field: subpaths must include an explicit file
+        //      extension (e.g. `tsconfig-paths/register.js`). Bare subpaths
+        //      like `tsconfig-paths/register` cause the resolver to throw,
+        //      because ESM does not auto-append `.js`/`.json`/`.node` the
+        //      way the CJS resolver does.
+        //
+        //   2. The manual node_modules walk above (`tryToResolve...`)
+        //      only checks `${p}/node_modules/<filepath>` plus two pnpm
+        //      sibling levels — it does **not** walk up the directory
+        //      tree the way Node's CJS resolver does. So a dependency
+        //      hoisted to a workspace-root `node_modules/` (typical for
+        //      pnpm/yarn workspaces) is not found by the manual walk and
+        //      falls through to `import.meta.resolve`.
+        //
+        // `require.resolve(..., { paths })` handles both: it auto-appends
+        // extensions AND walks up the directory tree from each `paths`
+        // entry until it finds the package. Removing this fallback would
+        // be a breaking change for `@eggjs/utils` consumers (both internal
+        // — e.g. `tools/egg-bin/src/baseCommand.ts` resolving
+        // `tsconfig-paths/register` — and any downstream npm package that
+        // imports `importResolve`).
+        //
+        // If `require.resolve` also fails, throw the original ESM error
+        // so the user sees the ESM resolver's diagnostic, not the CJS one.
         debug('[importResolve:error] import.meta.resolve %o => %o, options: %o', filepath, err, options);
-        throw new ImportResolveError(filepath, paths, err as Error);
+        try {
+          moduleFilePath = getRequire().resolve(filepath, { paths });
+          debug('[importResolve:requireResolveFallback] %o => %o', filepath, moduleFilePath);
+          return moduleFilePath;
+        } catch {
+          throw new ImportResolveError(filepath, paths, err as Error);
+        }
       }
       if (moduleFilePath.startsWith('file://')) {
         // resolve will return file:// URL on Linux and MacOS expect on Windows

packages/utils/test/import.test.ts

@@ -107,8 +107,8 @@ describe('test/import.test.ts', () => {
           assert.equal(err.name, 'ImportResolveError');
           assert.equal(err.filepath, 'tsconfig-paths-demo-not-exists/register');
           assert.deepEqual(err.paths, [getFilepath('cjs/node_modules/inject')]);
-          assert.match(err.stack ?? '', /Cannot find package/);
-          assert.match(err.message, /Cannot find package/);
+          assert.match(err.stack ?? '', /Cannot find (package|module)/);
+          assert.match(err.message, /Cannot find (package|module)/);
           return true;
         },
       );

tegg/plugin/controller/src/lib/impl/mcp/MCPControllerRegister.ts

@@ -23,7 +23,6 @@ import { isInitializeRequest, isJSONRPCRequest } from '@modelcontextprotocol/sdk
 import type { JSONRPCMessage, MessageExtraInfo } from '@modelcontextprotocol/sdk/types.js';
 // @ts-expect-error await-event is not typed
 import awaitEvent from 'await-event';
-// @ts-expect-error content-type is not typed
 import contentType from 'content-type';
 import type { Application, Context, Router } from 'egg';
 import compose from 'koa-compose';

tegg/plugin/mcp-proxy/src/index.ts

@@ -13,12 +13,10 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import awaitEvent from 'await-event';
 // @ts-expect-error cluster-client is not typed
 import { APIClientBase } from 'cluster-client';
-// @ts-expect-error content-type is not typed
 import contentType from 'content-type';
 import type { Application, Context } from 'egg';
 import type { EggLogger } from 'egg';
 import { EventSourceParserStream } from 'eventsource-parser/stream';
-// @ts-expect-error koa-compose is not typed
 import compose from 'koa-compose';
 import getRawBody from 'raw-body';
 

tools/scripts/package.json

@@ -50,8 +50,8 @@
   "scripts": {
     "typecheck": "tsgo --noEmit",
     "test": "vitest run --bail 1 --no-file-parallelism",
-    "cov": "pnpm test --coverage",
-    "ci": "pnpm run cov"
+    "cov": "ut run test -- --coverage",
+    "ci": "ut run cov"
   },
   "dependencies": {
     "@eggjs/utils": "workspace:*",

tsdown.config.ts

@@ -22,6 +22,7 @@ export default defineConfig({
   publint: {
     level: 'suggestion',
     strict: true,
+    pack: 'npm',
   },
 
   // Default entry pattern - glob to include all source files