feat(cpython): hacer scripts idempotentes y sin fallas silenciosas

Mejoras principales:

1. **build_cpython.sh** - Idempotencia y robustez:
   - Agregar flag --force para sobrescribir artifacts sin prompt interactivo
   - Limpiar instalaciones previas en /opt/python-X.Y.Z antes de instalar
   - Validar downloads completos (no vacíos) antes de extraer
   - Detectar tarballs corruptos y eliminarlos automáticamente
   - Manejo explícito de errores en operaciones sudo
   - Verificar que artifacts generados son legibles
   - Reutilizar código fuente existente en /tmp (con opción de re-download con --force)

2. **bootstrap.sh** - Manejo de errores mejorado:
   - Validar éxito de apt-get update y upgrade (no silent failures)
   - Usar DEBIAN_FRONTEND=noninteractive para evitar prompts
   - Validar que directorios creados son escribibles
   - Manejo de errores en verificación de paquetes instalados
   - Todos los comandos críticos verifican códigos de salida

3. **cleanup.sh** - Nuevo script para idempotencia:
   - Limpiar builds temporales (/tmp/cpython-build)
   - Limpiar instalaciones (/opt/python-*)
   - Limpiar artifacts generados (.tgz, .sha256)
   - Mostrar estado actual del entorno
   - Soporte para limpieza selectiva o completa

4. **README.md** - Documentación actualizada:
   - Documentar flag --force para build_cpython.sh
   - Documentar script cleanup.sh con ejemplos
   - Explicar características de idempotencia
   - Explicar manejo de errores sin fallas silenciosas

Beneficios:
- Scripts pueden ejecutarse múltiples veces sin efectos secundarios
- Todos los errores se reportan explícitamente (exit code != 0)
- Ambiente reproducible para troubleshooting
- No requiere intervención manual (fully automated)
- Apropiado para CI/CD pipelines

Testing recomendado:
- Ejecutar build_cpython.sh dos veces (debe fallar en segundo intento sin --force)
- Ejecutar con --force (debe sobrescribir exitosamente)
- Interrumpir build a mitad (ctrl-c) y re-ejecutar (debe reanudar/limpiar)
- Ejecutar cleanup.sh para verificar limpieza completa

Relacionado: requisitos de usuario sobre scripts sin fallas silenciosas e idempotentes

Author: claude

infrastructure/cpython/README.md

@@ -110,20 +110,27 @@ infrastructure/cpython/artifacts/
 
 **Sintaxis**:
 ```bash
-./scripts/build_cpython.sh <version> [build-number]
+./scripts/build_cpython.sh <version> [build-number] [--force]
 ```
 
 **Argumentos**:
 - `version`: Versión de Python (formato X.Y.Z, ejemplo: 3.12.6)
 - `build-number`: Número de build (opcional, default: 1)
+- `--force`: Sobrescribir artefacto existente sin preguntar
 
 **Ejemplos**:
 ```bash
 ./scripts/build_cpython.sh 3.12.6        # Build 1 de Python 3.12.6
 ./scripts/build_cpython.sh 3.12.6 2      # Build 2 (rebuild)
 ./scripts/build_cpython.sh 3.11.9        # Python 3.11.9
+./scripts/build_cpython.sh 3.12.6 1 --force  # Sobrescribir build existente
 ```
 
+**Características**:
+- **Idempotente**: Puede ejecutarse múltiples veces, detecta instalaciones previas
+- **Sin fallas silenciosas**: Todos los errores se reportan con códigos de salida
+- **Validación robusta**: Verifica descargas, extracciones, y compilaciones
+
 **Flags de compilación**:
 - `--enable-optimizations`: Profile-Guided Optimization (PGO)
 - `--with-lto`: Link-Time Optimization
@@ -161,6 +168,34 @@ infrastructure/cpython/artifacts/
 - 0: Validación exitosa
 - 1: Validación falló
 
+#### cleanup.sh
+
+**Propósito**: Limpiar entorno de compilación para rebuilds limpios (idempotencia)
+
+**Sintaxis**:
+```bash
+./scripts/cleanup.sh [--all|--build|--artifacts|--install]
+```
+
+**Opciones**:
+- Sin argumentos: Muestra estado actual del entorno
+- `--all`: Limpia todo (builds, instalaciones, artifacts)
+- `--build`: Limpia solo directorios de build temporales (`/tmp/cpython-build`)
+- `--install`: Limpia instalaciones en `/opt/python-*`
+- `--artifacts`: Limpia artifacts generados (`.tgz` y `.sha256`)
+
+**Ejemplos**:
+```bash
+./scripts/cleanup.sh               # Ver estado
+./scripts/cleanup.sh --build       # Limpiar builds temporales
+./scripts/cleanup.sh --all         # Limpieza completa
+```
+
+**Casos de uso**:
+- Antes de rebuild para asegurar ambiente limpio
+- Liberar espacio en disco
+- Troubleshooting de compilaciones fallidas
+
 ---
 
 ## Gestión de VM

infrastructure/cpython/bootstrap.sh

