chore(docs): standardize build artifact structure and documentation organization

- Update .gitignore for build/dist standard (build=scratch, dist=distribution)
- Remove global ignores for dist/, pkg/, target/ directories
- Add specific patterns for build subdirectories (target, pkg, out, cmake, _deps, wasm)
- Reorganize docs/ structure: move build-related docs to docs/build/
- Update docs/README.md with complete build documentation index
- Fix verify-sea-transforms.mjs to use correct build/sea/ path

Author: jdalton

.gitignore

@@ -21,17 +21,22 @@ Thumbs.db
 **/.cache
 **/coverage
 **/.type-coverage
-**/dist
 **/build
 **/node_modules
 .build-checkpoints
-**/pkg
-**/target
 *.d.ts
 *.d.ts.map
 **/*.tmp
 *.tsbuildinfo
 
+# Build artifacts (inside build/ only).
+**/build/target/
+**/build/pkg/
+**/build/out/
+**/build/cmake/
+**/build/_deps/
+**/build/wasm/
+
 # Yarn PnP files (tests may create these)
 /.yarn
 /.pnp.cjs

docs/README.md

@@ -21,11 +21,16 @@
 - [Unified binary design](architecture/unified-binary.md)
 
 ### Build System
+- [Build process overview](build/build-process.md)
+- [Build quick start](build/build-quick-start.md)
 - [Build system summary](build/build-system-summary.md)
+- [Build toolchain setup](build/build-toolchain-setup.md)
+- [Builds created](build/builds-created.md)
 - [Node.js build order](build/node-build-order-explained.md)
 - [Node.js build quick reference](build/node-build-quick-reference.md)
 - [Node.js patch creation guide](build/node-patch-creation-guide.md)
 - [Node.js patch metadata](build/node-patch-metadata.md)
+- [WASM build guide](build/wasm-build-guide.md)
 
 ### Configuration
 - [Configuration migration guide](configuration/configuration-migration.md)

docs/build-process.md docs/build/build-process.mddocs/build-process.md renamed to docs/build/build-process.md

@@ -82,8 +82,8 @@ function verifyPolyfill(code) {
 async function main() {
   const modifiedCliPath = path.join(
     __dirname,
-    '../../..',
-    'packages/dist/sea/cli-modified.js',
+    '..',
+    'build/sea/cli-modified.js',
   )
 
   logger.log('SEA Transformation Verification')