feat(build): add --platform and --arch flags for consistency

Add support for --platform and --arch flags to root build script
to match node-sea-builder syntax, while maintaining backward
compatibility with --target combined syntax.

Changes:
- Add --platform and --arch flag parsing
- Support both syntaxes: --target darwin-arm64 OR --platform darwin --arch arm64
- Update help text and documentation
- Update README.md and docs/build/README.md with both syntaxes

Benefits:
- Consistent with node-sea-builder flags
- Flexibility for users (choose preferred syntax)
- Backward compatible (--target still works)

Author: jdalton

README.md

@@ -178,8 +178,11 @@ pnpm run build --target cli
 # Build SEA binary
 pnpm run build --target sea
 
-# Build specific platform binary
+# Build specific platform binary (combined syntax)
 pnpm run build --target darwin-arm64
+
+# Build specific platform binary (separate flags - matches node-sea-builder)
+pnpm run build --platform darwin --arch arm64
 ```
 
 #### Multiple target builds

docs/build/README.md

@@ -49,6 +49,7 @@ The Socket CLI build system builds packages in this order:
 | `pnpm build` | Smart build with caching (skips unchanged packages) |
 | `pnpm build --force` | Force rebuild everything |
 | `pnpm build --target <name>` | Build specific target (see targets below) |
+| `pnpm build --platform <p> --arch <a>` | Build specific platform/arch (matches node-sea-builder syntax) |
 | `pnpm build --targets <t1,t2,...>` | Build multiple targets |
 | `pnpm build --platforms` | Build all platform binaries (8 platforms) |
 | `pnpm build --platforms --parallel` | Build platforms in parallel (faster) |
@@ -97,6 +98,12 @@ Available targets for `pnpm build --target <name>`:
 # Build just the CLI
 pnpm build --target cli
 
+# Build for specific platform (combined syntax)
+pnpm build --target darwin-arm64
+
+# Build for specific platform (separate flags - matches node-sea-builder)
+pnpm build --platform darwin --arch arm64
+
 # Build multiple targets
 pnpm build --targets cli,sea
 

scripts/build.mjs

@@ -99,6 +99,8 @@ function parseArgs() {
   let parallel = false
   let force = false
   let help = false
+  let platform = null
+  let arch = null
   const buildArgs = []
 
   for (let i = 0; i < args.length; i++) {
@@ -107,6 +109,14 @@ function parseArgs() {
       target = args[++i]
     } else if (arg === '--targets' && i + 1 < args.length) {
       targets = args[++i].split(',').map(t => t.trim())
+    } else if (arg === '--platform' && i + 1 < args.length) {
+      platform = args[++i]
+    } else if (arg.startsWith('--platform=')) {
+      platform = arg.split('=')[1]
+    } else if (arg === '--arch' && i + 1 < args.length) {
+      arch = args[++i]
+    } else if (arg.startsWith('--arch=')) {
+      arch = arg.split('=')[1]
     } else if (arg === '--platforms') {
       platforms = true
     } else if (arg === '--parallel') {
@@ -120,7 +130,12 @@ function parseArgs() {
     }
   }
 
-  return { buildArgs, force, help, parallel, platforms, target, targets }
+  // If --platform and --arch are provided, combine them into target.
+  if (platform && arch) {
+    target = `${platform}-${arch}`
+  }
+
+  return { arch, buildArgs, force, help, parallel, platform, platforms, target, targets }
 }
 
 /**
@@ -134,6 +149,7 @@ function showHelp() {
   logger.log('  pnpm run build                           # Smart build (skips unchanged)')
   logger.log('  pnpm run build --force                   # Force rebuild all')
   logger.log('  pnpm run build --target <name>           # Build specific target')
+  logger.log('  pnpm run build --platform <p> --arch <a> # Build specific platform/arch')
   logger.log('  pnpm run build --targets <t1,t2,...>     # Build multiple targets')
   logger.log('  pnpm run build --platforms               # Build all platform binaries')
   logger.log('  pnpm run build --platforms --parallel    # Build platforms in parallel')