Merge PR #487: feat: optimize builds for CI and reduce disk usage

Left-side: Build optimization features (CI profiles, sccache, cleanup) documented in PR.
Right-side: Conflicts resolved (kept HEAD's error handling); cargo check PASS.

Author: Terraphim CI

.github/workflows/cleanup-target.yml

@@ -0,0 +1,37 @@
+name: Cleanup Target Directory
+
+on:
+  schedule:
+    - cron: '0 0 * * 0'  # Weekly cleanup on Sundays at midnight UTC
+  workflow_dispatch:
+
+jobs:
+  cleanup:
+    name: Clean old build artifacts
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Rust toolchain
+        uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+
+      - name: Clean release artifacts
+        run: |
+          cargo clean --release
+          cargo clean --doc
+
+      - name: Display disk usage
+        run: |
+          echo "Target directory size after cleanup:"
+          du -sh target/
+
+      - name: Summary
+        run: |
+          echo "### Cleanup completed" >> $GITHUB_STEP_SUMMARY
+          echo "- Cleaned release artifacts" >> $GITHUB_STEP_SUMMARY
+          echo "- Cleaned documentation artifacts" >> $GITHUB_STEP_SUMMARY

Cargo.toml

@@ -42,3 +42,18 @@ lto = true
 codegen-units = 1
 opt-level = 3
 panic = "abort"
+
+# CI-optimized profiles for faster builds with less disk usage
+[profile.ci]
+inherits = "dev"
+incremental = false
+codegen-units = 16
+split-debuginfo = "off"
+debug = false
+strip = true
+
+[profile.ci-release]
+inherits = "release"
+lto = "thin"
+codegen-units = 8
+strip = "symbols"

scripts/cleanup-build.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# Cleanup build artifacts to prevent target directory bloat
+# Usage: ./scripts/cleanup-build.sh [options]
+# Options:
+#   --aggressive  Remove more artifacts (docs, unused deps)
+#   --dry-run     Show what would be deleted without actually deleting
+
+set -euo pipefail
+
+AGGRESSIVE=false
+DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --aggressive)
+            AGGRESSIVE=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            echo "Usage: $0 [--aggressive] [--dry-run]"
+            exit 1
+            ;;
+    esac
+done
+
+cd "$(git rev-parse --show-toplevel)" || exit 1
+
+echo "=== Terraphim Build Cleanup ==="
+echo "Mode: $([ "$DRY_RUN" = true ] && echo 'DRY RUN (no changes)' || echo 'ACTIVE')"
+echo "Aggressive: $AGGRESSIVE"
+echo ""
+
+# Calculate current size
+echo "Current target directory size:"
+du -sh target/ 2>/dev/null || echo "No target directory found"
+echo ""
+
+# Cleanup commands
+cleanup_commands=(
+    "Remove old release builds older than 7 days: find target/release -name '*.rlib' -mtime +7 -delete"
+    "Remove debug rlibs older than 3 days: find target/debug -name '*.rlib' -mtime +3 -delete"
+    "Remove doc directory: rm -rf target/doc"
+    "Remove incremental compilation: rm -rf target/*/incremental"
+)
+
+if [ "$AGGRESSIVE" = true ]; then
+    cleanup_commands+=(
+        "Remove all debug builds: cargo clean --debug"
+        "Remove example builds: find target -name 'examples' -type d -exec rm -rf {} +"
+        "Remove benchmark builds: find target -name 'benches' -type d -exec rm -rf {} +"
+    )
+fi
+
+# Execute cleanup
+for cmd in "${cleanup_commands[@]}"; do
+    echo "Executing: $cmd"
+    if [ "$DRY_RUN" = false ]; then
+        eval "$cmd" 2>/dev/null || true
+    fi
+done
+
+echo ""
+
+# Show sizes of large directories
+echo "=== Large directories in target ==="
+
+find target -maxdepth 2 -type d -exec du -sh {} \; 2>/dev/null | sort -rh | head -20 || true
+
+echo ""
+
+# Final size after cleanup
+echo "Target directory size after cleanup:"
+du -sh target/ 2>/dev/null || echo "No target directory found"
+
+echo ""
+if [ "$DRY_RUN" = false ]; then
+    echo "Cleanup completed!"
+    echo "Run with --dry-run to preview changes"
+else
+    echo "Dry run completed. Run without --dry-run to execute cleanup."
+fi