@@ -23,10 +23,16 @@ update_system() {
     log_step 1 3 "Actualizando sistema"
 
     log_info "Actualizando lista de paquetes..."
-    apt-get update -qq
+    if ! apt-get update -qq; then
+        log_error "Fallo al actualizar lista de paquetes"
+        return 1
+    fi
 
     log_info "Actualizando paquetes del sistema..."
-    apt-get upgrade -y -qq
+    if ! apt-get upgrade -y -qq; then
+        log_error "Fallo al actualizar paquetes del sistema"
+        return 1
+    fi
 
     log_success "Sistema actualizado"
 }
@@ -37,7 +43,8 @@ install_build_dependencies() {
     log_info "Instalando toolchain de compilacion..."
 
     # Dependencias segun: https://devguide.python.org/getting-started/setup-building/
-    apt-get install -y -q \
+    # Usar DEBIAN_FRONTEND=noninteractive para evitar prompts interactivos
+    if ! DEBIAN_FRONTEND=noninteractive apt-get install -y -q \
       build-essential \
       gdb \
       lcov \
@@ -58,20 +65,27 @@ install_build_dependencies() {
       zlib1g-dev \
       wget \
       curl \
-      ca-certificates
+      ca-certificates; then
+        log_error "Fallo al instalar dependencias de compilacion"
+        log_error "Verifique conectividad de red y repositorios APT"
+        return 1
+    fi
 
     log_success "Dependencias de compilacion instaladas"
 
     log_info "Versiones de librerias criticas:"
     dpkg -l | grep -E "libssl-dev|libsqlite3-dev|liblzma-dev|libbz2-dev|libffi-dev" | \
-      awk '{print "  " $2 ": " $3}'
+      awk '{print "  " $2 ": " $3}' || log_warn "No se pudieron listar versiones de librerias"
 }
 
 install_additional_tools() {
     log_step 3 3 "Instalando herramientas adicionales"
 
     log_info "Instalando git, vim, htop..."
-    apt-get install -y -qq git vim htop
+    if ! DEBIAN_FRONTEND=noninteractive apt-get install -y -qq git vim htop; then
+        log_error "Fallo al instalar herramientas adicionales"
+        return 1
+    fi
 
     log_success "Herramientas adicionales instaladas"
 }
@@ -114,10 +128,28 @@ verify_installation() {
 setup_directories() {
     log_info "Configurando directorios..."
 
-    mkdir -p "$PROJECT_ROOT/logs"
-    mkdir -p "$PROJECT_ROOT/artifacts/cpython"
+    if ! mkdir -p "$PROJECT_ROOT/logs"; then
+        log_error "Fallo al crear directorio de logs"
+        return 1
+    fi
+
+    if ! mkdir -p "$PROJECT_ROOT/artifacts/cpython"; then
+        log_error "Fallo al crear directorio de artifacts"
+        return 1
+    fi
+
+    # Verificar que directorios son escribibles
+    if [ ! -w "$PROJECT_ROOT/logs" ]; then
+        log_error "Directorio de logs no es escribible"
+        return 1
+    fi
+
+    if [ ! -w "$PROJECT_ROOT/artifacts/cpython" ]; then
+        log_error "Directorio de artifacts no es escribible"
+        return 1
+    fi
 
-    log_success "Directorios configurados"
+    log_success "Directorios configurados y verificados"
 }
 
 display_summary() {

infrastructure/cpython/scripts/build_cpython.sh

@@ -32,14 +32,23 @@ fi
 
 # Validar argumentos
 if [ $# -lt 1 ]; then
-    log_error "Uso: $0 <version> [build-number]"
+    log_error "Uso: $0 <version> [build-number] [--force]"
     log_error "Ejemplo: $0 3.12.6 1"
+    log_error "  --force: Sobrescribir artefacto existente sin preguntar"
     exit 1
 fi
 
 PYTHON_VERSION="$1"
 BUILD_NUMBER="${2:-${DEFAULT_BUILD_NUMBER:-1}}"
 DISTRO="${DISTRO:-ubuntu20.04}"
+FORCE_BUILD=0
+
+# Parsear argumentos opcionales
+for arg in "$@"; do
+    if [ "$arg" = "--force" ]; then
+        FORCE_BUILD=1
+    fi
+done
 
 # Validar formato de version usando utilidad
 if ! validate_python_version "$PYTHON_VERSION"; then
@@ -63,16 +72,17 @@ log_info "Distro: $DISTRO"
 log_info "Artefacto: $ARTIFACT_NAME"
 echo ""
 
-# Verificar que no existe artefacto previo
+# Verificar que no existe artefacto previo (idempotencia)
 if [ -f "$ARTIFACT_PATH" ]; then
-    log_warn "Artefacto ya existe: $ARTIFACT_PATH"
-    read -p "¿Sobrescribir? (y/N): " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        log_info "Abortando compilacion"
-        exit 0
+    if [ $FORCE_BUILD -eq 1 ]; then
+        log_warn "Artefacto ya existe: $ARTIFACT_PATH (sobrescribiendo con --force)"
+        rm -f "$ARTIFACT_PATH" "$ARTIFACT_PATH.sha256"
+    else
+        log_error "Artefacto ya existe: $ARTIFACT_PATH"
+        log_error "Use --force para sobrescribir o elimine el artefacto manualmente"
+        log_error "O incremente el build-number: $0 $PYTHON_VERSION $((BUILD_NUMBER + 1))"
+        exit 1
     fi
-    rm -f "$ARTIFACT_PATH" "$ARTIFACT_PATH.sha256"
 fi
 
 # Crear directorios
@@ -89,23 +99,46 @@ log_info "Descargando codigo fuente de Python $PYTHON_VERSION..."
 cd "$BUILD_DIR"
 
 PYTHON_URL="${PYTHON_DOWNLOAD_BASE:-https://www.python.org/ftp/python}/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz"
+TARBALL="Python-$PYTHON_VERSION.tgz"
 
 if [ -d "$SOURCE_DIR" ]; then
-    log_warn "Directorio de codigo fuente ya existe, usando existente"
-else
+    log_warn "Directorio de codigo fuente ya existe"
+    if [ $FORCE_BUILD -eq 1 ]; then
+        log_warn "Eliminando directorio existente con --force"
+        rm -rf "$SOURCE_DIR" "$TARBALL"
+    else
+        log_info "Usando codigo fuente existente (use --force para re-descargar)"
+    fi
+fi
+
+if [ ! -d "$SOURCE_DIR" ]; then
     log_info "Descargando desde: $PYTHON_URL"
     if ! wget -q --show-progress "$PYTHON_URL"; then
         log_error "Fallo al descargar codigo fuente"
+        log_error "Verifique que la version $PYTHON_VERSION existe en python.org"
+        exit 1
+    fi
+
+    # Verificar que el tarball se descargo correctamente
+    if [ ! -f "$TARBALL" ] || [ ! -s "$TARBALL" ]; then
+        log_error "Tarball descargado esta vacio o no existe"
         exit 1
     fi
 
     log_info "Extrayendo codigo fuente..."
-    tar xzf "Python-$PYTHON_VERSION.tgz"
+    if ! tar xzf "$TARBALL"; then
+        log_error "Fallo al extraer tarball (posible archivo corrupto)"
+        rm -f "$TARBALL"
+        exit 1
+    fi
 
     if [ ! -d "$SOURCE_DIR" ]; then
         log_error "Directorio de codigo fuente no encontrado despues de extraccion"
+        log_error "Estructura inesperada en tarball"
         exit 1
     fi
+
+    log_success "Codigo fuente extraido correctamente"
 fi
 
 cd "$SOURCE_DIR"
@@ -149,6 +182,16 @@ fi
 
 log_success "Compilacion completada"
 
+# Limpiar instalacion anterior si existe (idempotencia)
+if [ -d "$INSTALL_PREFIX" ]; then
+    log_warn "Instalacion previa encontrada en $INSTALL_PREFIX, eliminando..."
+    if ! sudo rm -rf "$INSTALL_PREFIX"; then
+        log_error "Fallo al eliminar instalacion previa (permisos sudo requeridos)"
+        exit 1
+    fi
+    log_success "Instalacion previa eliminada"
+fi
+
 # Instalar
 log_info "Instalando en $INSTALL_PREFIX..."
 if ! sudo make install 2>&1 | tee make-install.log; then
@@ -225,7 +268,10 @@ log_success "Build info guardado en $INSTALL_PREFIX/.build-info"
 # Incluir LICENSE de Python (PSF)
 log_info "Copiando LICENSE de Python..."
 if [ -f "LICENSE" ]; then
-    sudo cp LICENSE "$INSTALL_PREFIX/LICENSE"
+    if ! sudo cp LICENSE "$INSTALL_PREFIX/LICENSE"; then
+        log_error "Fallo al copiar LICENSE (permisos sudo requeridos)"
+        exit 1
+    fi
     log_success "LICENSE copiado"
 else
     log_warn "LICENSE no encontrado en codigo fuente"
@@ -240,8 +286,19 @@ if ! sudo tar czf "$ARTIFACT_PATH" "python-$PYTHON_VERSION"; then
     exit 1
 fi
 
-# Ajustar permisos
-sudo chown vagrant:vagrant "$ARTIFACT_PATH" 2>/dev/null || chown "$(whoami):$(whoami)" "$ARTIFACT_PATH"
+# Ajustar permisos del artefacto
+if ! sudo chown vagrant:vagrant "$ARTIFACT_PATH" 2>/dev/null; then
+    # Fallback si no existe usuario vagrant
+    CURRENT_USER=$(whoami)
+    if ! chown "$CURRENT_USER:$CURRENT_USER" "$ARTIFACT_PATH" 2>/dev/null; then
+        log_warn "No se pudieron ajustar permisos del artefacto (puede requerir sudo)"
+    fi
+fi
+
+if [ ! -r "$ARTIFACT_PATH" ]; then
+    log_error "Artefacto creado pero no es legible"
+    exit 1
+fi
 
 ARTIFACT_SIZE=$(du -h "$ARTIFACT_PATH" | cut -f1)
 log_success "Artefacto creado: $ARTIFACT_PATH ($ARTIFACT_SIZE)"