# eggjs/egg — health index 95/100 (Exceptional)

> Inspection of the public repository eggjs/egg by inspect.software. It holds a health index of 95 out of 100, placing it in the Exceptional band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/eggjs/egg
- Report page: https://inspect.software/software/eggjs/egg
- Full JSON report: https://inspect.software/api/repositories/eggjs/egg/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/e/eggjs/egg.svg
- Inspected: 2026-09-15
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 82/100 | Excellent |
| Community & Adoption | 17% | 86/100 | Excellent |
| Sustainability & Governance | 23% | 80/100 | Excellent |
| Engineering Quality | 19% | 90/100 | Excellent |
| Security | 16% | 69/100 | Good |
| AI Readiness | 4% | 87/100 | Excellent |

The weighted overall 82 is calibrated to 95 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | 🥚🥚🥚🥚 Born to build better enterprise frameworks and apps with Node.js & Koa. https://307.run/eggcode |
| Classification | library, network-service |
| Homepage | https://eggjs.org |
| Primary language | TypeScript |
| License | MIT |
| Stars | 18,977 |
| Forks | 1,803 |
| Created | 2016-06-18 |
| Last push | 2026-08-23 |
| Latest release | v3.34.0 |
| Commits (last year) | 427 |
| Bus factor | 4 |
| Topics | egg, framework, koa, koa2, koa-middleware, nodejs, node-framework, enterprise, eggjs |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| npm | egg | 3.34.0 | 93,094 |
| npm | @eggjs/koa | 3.1.0-beta.2 | 2,620 |
| npm | @eggjs/i18n | 3.0.1 | 2,086 |
| npm | @eggjs/core | 6.6.0-beta.2 | 3,035 |
| npm | @eggjs/jsonp | 3.0.0 | 2,046 |
| npm | @eggjs/utils | 4.5.0-beta.2 | 42,488 |
| npm | @eggjs/errors | 3.0.0-beta.2 | 1,771 |
| npm | @eggjs/logger | 0.0.0 | 126 |

## Vitality — 82/100 (Excellent)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 84/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | partial | 28.8 / 36 | last push 23 days ago |
| Commit cadence | partial | 27.7 / 36 | 40/52 weeks with commits |
| Commit volume | met | 18 / 18 | 427 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 78/100 (Good)

Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | partial | 16.2 / 36 | latest release 240 days ago |
| Release cadence | met | 27 / 27 | a release every ~9.2 days |
| OpenSSF Scorecard: Signed-Releases | excluded | 0 / 10 | no releases found |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 38 days ago |

## Community & Adoption — 86/100 (Excellent)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | met | 60 / 60 | 18,977 stars |
| Forks | met | 25 / 25 | 1,803 forks |
| Watchers | partial | 14.8 / 15 | 459 watchers |

### Community health — 70/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (MIT) |
| CONTRIBUTING guide | met | 18 / 18 | — |
| Code of conduct | not met | 0 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | not met | 0 / 6.3 | — |

### Ecosystem adoption (downloads) — 86/100 (Excellent)

Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Monthly downloads | partial | 68.7 / 80 | 143,134 downloads/month across npm |
| Registry dependents | excluded | 0 / 20 | not reported by this ecosystem |

## Sustainability & Governance — 80/100 (Excellent)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 84/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 43.2 / 54 | 4 contributor(s) cover half of all commits |
| Commit distribution | partial | 17.4 / 22.5 | top contributor authored 22% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 97 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 73 contributing companies or organizations |

### Issue & PR responsiveness — 73/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 38.2 / 42 | 91% of issues closed |
| PR acceptance | partial | 25.7 / 30 | 1551/1814 decided PRs merged |
| Newcomer PR acceptance | not met | 0 / 13 | 0/2 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | partial | 9 / 15 | Found 18/30 approved changesets -- score normalized to 6 |

### Ownership & stewardship — 72/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 17 / 25 | 229 followers of eggjs |
| Track record | met | 25 / 25 | 186 public repos, account ~10 yr old |

