feat: merge core/utils repository into monorepo (#5440)

- Add packages/core directory with complete @eggjs/core codebase
- Merge @eggjs/core v6.5.0 from master branch
- Update core package.json for monorepo integration:
  * Change repository URLs to monorepo structure
  * Convert npm scripts to pnpm commands
  * Update Node.js engine requirement to >= 20.19.0
  * Convert all dependencies to use pnpm catalog references
- Add core-specific dependencies to pnpm workspace catalog:
  * @eggjs/router, get-ready, globby, tsconfig-paths
  * husky, lint-staged, node-homedir, ready-callback
  * await-event, gals, js-yaml, ts-node, tshy/tshy-after
- Update CLAUDE.md with packages/core documentation
- Maintain full compatibility with existing @eggjs/core functionality

This brings the core plugin framework directly into the monorepo for
better integration and unified development workflow.

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

---------

Co-authored-by: Claude <[email protected]>

Author: fengmk2

.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: [ master, next ]
+  pull_request:
+    branches: [ master, next ]
+  merge_group:
+
+jobs:
+  egg:
+    name: egg
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, macos-latest, windows-latest'
+      version: '20, 22, 24'
+      test: 'pnpm run ci:app'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  egg-cluster1:
+    name: egg-cluster1
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, windows-latest'
+      version: '20'
+      test: 'pnpm run ci:cluster1'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  egg-cluster2:
+    name: egg-cluster2
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, windows-latest'
+      version: '22'
+      test: 'pnpm run ci:cluster2'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  egg-lib-core:
+    name: egg-lib-core
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, windows-latest'
+      version: '20, 22'
+      test: 'pnpm run ci:lib/core'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  egg-lib-plugins:
+    name: egg-lib-plugins
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, windows-latest'
+      version: '20, 22'
+      test: 'pnpm run ci:lib/plugins'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  core:
+    name: "@eggjs/core"
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, macos-latest, windows-latest'
+      version: '20, 22, 24'
+      test: 'pnpm run ci:core'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  utils:
+    name: "@eggjs/utils"
+    uses: node-modules/github-actions/.github/workflows/node-test.yml@master
+    with:
+      os: 'ubuntu-latest, macos-latest, windows-latest'
+      version: '20, 22, 24'
+      test: 'pnpm run ci:utils'
+      install: 'corepack enable pnpm && pnpm install'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/nodejs-cluster1.yml

@@ -14,6 +14,12 @@ This is the **Eggjs** framework - a progressive Node.js framework for building e
 - **`packages/egg/`** - Main Eggjs framework package
   - `src/` - TypeScript source code
   - `test/` - Comprehensive test suite with fixtures
+- **`packages/core/`** - Core plugin framework (merged from @eggjs/core)
+  - `src/` - Core TypeScript source code
+  - `test/` - Core framework test suite with vitest
+- **`packages/utils/`** - Utility functions (merged from @eggjs/utils)
+  - `src/` - Utils TypeScript source code
+  - `test/` - Utils test suite
 - **`examples/`** - Example applications
   - `helloworld-commonjs/` - CommonJS example
   - `helloworld-typescript/` - TypeScript example
@@ -146,11 +152,12 @@ The framework extends Koa's context with Egg-specific features:
 - Follow existing test patterns for consistency
 
 ### TypeScript Support
-- Main framework in `packages/egg/` is written in TypeScript with strict mode
+- Both `packages/egg/` and `packages/core/` written in TypeScript with strict mode
 - Uses tsdown for unbundled ESM builds (faster development, preserves file structure)
-- Configured with `tsdown.config.ts` for optimal build settings
+- Each package configured with `tsdown.config.ts` for optimal build settings
 - Type definitions are exported for framework users
 - Examples support both .js and .ts application files
+- Cross-package TypeScript references configured for proper module resolution
 
 ### Documentation
 - Main docs are in the `site/` directory using Dumi

.github/workflows/nodejs-cluster2.yml

@@ -12,16 +12,20 @@
     "oxlint": "catalog:",
     "oxlint-tsgolint": "catalog:",
     "prettier": "catalog:",
-    "tsdown": "catalog:"
+    "vitest": "catalog:",
+    "@vitest/ui": "catalog:",
+    "@vitest/coverage-v8": "catalog:"
   },
   "scripts": {
     "clean": "pnpm -r run clean",
     "build": "pnpm -r run build",
     "lint": "oxlint --type-aware",
-    "pretest": "pnpm lint",
-    "test": "pnpm -r run test",
+    "test": "vitest run",
     "test:changed": "pnpm -r run test:changed",
+    "cov": "vitest run --coverage",
     "ci": "pnpm -r run ci",
+    "ci:core": "pnpm --filter=core run ci",
+    "ci:utils": "pnpm run cov packages/utils",
     "ci:app": "pnpm --filter=egg run ci:app",
     "ci:cluster1": "pnpm --filter=egg run ci:cluster1",
     "ci:cluster2": "pnpm --filter=egg run ci:cluster2",

.github/workflows/nodejs-lib-core.yml

@@ -0,0 +1,17 @@
+/node_modules
+coverage
+.logs
+npm-debug.log
+.vscode
+.DS_Store
+yarn.lock
+test/fixtures/egg/node_modules/egg-core
+.idea
+.nyc_output
+package-lock.json
+run
+test/fixtures/*/timing.json
+lib/
+.tshy*
+dist
+.package-lock.json

.github/workflows/nodejs-lib-plugins.yml

@@ -0,0 +1,3 @@
+CHANGELOG.md
+__snapshots__
+benchmark