Rust Build Operations

Efficiently build Rust workspaces with the build-rust CLI.

Usage

# Development (fast, debug symbols)
./scripts/build-rust.sh dev

# Release (optimized, stripped)
./scripts/build-rust.sh release

# Profile with timing information
./scripts/build-rust.sh profile

# Fast type-check only
./scripts/build-rust.sh check

# Clean build artifacts
./scripts/build-rust.sh clean

# Build specific crate
./scripts/build-rust.sh release memory-core

Modes

Disk Space Optimization (ADR-032)

The dev profile is optimized to reduce target/ size (~5.2 GB → ~2 GB):

# .cargo/config.toml
[profile.dev]
debug = "line-tables-only"    # ~60% smaller debug artifacts

[profile.dev.package."*"]
debug = false                 # No debug info for dependencies

[profile.dev.build-override]
opt-level = 3                 # Faster proc-macro execution

[profile.debugging]
inherits = "dev"
debug = true                  # Full debug when needed: --profile debugging

Linker: Use mold on Linux for 2-5x faster link times:

[target.'cfg(target_os = "linux")']
rustflags = ["-C", "link-arg=-fuse-ld=mold"]

Cleanup: cargo clean or ./scripts/clean-artifacts.sh

Common Issues

Timeouts

• Use dev mode for faster iteration
• Reduce parallel jobs: CARGO_BUILD_JOBS=4 ./scripts/build-rust.sh release

Memory errors

• Build with fewer jobs: cargo build -j 4
• Use check instead of full build

Dependency conflicts

• Update: cargo update
• Check tree: cargo tree -e features
• Check duplicates: cargo tree -d | grep -cE "^[a-z]"

Platform-specific

• Install targets: rustup target add <triple>
• Conditional compilation: #[cfg(target_os = "linux")]

References

• ADR-032: Disk Space Optimization
• ADR-036: Dependency Deduplication