### Package maintenance — 91/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 6 package(s) on npm |
| Publish recency | partial | 26 / 35 | latest publish 203 days ago |
| Version history | met | 20 / 20 | 276 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 90/100 (Excellent)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 84/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 4 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | met | 16 / 16 | .eslintrc |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | met | 20 / 20 | 25 out of 25 merged PRs checked by a CI test -- score normalized to 10 |

### Documentation — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://eggjs.org |
| Repository description | met | 10 / 10 | — |
| Topics | met | 10 / 10 | 9 topics |
| Wiki | met | 10 / 10 | — |

## Security — 69/100 (Good)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 74/100 (Good)

Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 3 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | met | 2.5 / 2.5 | 25 out of 25 merged PRs checked by a CI test -- score normalized to 10 |
| CII-Best-Practices | not met | 0 / 2.5 | no effort to earn an OpenSSF best practices badge detected |
| Code-Review | partial | 4.5 / 7.5 | Found 18/30 approved changesets -- score normalized to 6 |
| Contributors | met | 2.5 / 2.5 | project has 73 contributing companies or organizations |
| Dangerous-Workflow | met | 10 / 10 | no dangerous workflow patterns detected |
| Dependency-Update-Tool | met | 7.5 / 7.5 | update tool detected |
| Fuzzing | not met | 0 / 5 | project is not fuzzed |
| License | met | 2.5 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | excluded | 0 / 5 | packaging workflow not detected |
| Pinned-Dependencies | partial | 4.5 / 5 | dependency not pinned by hash detected -- score normalized to 9 |
| SAST | partial | 4 / 5 | SAST tool is not run on all commits -- score normalized to 8 |
| Security-Policy | met | 5 / 5 | security policy file detected |
| Signed-Releases | excluded | 0 / 7.5 | no releases found |
| Token-Permissions | not met | 0 / 7.5 | detected GitHub workflow tokens with excessive permissions |
| Vulnerabilities | met | 7.5 / 7.5 | 0 existing vulnerabilities detected |

### Dependency advisories — 49/100 (Weak)

Matched the npm:egg@3.34.0 runtime dependency closure — what installing the published package pulls in — 318 packages. Reachability is not analyzed.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Direct dependencies free of known advisories | partial | 11.8 / 35 | 2 affected: urllib 3.27.3 (high 7.5), urllib 4.9.0 (high 7.5) |
| Indirect dependencies free of known advisories | partial | 8.4 / 25 | 2 affected: undici 5.29.0 (high 7.5), uuid 8.3.2 (high 7.5) |
| No advisories left outstanding | partial | 29.1 / 40 | 2 advisory-carrying package(s) unaddressed past 90 days; oldest published 243 days ago |

