📝 Docs: Nightly Netlify deploys are failing

[JoshuaKGoldberg]

Documentation Request Checklist

• I have read and agree to Mocha's Code of Conduct and Contributing Guidelines
• I have searched for related issues and issues with the faq label, but none matched my issue.
• I want to provide a PR to resolve this

Overview

Filing an issue for tracking & visibility: the site's nightly deploys are broken at the moment. We'll want to fix these:

7:19:05 PM: nps is executing `docs.postbuild` : buildProduction docs/_site/index.html --outroot docs/_dist --canonicalroot https://mochajs.org/ --optimizeimages --svgo --inlinehtmlimage 9400 --inlinehtmlscript 0 --asyncscripts && cp docs/_headers docs/_dist/_headers && node scripts/netlify-headers.js docs/_dist >> docs/_dist/_headers
7:19:05 PM: /bin/sh: 1: buildProduction: not found
7:19:05 PM: The script called "docs.postbuild" which runs "buildProduction docs/_site/index.html --outroot docs/_dist --canonicalroot https://mochajs.org/ --optimizeimages --svgo --inlinehtmlimage 9400 --inlinehtmlscript 0 --asyncscripts && cp docs/_headers docs/_dist/_headers && node scripts/netlify-headers.js docs/_dist >> docs/_dist/_headers" failed with exit code 127 https://github.com/sezna/nps/blob/master/other/ERRORS_AND_WARNINGS.md#failed-with-exit-code
7:19:05 PM: The script called "docs.production" which runs "nps docs && nps docs.postbuild" failed with exit code 127 https://github.com/sezna/nps/blob/master/other/ERRORS_AND_WARNINGS.md#failed-with-exit-code
7:19:05 PM: ​
7:19:05 PM: "build.command" failed                                        
7:19:05 PM: ────────────────────────────────────────────────────────────────
7:19:05 PM: ​
7:19:05 PM:   Error message
7:19:05 PM:   Command failed with exit code 127: npm start docs.production (https://ntl.fyi/exit-code-127)
7:19:05 PM: ​

Additional Info

@voxpelli started looking into it today. Partial progress: #5095.

[JoshuaKGoldberg]

I poked at this locally. It failed on my M1 Mac with Error executing gm: stream ended without emitting any data at first. Then after running brew install graphicsmagick, all was well. So that wasn't the real issue.

Netlify's complaint is buildProduction: not found. So it's some bin/scoping shenanigan where the bin/buildProduction from assetgraph-builder isn't being registered.

Band-aid / short-term fix: I bet we can replace buildProduction with node node_modules/assetgraph-builder/bin/buildProduction.

Better / longer-term fix: we'd previously talked about how we wanted to move off the old package-scripts / nps module. That might be nice, but would be a separate followup IMO.

[voxpelli]

Yeah, the initial nps removal code is here, I need to break it out: #5042