feat: Add --system-cleanup to bootstrap.sh

This commit adds a new `--system-cleanup` flag to `bootstrap.sh`. This flag allows users to run the aggressive `scripts/cleanup.sh` script via the bootstrap wrapper, ensuring `sudo` privileges are handled correctly.

The changes include:
- Added `--system-cleanup` handling in `bootstrap.sh`.
- Updated `bootstrap.sh` help text.
- Updated `README.md` documentation.
- Updated `scripts/cleanup.sh` comments to reference the new usage.

Co-authored-by: LokiMetaSmith <5054116+LokiMetaSmith@users.noreply.github.com>

Author: google-labs-jules[bot]

README.md

@@ -80,6 +80,7 @@ For development, testing, or bootstrapping the very first node of a new cluster,
    - `--external-model-server`: Skips the download and build steps for large language models. This is ideal for development or if you are using a remote model server.
    - `--purge-jobs`: Stops and purges all running Nomad jobs before starting the bootstrap process, ensuring a clean deployment.
    - `--leave-services-running`: Do not clean up Nomad and Consul data on startup (useful for restarts without state loss).
+   - `--system-cleanup`: **Use with caution.** Aggressively cleans Docker resources, Apt cache, and logs to free up disk space on the host machine.
    - `--clean`: **Use with caution.** This will permanently delete all untracked files in the repository (`git clean -fdx`), restoring it to a pristine state.
    - `--debug`: Enables verbose Ansible logging (`-vvvv`) and saves the full output to `playbook_output.log`.
    - `--verbose [level]`: Set verbosity level (0-4). Default 0, or 3 if flag is used without value.

bootstrap.sh

@@ -27,6 +27,7 @@ show_help() {
     echo "  --tags <tags>                Comma-separated list of Ansible tags to run."
     echo "  --user <user>                Specify the target user for Ansible. Default: pipecatapp."
     echo "  --purge-jobs                 Stop and purge all running Nomad jobs before starting."
+    echo "  --system-cleanup             Aggressively clean Docker resources, Apt cache, and logs."
     echo "  --clean                      Clean the repository of all untracked files (interactive prompt)."
     echo "  --verbose [level]            Set verbosity level (0-4). Default 0, or 3 if flag is used without value."
     echo "  --debug                      Alias for --verbose 4."
@@ -45,6 +46,7 @@ show_help() {
 # --- Initialize flags ---
 USE_CONTAINER=false
 CLEAN_REPO=false
+SYSTEM_CLEANUP=false
 VERBOSE_LEVEL=0
 ROLE="all"
 CONTROLLER_IP=""
@@ -64,6 +66,9 @@ for ((i=0; i<${#ARGS[@]}; i++)); do
     fi
 
     case $arg in
+        --system-cleanup)
+            SYSTEM_CLEANUP=true
+            ;;
         --clean)
             CLEAN_REPO=true
             PROCESSED_ARGS+=("$arg")
@@ -264,6 +269,22 @@ if [ "$CLEAN_REPO" = true ]; then
     fi
 fi
 
+# --- Handle the --system-cleanup option ---
+if [ "$SYSTEM_CLEANUP" = true ]; then
+    echo -e "\n${YELLOW}⚠️  --system-cleanup flag detected. This will aggressively clean Docker, Apt, and logs.${NC}"
+    read -p "Are you sure you want to proceed? [y/N] " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        # Ensure sudo
+        if ! sudo -n true 2>/dev/null; then
+             sudo -v
+        fi
+        run_step "System Cleanup" "sudo ./scripts/cleanup.sh"
+    else
+        echo "System cleanup cancelled."
+    fi
+fi
+
 # --- Install Python dependencies (Virtual Environment) ---
 echo -e "\n${BOLD}=== Environment Setup ===${NC}"
 VENV_DIR="$SCRIPT_DIR/.venv"

scripts/cleanup.sh

@@ -3,6 +3,11 @@
 # Cleanup script to free up disk space on the host machine.
 # This script aggressively cleans Docker resources, Apt cache, and temporary files.
 # It is intended to be run with sudo privileges.
+#
+# Usage:
+#   sudo ./scripts/cleanup.sh
+#   OR via bootstrap:
+#   ./bootstrap.sh --system-cleanup
 
 set -e