### Malicious dependencies — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| No dependency reported as a malicious package | met | 100 / 100 | no dependency is reported as a malicious package |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 87/100 (Excellent)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | .github/copilot-instructions.md, AGENTS.md, CLAUDE.md, packages/skills/CLAUDE.md, tegg/CLAUDE.md |
| Machine-readable docs (llms.txt) | met | 15 / 15 | llms.txt served by the project website (https://eggjs.org/llms.txt) |
| Legible commit history | met | 40 / 40 | 100 of 100 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 91/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | met | 18 / 18 | packages/router/bench/Makefile |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | .eslintrc |
| Static type checking | met | 11 / 11 | examples/helloworld-service-worker/tsconfig.json, examples/helloworld-tegg/tsconfig.json, examples/helloworld-typescript/tsconfig.json, packages/cluster/tsconfig.json, packages/cookies/tsconfig.json, packages/core/test/fixtures/app-outdir-precedence/tsconfig.json, packages/core/test/fixtures/app-outdir-tsconfig/tsconfig.json, packages/core/test/fixtures/app-ts/tsconfig.json, packages/core/test/fixtures/egg-ts-js-tsconfig-paths/tsconfig.json, packages/core/test/fixtures/helloworld-ts/tsconfig.json, packages/core/tsconfig.json, packages/egg/test/fixtures/apps/app-ts-esm/tsconfig.json, packages/egg/test/fixtures/apps/app-ts-type-check/tsconfig.json, packages/egg/test/fixtures/apps/app-ts/tsconfig.json, packages/egg/tsconfig.json, packages/errors/tsconfig.json, packages/extend2/tsconfig.json, packages/koa-static-cache/tsconfig.json, packages/koa/tsconfig.json, packages/loader-fs/tsconfig.json, packages/logger/tsconfig.json, packages/path-matching/tsconfig.json, packages/router/tsconfig.json, packages/supertest/tsconfig.json, packages/tsconfig/test/fixtures/apps/ts-proj/tsconfig.json, packages/tsconfig/tsconfig.json, packages/typings/tsconfig.json, packages/utils/tsconfig.json, plugins/development/test/fixtures/development-ts/tsconfig.json, plugins/development/tsconfig.json, plugins/i18n/tsconfig.json, plugins/jsonp/tsconfig.json, plugins/logrotator/tsconfig.json, plugins/mock/test/fixtures/tegg-app-esm/tsconfig.json, plugins/mock/test/fixtures/tegg-app/tsconfig.json, plugins/mock/tsconfig.json, plugins/multipart/test/fixtures/apps/ts/tsconfig.json, plugins/multipart/tsconfig.json, plugins/onerror/tsconfig.json, plugins/redis/test/fixtures/apps/ts-multi/tsconfig.json, plugins/redis/test/fixtures/apps/ts/redisapp-ts/tsconfig.json, plugins/redis/tsconfig.json, plugins/schedule/tsconfig.json, plugins/security/tsconfig.json, plugins/session/tsconfig.json, plugins/static/tsconfig.json, plugins/tracer/tsconfig.json, plugins/typebox-validate/test/fixtures/apps/typebox-validate-test/tsconfig.json, plugins/typebox-validate/tsconfig.json, plugins/view-nunjucks/tsconfig.json, plugins/view/test/fixtures/apps/ts/tsconfig.json, plugins/view/tsconfig.json, plugins/watcher/tsconfig.json, site/tsconfig.json, tegg/benchmark/http/tsconfig.json, tegg/core/agent-runtime/tsconfig.json, tegg/core/ajv-decorator/tsconfig.json, tegg/core/aop-decorator/tsconfig.json, tegg/core/aop-runtime/tsconfig.json, tegg/core/background-task/tsconfig.json, tegg/core/common-util/tsconfig.json, tegg/core/controller-decorator/tsconfig.json, tegg/core/controller-runtime/tsconfig.json, tegg/core/core-decorator/tsconfig.json, tegg/core/dal-decorator/tsconfig.json, tegg/core/dal-runtime/tsconfig.json, tegg/core/dynamic-inject-runtime/tsconfig.json, tegg/core/dynamic-inject/test/fixtures/modules/wrong-enum-module/tsconfig.json, tegg/core/dynamic-inject/test/fixtures/modules/wrong-extends-module/tsconfig.json, tegg/core/dynamic-inject/tsconfig.json, tegg/core/eventbus-decorator/tsconfig.json, tegg/core/eventbus-runtime/tsconfig.json, tegg/core/langchain-decorator/tsconfig.json, tegg/core/lifecycle/tsconfig.json, tegg/core/loader/tsconfig.json, tegg/core/mcp-client/tsconfig.json, tegg/core/metadata/tsconfig.json, tegg/core/orm-decorator/tsconfig.json, tegg/core/runtime/tsconfig.json, tegg/core/schedule-decorator/tsconfig.json, tegg/core/standalone-decorator/tsconfig.json, tegg/core/tegg/tsconfig.json, tegg/core/test-util/tsconfig.json, tegg/core/transaction-decorator/tsconfig.json, tegg/core/types/tsconfig.json, tegg/core/vitest/tsconfig.json, tegg/plugin/ajv/tsconfig.json, tegg/plugin/aop/tsconfig.json, tegg/plugin/common/tsconfig.json, tegg/plugin/config/tsconfig.json, tegg/plugin/controller/tsconfig.json, tegg/plugin/dal/tsconfig.json, tegg/plugin/dns-cache/tsconfig.json, tegg/plugin/eventbus/tsconfig.json, tegg/plugin/langchain/test/fixtures/apps/langchain/tsconfig.json, tegg/plugin/langchain/tsconfig.json, tegg/plugin/mcp-client/tsconfig.json, tegg/plugin/mcp-proxy/tsconfig.json, tegg/plugin/orm/tsconfig.json, tegg/plugin/schedule/tsconfig.json, tegg/plugin/tegg/tsconfig.json, tegg/standalone/service-worker-controller/tsconfig.json, tegg/standalone/service-worker-runtime/tsconfig.json, tegg/standalone/service-worker/tsconfig.json, tegg/standalone/standalone/test/fixtures/dal-module/tsconfig.json, tegg/standalone/standalone/test/fixtures/dal-transaction-module/tsconfig.json, tegg/standalone/standalone/tsconfig.json, tools/create-egg/src/templates/egg3-simple-ts/tsconfig.json, tools/create-egg/src/templates/egg3-tegg/tsconfig.json, tools/create-egg/src/templates/simple-ts/tsconfig.json, tools/create-egg/src/templates/tegg/tsconfig.json, tools/create-egg/tsconfig.json, tools/egg-bin/test/fixtures/example-declarations/jsconfig.json, tools/egg-bin/test/fixtures/example-ts-cluster-client/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-cluster/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-cov/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-error-stack-mixed/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-error-stack/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-pkg/tsconfig.json, tools/egg-bin/test/fixtures/example-ts-test/tsconfig.json, tools/egg-bin/test/fixtures/example-ts/tsconfig.json, tools/egg-bin/test/fixtures/mocha-test-ts-esm-cov/tsconfig.json, tools/egg-bin/test/fixtures/mocha-test-ts-esm/tsconfig.json, tools/egg-bin/test/fixtures/setup-ts/tsconfig.json, tools/egg-bin/test/fixtures/standalone-bundle-ts/tsconfig.json, tools/egg-bin/test/fixtures/test-demo-app-esm/tsconfig.json, tools/egg-bin/test/fixtures/ts/tsconfig.json, tools/egg-bin/tsconfig.json, tools/egg-bundler/test/fixtures/apps/empty-app/tsconfig.json, tools/egg-bundler/test/fixtures/apps/minimal-app/tsconfig.json, tools/egg-bundler/test/fixtures/apps/tegg-app/tsconfig.json, tools/egg-bundler/tsconfig.json, tools/scripts/test/fixtures/ts-pkg/tsconfig.json, tools/scripts/test/fixtures/ts/tsconfig.json, tools/scripts/tsconfig.json, tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile |
| Demonstrated agent practice | met | 10 / 10 | 47 of the last 100 commits agent-authored or agent-credited |
| Automated maintenance | not met | 0 / 8 | no automated dependency updates observed |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 9 / 10 | dependency not pinned by hash detected -- score normalized to 9 |

### Code legibility for models — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | TypeScript (statically typed) |
| Manageable file sizes | partial | 55 / 55 | 1/4506 source files over 60KB |

### Machine-readable interfaces — 40/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | not met | 0 / 40 | — |
| MCP server | not met | 0 / 20 | — |
| Runnable examples | met | 40 / 40 | example, examples |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- npm package '@eggjs/i18n' points at a different repository (https://github.com/eggjs/i18n); excluded from ecosystem scoring
- npm package '@eggjs/jsonp' points at a different repository (https://github.com/eggjs/jsonp); excluded from ecosystem scoring

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt