fix: Bun Feature Failure on Apple Silicon ARM64 + Feature Hardening

[trevordcampbell]

Problem

The Bun feature failed to install on Apple Silicon Mac hosts when creating arm64 Linux containers.
Users encountered this error: no matches found for asset regex: ^bun-linux-aarch64-baseline\.zip$

Root Cause

The Bun feature was attempting to download bun-linux-aarch64-baseline.zip, but Bun does not publish
"baseline" variants for the ARM64 architecture. For linux / arm64, Bun only publishes:

• bun-linux-aarch64.zip (glibc)
• bun-linux-aarch64-musl.zip (musl)

This worked on linux / amd64-based DevContainers because baseline variants exist there, but failed on arm64-based DevContainers.

Solution

1. arm64 Asset Pattern Fix

• arm64 now uses standard builds instead of non-existent baseline variants
• Removed 5x larger profile builds from fallbacks
• Asset patterns now match actual available Bun releases

2. Comprehensive Feature Enhancements

Robust libc Detection

• Enhanced from single /sbin/apk check to 4 detection methods:
  • Alpine package manager detection
  • ldd --version output analysis
  • musl library file presence
  • /proc/mounts analysis
  • Detection logs are emitted to stderr; function returns clean stdout
  • Fixed /proc/mounts musl check to avoid broken grep pipeline

Enhanced Architecture Support

• Proper detection of aarch64 and arm64 aliases
• Clear error messages for unsupported architectures

Better Error Handling & Diagnostics

• Detailed troubleshooting information in error messages
• Architecture, libc, version, and asset pattern details
• Actionable links to Bun releases for manual troubleshooting

Improved Logging & User Experience

• Structured logging with timestamps: [2024-01-15 10:30:15] INFO: ...
• Consistent log levels: INFO, SUCCESS, WARNING, ERROR
• Progress indicators throughout installation process
• Optional debug logs via BUN_FEATURE_DEBUG=1

Performance Optimizations

• Efficient nanolayer location handling
• Early exit conditions in detection functions
• Optimized array handling for asset patterns
• Simplified install loop with early return on first successful asset

Version Handling Enhancements

• Robust version canonicalization function
• Multiple input format support: 1.2.3, v1.2.3, bun-v1.2.3
• Validation with graceful fallback to "latest" for invalid formats

Benefits

For Apple Silicon Users

• Fixes the original installation failure
• Proper arm64 asset selection
• Works across Debian, Ubuntu and Alpine containers

For All Users

• Better error messages and troubleshooting
• More robust across different Linux distributions
• Structured logging for better debugging
• Performance optimizations
• Future-proof version handling

Files Changed

src/bun/install.sh

• Rewrite with enhanced architecture detection
• Robust libc detection across multiple distros
• Structured logging and error handling
• Performance optimizations and version enhancements

src/bun/NOTES.md

• Updated documentation to reflect arm64 support
• Clarified architecture limitations
• Added information about asset selection logic

Testing

• ✅ All Tests Passed

References

• Fixes [Bug]: [features/bun]: Build fails for Linux arm64/Apple Silicon #146
• Bun Release Assets

[trevordcampbell]

Would appreciate a review + merge on this to clear the related issue

[koralowiec]

Hi Trevor! Thanks for your PR, and sorry for the delay with the review, I'm being busy lately. I'm going to review it by the end of this week

[koralowiec]

To be honest, I think that there's too much logging, and maybe too much logic in some places.

Generally, the solution which you provided looks nice, but I would like to get rid of the logging part. So please remove the log and debug_log functions, and their execution. If you feel something has to be output, use echo for now.

Like I mentioned in one of the comments, I'm going to think about adding the logging functions to the shared script (#165)

[myktra]

@trevordcampbell possible to get these changes as advised in so it can be merged up and released? Thankful for your contribution - eager to drop workarounds!

[trevordcampbell]

I just pushed the requested changes to the Bun feature. Hopefully should be ready to ship now. Apologies for the delay

[koralowiec]

Please change the bun version in the test

[trevordcampbell]

Should be good to go now