{ "$comment": [ "What a release copies into the bundle, declared ONCE. Read by .gitea/workflows/release.yml when", "it assembles the tarball, and by server/scripts/checkBundle.js when CI asks whether that list", "still covers everything the module's entry point can reach.", "", "This is an INCLUDE list on purpose. An exclude list ships whatever it forgot: the day someone", "adds server/tools/ with a scratch credential in it, an exclude list packs it and nobody finds", "out. The cost of that choice is that a new top-level directory silently drops OUT of every", "release instead — which is exactly what happened to Module-uo between v0.3.0 and v1.0.0, where", "server/commands/ arrived with a cutover, the list did not learn about it, and the module", "installed and then died at the register stage on the operator's box. checkBundle.js exists so", "that cannot happen twice, and it runs on the PR that adds the directory.", "", "server[] entries are paths under server/; root[] and generated[] are paths under the module", "root.", "", "node_modules is NOT here, and its absence is asserted rather than assumed: this module declares", "no runtime dependencies (everything the shipped half needs arrives on ctx), so the release runs", "no npm ci and packs no dependency tree. checkBundle.js fails the PR that adds a `dependencies`", "entry to server/package.json without also teaching the release to pack it — because a module", "whose bundle silently lacks its own dependency fails the same way the missing directory did.", "", "generated[] ships but is not copied — release.yml writes module.json through jq to stamp the", "released version into it, since the committed one is a floor rather than a record of the last", "release. It is listed because server/index.js requires it, and a check that did not know it", "ships would report the module's own manifest as missing from the bundle." ], "server": [ "boot.js", "catalogue.js", "core.js", "db", "index.js", "ingest.js", "model", "package.json", "router", "sidecarClient.js" ], "root": [ "swagger-fragment.json", "LICENSE.md", "README.md" ], "generated": [ "module.json" ] }