From 4a4e7d9bda77532343abbb3760536799856ed252 Mon Sep 17 00:00:00 2001 From: killa Date: Tue, 5 May 2026 02:03:21 +0800 Subject: [PATCH 1/2] docs(bundler): document manifest dynamic entries --- tools/egg-bundler/docs/output-structure.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tools/egg-bundler/docs/output-structure.md b/tools/egg-bundler/docs/output-structure.md index 9670d81f1c..9bdc738521 100644 --- a/tools/egg-bundler/docs/output-structure.md +++ b/tools/egg-bundler/docs/output-structure.md @@ -40,6 +40,12 @@ is keyed by relKey, output-dir absolute paths, precomputed original app absolute paths, and manifest `resolveCache` request aliases. Application code and plugins may still use `fs` for resources such as config, views, or assets. +When the bundler generates a missing startup manifest with `metadataOnly: true`, +Egg also records convention-based dynamic entries from each load unit, including +`agent`, `app`, `app/extend/*`, and `app/middleware/*`. This lets bundled +single-mode workers resolve plugin agent hooks, extensions, and middleware that +are normally discovered later during runtime loading. + ## `bundle-manifest.json` A reference file produced by `Bundler` (not consumed at runtime). Shape: From 3e4da91e73a737ac92fa8fad8f190f95a3197de7 Mon Sep 17 00:00:00 2001 From: killa Date: Tue, 5 May 2026 02:12:02 +0800 Subject: [PATCH 2/2] docs(bundler): clarify generated manifest entries --- tools/egg-bundler/docs/output-structure.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/tools/egg-bundler/docs/output-structure.md b/tools/egg-bundler/docs/output-structure.md index 9bdc738521..60e3cc8fd1 100644 --- a/tools/egg-bundler/docs/output-structure.md +++ b/tools/egg-bundler/docs/output-structure.md @@ -40,8 +40,9 @@ is keyed by relKey, output-dir absolute paths, precomputed original app absolute paths, and manifest `resolveCache` request aliases. Application code and plugins may still use `fs` for resources such as config, views, or assets. -When the bundler generates a missing startup manifest with `metadataOnly: true`, -Egg also records convention-based dynamic entries from each load unit, including +When the bundler generates a missing `.egg/manifest.json` with +`metadataOnly: true`, Egg also records convention-based dynamic lookups from each +load unit into the manifest `resolveCache` and `fileDiscovery`, including `agent`, `app`, `app/extend/*`, and `app/middleware/*`. This lets bundled single-mode workers resolve plugin agent hooks, extensions, and middleware that are normally discovered later during runtime loading.