chore: migrate to utoo CI (#5830)

## Summary

Migrate the main CI workflow from pnpm to [utoo
(`ut`)](https://github.com/utooland/utoo). The E2E workflow keeps pnpm
for now — it requires `catalog:` / `workspace:` protocol resolution and
`publishConfig` overrides during pack which `ut pm-pack` does not yet
provide.

## Install speedup

The direct win of this migration: **`ut install --from pnpm` is 2.2–3.6×
faster than `pnpm install`** across all test matrix platforms.

| Platform | pnpm install | ut install | Speedup |
|---|---|---|---|
| ubuntu-22 | 16.8s | **5.2s** | 3.2× |
| ubuntu-24 | 17.7s | **4.9s** | 3.6× |
| macos-22 | 26.3s | **9.5s** | 2.8× |
| macos-24 | 30.1s | **9.1s** | 3.3× |
| windows-22 | 31.1s | **12.0s** | 2.6× |
| windows-24 | 28.4s | **12.7s** | 2.2× |

Every test matrix job re-installs from scratch, so this 15–20s savings
per job compounds into the per-job reductions below.

## Overall CI wall-clock

On a clean run (no reruns), the full workflow shaves **~1 minute off
wall-clock** (25m34s → 24m32s, ~4% faster). The critical path is still
bounded by Windows Test (~20–24m), so faster jobs elsewhere can't
meaningfully shrink wall-clock. Flaky reruns on the critical path can
degrade practical times further.

The win of this PR is **per-job speedup** (especially macOS, where Test
jobs drop 6–8 minutes each) and **developer-machine ergonomics** (`ut
install` on your laptop is also 3× faster).

## CI changes

- `.github/workflows/ci.yml`: replace `pnpm/action-setup` + `pnpm
install` with `utooland/setup-utoo` + `ut install --from pnpm`
- `package.json`: convert pnpm-specific scripts to ut equivalents (`ut
run --workspaces`, `ut run --workspace <name>`)
- `site:build` / `site:dev` use `cd site && npm run build/dev` so
Cloudflare Pages works (its env has neither pnpm nor utoo)
- `.gitignore`: add `.utoo.toml` and `.claude/`
- `.oxfmtrc.json`: ignore root `package.json` (ut rewrites it with
npm-style `workspaces` field)

## egg-bin fixes

### CJS resolution (`baseCommand.ts`)

`ts-node`, `tsconfig-paths` are CJS packages without `exports`. On
flat-hoisted layouts (npm/utoo), `importResolve` (which uses
`import.meta.resolve`) fails because the ESM resolver doesn't
auto-append `.js` for bare subpaths. Fix: use `createRequire` for these
CJS packages.

### Self-test fixture opt-out (`test.ts` + `coffee.ts`)

Under flat-hoisting, egg-bin's own test fixtures reach `@eggjs/mock` and
`@eggjs/tegg-vitest` via monorepo root hoist even though the fixture
projects don't use them. This caused every test fork to load both
frameworks unnecessarily (~90s for mock, ~7s/fork for tegg runner → ~70s
for the test-bin suite).

Solution: the test harness (`coffee.ts`) sets
`EGG_BIN_SELF_TEST_FIXTURE=1` when spawning egg-bin against its own
fixtures. `test.ts` checks this env var and skips both mock and
tegg-runner auto-detection.

For real projects, behaviour is unchanged: both frameworks are
resolve-then-use. The tegg runner also falls back to egg-bin's own
dirname for E2E scenarios (cnpmcore uses tegg transitively via egg
without declaring it directly).

## Build perf: publint pack

`publint` runs `pnpm pack` by default against each of ~80 packages. On
main CI (utoo env, no pnpm binary) this fails. On E2E (pnpm env,
symlinked node_modules) npm pack is ~10× slower per package —
`create-egg` alone took 85s vs 1s under pnpm.

Fix: `tsdown.config.ts` reads `PUBLINT_PACK` env var, defaulting to
`npm` (works in main CI). E2E workflow sets `PUBLINT_PACK=pnpm` so it
stays fast there.

## Dependency fixes

| Change | Why |
|---|---|
| `oxlint-tsgolint: ^0.15.0` → `^0.18.1` | Peer requirement of oxlint
1.60.0 |
| Add `@types/content-type`, `@types/koa-compose` to root devDeps |
oxlint type-check needs these at workspace root, not just hoisted from
sub-packages |

## Other source adaptations

| File | What |
|---|---|
| `packages/cluster/test/options.test.ts` | Accept flat-hoisted
`node_modules/egg` path |
| `packages/tsconfig/test/index.test.ts` | Use `require.resolve` instead
of hardcoded path |
| `tegg/plugin/controller`, `tegg/plugin/mcp-proxy` | Remove
`@ts-expect-error` for types discoverable under flat hoisting |

## Per-job timing (clean run, no reruns)

| Job | next | chore-ut-ci | Delta |
|---|---|---|---|
| typecheck | 2m7s | **1m39s** | -28s |
| Test (ubuntu, 22) | 14m52s | 15m20s | +28s |
| Test (ubuntu, 24) | 13m38s | **13m28s** | -10s |
| Test (macos, 22) | 21m5s | **14m40s** | **-6m25s** |
| Test (macos, 24) | 18m54s | **10m38s** | **-8m16s** |
| Test (windows, 22) | 25m24s | **24m23s** | -1m1s |
| Test (windows, 24) | 23m7s | **20m59s** | -2m8s |
| Test bin (ubuntu) | 2m19s | **2m2s** | -17s |
| Test bin (windows) | 3m51s | **2m56s** | -55s |
| Test scripts (ubuntu, 22) | 1m41s | **1m13s** | -28s |
| Test scripts (ubuntu, 24) | 1m36s | **1m16s** | -20s |
| cnpmcore E2E | 6m0s | **5m58s** | -2s |
| examples E2E | 2m35s | **2m25s** | -10s |

Almost every job is faster; the small Test (ubuntu 22) +28s regression
is within run-to-run variance.

## Test plan

- [x] typecheck
- [x] Test matrix (ubuntu/macos/windows × Node 22/24)
- [x] Test bin, Test scripts
- [x] E2E (cnpmcore + examples)
- [x] Cloudflare Pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Chores**
* Migrated build and dependency management tooling from pnpm to utoo
across the monorepo.
* Updated CI workflows, workspace configurations, and npm scripts to
support the new tooling.
  * Added build configuration for egg-bin TypeScript compilation.
* Enhanced test infrastructure for environment isolation and
compatibility.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

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

Author: elrrrrrrr

.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 ./tools/egg-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 -- --workspace ./tools/scripts
+          ut run ci --workspace tools/scripts
 
       - name: Code Coverage
         if: ${{ matrix.os != 'windows-latest' }}

.github/workflows/e2e-test.yml

@@ -153,6 +153,11 @@ jobs:
         run: pnpm install --no-frozen-lockfile
 
       - name: Build all packages
+        env:
+          # publint pack defaults to npm (main CI env has no pnpm); in E2E we
+          # already have pnpm installed and npm pack against pnpm's symlinked
+          # node_modules is ~10x slower, so prefer pnpm pack here
+          PUBLINT_PACK: pnpm
         run: pnpm build
 
       - name: Pack packages into tgz

.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": [

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 --if-present",
     "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 --if-present",
     "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": "cd site && npm run dev",
+    "site:build": "cd site && npm run build",
     "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-*' --if-present",
     "prepare": "husky",
     "version:patch": "node scripts/version.js patch",
     "version:minor": "node scripts/version.js minor",
@@ -71,6 +70,7 @@
     "typescript": "catalog:",
     "unplugin-unused": "catalog:",
     "urllib": "catalog:",
+    "utoo": "catalog:",
     "vitest": "catalog:"
   },
   "lint-staged": {

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/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;
         },
       );

pnpm-workspace.yaml

@@ -213,6 +213,7 @@ catalog:
   urijs: ^1.19.11
   urllib: ^4.8.2
   utility: ^2.5.0
+  utoo: ^1
   vary: ^1.1.2
   vitepress: 2.0.0-alpha.15
   vitepress-plugin-llms: ^1.10.0
@@ -227,6 +228,9 @@ catalogs:
   path-to-regexp1:
     path-to-regexp: ^1.9.0
 
+onlyBuiltDependencies:
+  - utoo
+
 minimumReleaseAge: 1440
 
 minimumReleaseAgeExclude:

tools/egg-bin/package.json

@@ -51,8 +51,8 @@
     }
   },
   "scripts": {
+    "build": "tsdown -c tsdown.config.ts",
     "typecheck": "tsgo --noEmit",
-    "pretest": "tsdown",
     "test": "vitest run",
     "cov": "vitest run --coverage",
     "ci": "npm run cov"