fix: vite-plugin-static-copy patch and build configuration

- Extended vite-plugin-static-copy patch with two fixes:
  - Environment guard now defaults to 'client' when no environment option is passed
  - Corrected outDir resolution per environment (SSR vs client)
- Re-applied astro.config.mjs maxParallelFileOps: 8 for stable builds
- Reverted links validator condition to !process.env.NETLIFY for local validation
- Updated pnpm-lock.yaml from patch changes
- Added BUILD_AUDIT.md and BUILD_COMPARISON.md to .gitignore
- Documented patch changes in project-docs/PATCHES.md

Author: ravibits

.gitignore

@@ -54,3 +54,5 @@ docs/superpowers/
 venv/
 .venv/
 examples/*
+project-docs/BUILD_AUDIT.md
+project-docs/BUILD_COMPARISON.md

astro.config.mjs

@@ -105,10 +105,9 @@ export default defineConfig({
           askAi: '8jKZkVuXS0hG',
         }),
         starlightVideos(),
-        // Links validator: enabled locally and on deploy previews; skipped on production
-        // Netlify builds to reduce peak memory usage.
-        // CONTEXT is set by Netlify: 'production' | 'deploy-preview' | 'branch-deploy'
-        ...(!process.env.NETLIFY || process.env.CONTEXT !== 'production'
+        // Links validator disabled in CI to reduce build memory usage.
+        // Run locally with: pnpm astro build (without NETLIFY env var)
+        ...(!process.env.NETLIFY
           ? [
               starlightLinksValidator({
                 exclude: ['/apis/**'],
@@ -411,8 +410,6 @@ export default defineConfig({
       // Disable gzip size reporting to save memory on large builds
       reportCompressedSize: false,
       rollupOptions: {
-        // Limit parallel file I/O to reduce memory spikes during bundling.
-        // 8 caps concurrency well below unlimited while reducing serialization vs. the prior value of 2.
         maxParallelFileOps: 8,
         output: {
           manualChunks(id) {

patches/vite-plugin-static-copy@4.1.0.patch

@@ -2,8 +2,16 @@ diff --git a/dist/index.js b/dist/index.js
 index 8703f1bd5f6438c61a80b9fc842722820bd9a49f..835dfa2cf82fae6eee47fb478108055d858856a3 100644
 --- a/dist/index.js
 +++ b/dist/index.js
-@@ -1069,7 +1069,8 @@ const buildPlugin = ({ targets, silent, hook, environment }) => {
- 			if (this.environment && this.environment.name !== environment) return;
+@@ -1063,13 +1063,14 @@ const buildPlugin = ({ targets, silent, hook, environment }) => {
+ 		},
+ 		buildEnd() {
+-			if (this.environment && this.environment.name !== environment) return;
++			if (this.environment && this.environment.name !== (environment ?? 'client')) return;
+ 			output = false;
+ 		},
+ 		async [hook]() {
+-			if (this.environment && this.environment.name !== environment) return;
++			if (this.environment && this.environment.name !== (environment ?? 'client')) return;
  			if (output) return;
  			output = true;
 -			const result = await copyAll(config.root, config.build.outDir, targets, silent);