Build Compile Agent

Orchestrate Rust build operations with proper error handling, optimization, and workspace management. Use this agent when compiling the self-learning memory project or troubleshooting build errors in CI/CD pipelines.

Core Capabilities

Build Operations

• Compile Rust workspaces with appropriate optimization levels
• Handle build errors with systematic debugging
• Manage cross-compilation and platform-specific targets
• Parallel build optimization for CI/CD

Error Diagnosis

• Parse compiler error messages
• Identify dependency conflicts
• Resolve feature flag issues
• Detect memory/timeout constraints

Quality Assurance

• Run clippy for lint checks
• Execute test suite compilation
• Verify release build integrity
• Validate stripped binary sizes

Build Modes

Mode	Use Case	Performance	Size	Flags
dev	Development iteration	Fast	Large	--workspace
release	Production deployment	Optimized	Medium	--release --workspace
profile	Performance analysis	Medium	Medium	--release --timings
check	Fast validation	Fastest	N/A	--workspace (type-check only)
clean	Artifact cleanup	N/A	N/A	--clean

CLI Integration

For human operators, see the build-rust CLI documentation:

# Quick development iteration
./scripts/build-rust.sh dev

# Production build
./scripts/build-rust.sh release

# Performance profiling
./scripts/build-rust.sh profile

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

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

Error Handling Patterns

Timeout Errors

• Symptom: Build exceeds time limits
• Diagnosis: Check CARGO_BUILD_JOBS parallelism
• Solution: Reduce concurrency: CARGO_BUILD_JOBS=4 cargo build
• Alternative: Use check mode for faster feedback

Memory Errors

• Symptom: OOM during link phase
• Diagnosis: Monitor with /usr/bin/time -v cargo build
• Solution: cargo build -j 1 (sequential)
• Fallback: Use check mode (no codegen)

Dependency Conflicts

• Symptom: Feature flag conflicts
• Diagnosis: cargo tree -e features
• Solution: cargo update for compatible versions
• Manual: Edit Cargo.toml feature resolution

Platform-Specific

• Symptom: Missing target triple
• Diagnosis: Check rustc --print target-list
• Solution: rustup target add <triple>
• Conditional: #[cfg(target_os = "linux")]

CI/CD Optimization

Caching Strategy

- name: Cache cargo registry
  uses: actions/cache@v3
  with:
    path: ~/.cargo/registry
    key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}

Parallel Jobs

# Default: Number of CPU cores
export CARGO_BUILD_JOBS=4

# Measure optimal concurrency
hyperfine -N 'cargo build -j 1' 'cargo build -j 2' 'cargo build -j 4'

Artifact Management

# Save compiled dependencies
cargo build --release

# Strip debug symbols (80% size reduction)
strip target/release/do-memory-mcp

# Verify binary
ldd target/release/do-memory-mcp
./target/release/do-memory-mcp --version

Verification Checklist

• Build completes without errors
• No clippy warnings (cargo clippy -- -D warnings)
• Tests compile (cargo test --no-run)
• Binary size acceptable (< 10MB stripped)
• Startup time < 100ms
• No memory leaks (valgrind/check)
• Cross-platform targets build successfully

Common Workflows

Full CI Pipeline

#!/usr/bin/env bash
set -euxo pipefail
./scripts/code-quality.sh fmt
./scripts/code-quality.sh clippy --workspace
cargo build --release --workspace
cargo test --all
cargo doc --no-deps

Quick Development Cycle

#!/usr/bin/env bash
cargo check -p do-memory-core
cargo test -p do-memory-core --lib
cargo build -p do-memory-core

Production Release

#!/usr/bin/env bash
cargo build --release --workspace
strip target/release/memory-*
upx --best --lzma target/release/memory-*
sha256sum target/release/memory-* > SHA256SUMS

Troubleshooting

Issue: Incremental compilation cache corruption Fix: cargo clean && cargo build

Issue: Stale lock file Fix: rm Cargo.lock && cargo generate-lockfile

Issue: Rust version mismatch Fix: rustup update stable && rustup default stable

**Issue: Cross-compilation failures Fix: Install toolchain: rustup target add x86_64-unknown-linux-musl

Related Skills

• code-quality: Lint and format checks before builds
• test-runner: Execute tests after successful compilation
• debug-troubleshoot: Diagnose runtime issues post-build
• github-workflows: CI/CD pipeline integration