clonebox 0.1.23__py3-none-any.whl → 0.1.24__py3-none-any.whl

clonebox/cloner.py

@@ -606,12 +606,76 @@ connect_interfaces() {{
 }}
 
 test_launch() {{
-    case "$1" in
-        pycharm-community) /snap/pycharm-community/current/jbr/bin/java -version &>/dev/null ;;
-        chromium) timeout 10 chromium --headless=new --dump-dom about:blank &>/dev/null ;;
-        firefox) timeout 10 firefox --headless --screenshot /tmp/ff-test.png about:blank &>/dev/null; rm -f /tmp/ff-test.png ;;
-        docker) docker info &>/dev/null ;;
-        *) command -v "$1" &>/dev/null ;;
+    local app="$1"
+    local temp_output="/tmp/$app-test.log"
+    local error_detail="/tmp/$app-error.log"
+    
+    case "$app" in
+        pycharm-community) 
+            if timeout 10 /snap/pycharm-community/current/jbr/bin/java -version &>"$temp_output"; then
+                return 0
+            else
+                echo "PyCharm Java test failed:" >> "$error_detail"
+                cat "$temp_output" >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        chromium) 
+            # First check if chromium can run at all
+            if ! command -v chromium >/dev/null 2>&1; then
+                echo "ERROR: chromium not found in PATH" >> "$error_detail"
+                echo "PATH=$PATH" >> "$error_detail"
+                return 1
+            fi
+            
+            # Try with different approaches
+            if timeout 10 chromium --headless=new --dump-dom about:blank &>"$temp_output" 2>&1; then
+                return 0
+            else
+                echo "Chromium headless test failed:" >> "$error_detail"
+                cat "$temp_output" >> "$error_detail"
+                
+                # Try basic version check
+                echo "Trying chromium --version:" >> "$error_detail"
+                timeout 5 chromium --version >> "$error_detail" 2>&1 || true
+                
+                # Check display
+                echo "Display check:" >> "$error_detail"
+                echo "DISPLAY=${{DISPLAY:-unset}}" >> "$error_detail"
+                echo "XDG_RUNTIME_DIR=${{XDG_RUNTIME_DIR:-unset}}" >> "$error_detail"
+                ls -la /tmp/.X11-unix/ >> "$error_detail" 2>&1 || true
+                
+                return 1
+            fi
+            ;;
+        firefox) 
+            if timeout 10 firefox --headless --screenshot /tmp/ff-test.png about:blank &>/dev/null; then
+                rm -f /tmp/ff-test.png
+                return 0
+            else
+                echo "Firefox headless test failed" >> "$error_detail"
+                timeout 5 firefox --version >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        docker) 
+            if docker info &>/dev/null; then
+                return 0
+            else
+                echo "Docker info failed:" >> "$error_detail"
+                docker info >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        *) 
+            if command -v "$1" &>/dev/null; then
+                return 0
+            else
+                echo "Command not found: $1" >> "$error_detail"
+                echo "PATH=$PATH" >> "$error_detail"
+                return 1
+            fi
+            ;;
     esac
 }}
 
@@ -751,6 +815,11 @@ for app in "${{APPS_TO_TEST[@]}}"; do
         ok "$app launches OK"
     else
         fail "$app launch test FAILED"
+        # Show error details in main log
+        if [ -f "/tmp/$app-error.log" ]; then
+            echo "  Error details:" | tee -a "$LOG"
+            head -10 "/tmp/$app-error.log" | sed 's/^/    /' | tee -a "$LOG" || true
+        fi
     fi
 done
 
@@ -1481,6 +1550,15 @@ esac
         # Enable lingering for the user (allows user services to run without login)
         runcmd_lines.append(f"  - loginctl enable-linger {config.username}")
         
+        # Add environment variables for monitoring
+        runcmd_lines.extend([
+            "  - echo 'CLONEBOX_ENABLE_MONITORING=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_MONITOR_INTERVAL=30' >> /etc/environment",
+            "  - echo 'CLONEBOX_AUTO_REPAIR=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_WATCH_APPS=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_WATCH_SERVICES=true' >> /etc/environment",
+        ])
+        
         # Generate autostart configurations based on installed apps (if enabled)
         autostart_apps = []
         
@@ -1627,7 +1705,69 @@ WantedBy=multi-user.target
             runcmd_lines.append(f"  - systemctl enable {svc_name}.service")
             runcmd_lines.append(f"  - systemctl start {svc_name}.service || true")
         
-        # Create Python monitor service for continuous diagnostics
+        # Install CloneBox Monitor for continuous monitoring and self-healing
+        scripts_dir = Path(__file__).resolve().parent.parent.parent / "scripts"
+        try:
+            with open(scripts_dir / "clonebox-monitor.sh") as f:
+                monitor_script = f.read()
+            with open(scripts_dir / "clonebox-monitor.service") as f:
+                monitor_service = f.read()
+            with open(scripts_dir / "clonebox-monitor.default") as f:
+                monitor_config = f.read()
+        except (FileNotFoundError, OSError):
+            # Fallback to embedded scripts if files not found
+            monitor_script = '''#!/bin/bash
+# CloneBox Monitor - Fallback embedded version
+set -euo pipefail
+LOG_FILE="/var/log/clonebox-monitor.log"
+log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"; }
+log_info() { log "[INFO] $1"; }
+log_warn() { log "[WARN] $1"; }
+log_error() { log "[ERROR] $1"; }
+log_success() { log "[SUCCESS] $1"; }
+while true; do
+    log_info "CloneBox Monitor running..."
+    sleep 60
+done
+'''
+            monitor_service = '''[Unit]
+Description=CloneBox Monitor
+After=graphical-session.target
+[Service]
+Type=simple
+User=ubuntu
+ExecStart=/usr/local/bin/clonebox-monitor
+Restart=always
+[Install]
+WantedBy=default.target
+'''
+            monitor_config = '''# CloneBox Monitor Configuration
+CLONEBOX_MONITOR_INTERVAL=30
+CLONEBOX_AUTO_REPAIR=true
+'''
+        
+        # Install monitor script
+        monitor_b64 = base64.b64encode(monitor_script.encode()).decode()
+        runcmd_lines.append(f"  - echo '{monitor_b64}' | base64 -d > /usr/local/bin/clonebox-monitor")
+        runcmd_lines.append("  - chmod +x /usr/local/bin/clonebox-monitor")
+        
+        # Install monitor configuration
+        config_b64 = base64.b64encode(monitor_config.encode()).decode()
+        runcmd_lines.append(f"  - echo '{config_b64}' | base64 -d > /etc/default/clonebox-monitor")
+        
+        # Install systemd user service
+        service_b64 = base64.b64encode(monitor_service.encode()).decode()
+        runcmd_lines.append(f"  - echo '{service_b64}' | base64 -d > /etc/systemd/user/clonebox-monitor.service")
+        
+        # Enable lingering and start monitor
+        runcmd_lines.extend([
+            "  - loginctl enable-linger ubuntu",
+            "  - sudo -u ubuntu systemctl --user daemon-reload",
+            "  - sudo -u ubuntu systemctl --user enable clonebox-monitor.service",
+            "  - sudo -u ubuntu systemctl --user start clonebox-monitor.service || true",
+        ])
+        
+        # Create Python monitor service for continuous diagnostics (legacy)
         monitor_script = f'''#!/usr/bin/env python3
 """CloneBox Monitor - Continuous diagnostics and app restart service."""
 import subprocess
@@ -1729,28 +1869,22 @@ def main():
 if __name__ == "__main__":
     main()
 '''
-        monitor_b64 = base64.b64encode(monitor_script.encode()).decode()
-        runcmd_lines.append(f"  - echo '{monitor_b64}' | base64 -d > /usr/local/bin/clonebox-monitor")
-        runcmd_lines.append("  - chmod +x /usr/local/bin/clonebox-monitor")
+        # Note: The bash monitor is already installed above, no need to install Python monitor
         
-        # Create systemd service for the Python monitor
-        monitor_service = '''[Unit]
-Description=CloneBox Monitor Service
-After=network.target graphical.target
-
-[Service]
-Type=simple
-ExecStart=/usr/bin/python3 /usr/local/bin/clonebox-monitor
-Restart=always
-RestartSec=30
-
-[Install]
-WantedBy=multi-user.target'''
-        monitor_svc_b64 = base64.b64encode(monitor_service.encode()).decode()
-        runcmd_lines.append(f"  - echo '{monitor_svc_b64}' | base64 -d > /etc/systemd/system/clonebox-monitor.service")
-        runcmd_lines.append("  - systemctl daemon-reload")
-        runcmd_lines.append("  - systemctl enable clonebox-monitor.service")
-        runcmd_lines.append("  - systemctl start clonebox-monitor.service || true")
+        # Create logs disk for host access
+        runcmd_lines.extend([
+            "  - mkdir -p /mnt/logs",
+            "  - truncate -s 1G /var/lib/libvirt/images/clonebox-logs.qcow2",
+            "  - mkfs.ext4 -F /var/lib/libvirt/images/clonebox-logs.qcow2",
+            "  - echo '/var/lib/libvirt/images/clonebox-logs.qcow2 /mnt/logs ext4 loop,defaults 0 0' >> /etc/fstab",
+            "  - mount -a",
+            "  - mkdir -p /mnt/logs/var/log",
+            "  - mkdir -p /mnt/logs/tmp",
+            "  - cp -r /var/log/clonebox*.log /mnt/logs/var/log/ 2>/dev/null || true",
+            "  - cp -r /tmp/*-error.log /mnt/logs/tmp/ 2>/dev/null || true",
+            "  - echo 'Logs disk mounted at /mnt/logs - accessible from host as /var/lib/libvirt/images/clonebox-logs.qcow2'",
+            "  - echo 'To view logs on host: sudo mount -o loop /var/lib/libvirt/images/clonebox-logs.qcow2 /mnt/clonebox-logs'",
+        ])
         
         # Add reboot command at the end if GUI is enabled
         if config.gui:

{clonebox-0.1.23.dist-info → clonebox-0.1.24.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.23
+Version: 0.1.24
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -82,6 +82,9 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - ⚡ **Fast creation** - No full disk cloning, VMs are ready in seconds
 - 📥 **Auto-download** - Automatically downloads and caches Ubuntu cloud images (stored in ~/Downloads)
 - 📊 **Health monitoring** - Built-in health checks for packages, services, and mounts
+- 🔄 **Self-healing** - Automatic monitoring and repair of apps and services
+- 📈 **Live monitoring** - Real-time dashboard for running applications and services
+- 🔧 **Repair tools** - One-click fix for common VM issues (audio, permissions, mounts)
 - 🔄 **VM migration** - Export/import VMs with data between workstations
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
@@ -97,10 +100,12 @@ CloneBox excels in scenarios where developers need:
 ## What's Next
 
 Project roadmap includes:
-- Container runtime integration (Podman/Docker lightweight mode)
-- Local dashboard for VM and container management
-- Profile system for reusable configuration presets
-- Proxmox export capabilities for production migration
+- **v0.2.0**: `clonebox exec` command, VM snapshots, web dashboard MVP
+- **v0.3.0**: Container runtime integration (Podman/Docker), multi-VM orchestration
+- **v0.4.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
+- **v1.0.0**: Production-ready with full monitoring, backup/restore, enterprise features
+
+See [TODO.md](TODO.md) for detailed roadmap and [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
 
 
@@ -112,6 +117,8 @@ Kluczowe komendy:
 - `clonebox` – interaktywny wizard (detect + create + start)
 - `clonebox detect` – skanuje usługi/apps/ścieżki
 - `clonebox clone . --user --run` – szybki klon bieżącego katalogu z użytkownikiem i autostartem
+- `clonebox watch . --user` – monitoruj na żywo aplikacje i usługi w VM
+- `clonebox repair . --user` – napraw problemy z uprawnieniami, audio, usługami
 - `clonebox container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
 - `clonebox dashboard` – lokalny dashboard (VM + containers)
 
@@ -497,6 +504,111 @@ clonebox status . --user --health
 # Or rebuild: clonebox clone . --user --run --replace
 ```
 
+## 📊 Monitoring and Self-Healing
+
+CloneBox includes continuous monitoring and automatic self-healing capabilities for both GUI applications and system services.
+
+### Monitor Running Applications and Services
+
+```bash
+# Watch real-time status of apps and services
+clonebox watch . --user
+
+# Output shows live dashboard:
+# ╔══════════════════════════════════════════════════════════╗
+# ║                   CloneBox Live Monitor                  ║
+# ╠══════════════════════════════════════════════════════════╣
+# ║ 🖥️  GUI Apps:                                              ║
+# ║   ✅ pycharm-community    PID: 1234   Memory: 512MB       ║
+# ║   ✅ firefox             PID: 5678   Memory: 256MB       ║
+# ║   ❌ chromium            Not running                    ║
+# ║                                                          ║
+# ║ 🔧 System Services:                                       ║
+# ║   ✅ docker              Active: 2h 15m                ║
+# ║   ✅ nginx               Active: 1h 30m                ║
+# ║   ✅ uvicorn             Active: 45m (port 8000)       ║
+# ║                                                          ║
+# ║ 📊 Last check: 2024-01-31 13:25:30                       ║
+# ║ 🔄 Next check in: 25 seconds                             ║
+# ╚══════════════════════════════════════════════════════════╝
+
+# Check detailed status with logs
+clonebox status . --user --verbose
+
+# View monitor logs from host
+./scripts/clonebox-logs.sh  # Interactive log viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -f /var/log/clonebox-monitor.log"
+```
+
+### Repair and Troubleshooting
+
+```bash
+# Run automatic repair from host
+clonebox repair . --user
+
+# This triggers the repair script inside VM which:
+# - Fixes directory permissions (pulse, ibus, dconf)
+# - Restarts audio services (PulseAudio/PipeWire)
+# - Reconnects snap interfaces
+# - Remounts missing filesystems
+# - Resets GNOME keyring if needed
+
+# Interactive repair menu (via SSH)
+ssh ubuntu@<IP_VM> "clonebox-repair"
+
+# Manual repair options from host:
+clonebox repair . --user --auto      # Full automatic repair
+clonebox repair . --user --perms     # Fix permissions only
+clonebox repair . --user --audio     # Fix audio only
+clonebox repair . --user --snaps     # Reconnect snaps only
+clonebox repair . --user --mounts    # Remount filesystems only
+
+# Check repair status (via SSH)
+ssh ubuntu@<IP_VM> "cat /var/run/clonebox-status"
+
+# View repair logs
+./scripts/clonebox-logs.sh  # Interactive viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -n 50 /var/log/clonebox-boot.log"
+```
+
+### Monitor Configuration
+
+The monitoring system is configured through environment variables in `.env`:
+
+```bash
+# Enable/disable monitoring
+CLONEBOX_ENABLE_MONITORING=true
+CLONEBOX_MONITOR_INTERVAL=30      # Check every 30 seconds
+CLONEBOX_AUTO_REPAIR=true         # Auto-restart failed services
+CLONEBOX_WATCH_APPS=true          # Monitor GUI apps
+CLONEBOX_WATCH_SERVICES=true      # Monitor system services
+```
+
+### Inside the VM - Manual Controls
+
+```bash
+# Check monitor service status
+systemctl --user status clonebox-monitor
+
+# View monitor logs
+journalctl --user -u clonebox-monitor -f
+tail -f /var/log/clonebox-monitor.log
+
+# Stop/start monitoring
+systemctl --user stop clonebox-monitor
+systemctl --user start clonebox-monitor
+
+# Check last status
+cat /var/run/clonebox-monitor-status
+
+# Run repair manually
+clonebox-repair --all             # Run all fixes
+clonebox-repair --status          # Show current status
+clonebox-repair --logs            # Show recent logs
+```
+
 ### Export/Import Workflow
 
 ```bash
@@ -537,6 +649,11 @@ virt-viewer --connect qemu:///session clone-clonebox
 # Check VM details:
 clonebox list              # List all VMs
 virsh --connect qemu:///session dominfo clone-clonebox
+
+# Restart VM if needed:
+clonebox stop . --user && clonebox start . --user  # Soft reboot
+virsh --connect qemu:///session reboot clone-clonebox  # Direct reboot
+virsh --connect qemu:///session reset clone-clonebox  # Hard reset if frozen
 ```
 
 ## Legacy Examples (Manual Config)

{clonebox-0.1.23.dist-info → clonebox-0.1.24.dist-info}/RECORD

@@ -1,7 +1,7 @@
 clonebox/__init__.py,sha256=CyfHVVq6KqBr4CNERBpXk_O6Q5B35q03YpdQbokVvvI,408
 clonebox/__main__.py,sha256=Fcoyzwwyz5-eC_sBlQk5a5RbKx8uodQz5sKJ190U0NU,135
 clonebox/cli.py,sha256=vbJ65ShdXG1nGkQteCaFtDTas0L2RNV--aay2Qx-6F0,110765
-clonebox/cloner.py,sha256=a9IaIxTb-CaomRGOGkX-0wppYPFmmMRYv3lFxpBit84,73528
+clonebox/cloner.py,sha256=qIcSgG-W28-qBhEVSL8d2gFx2-BI7ygh1Jyh9BjAIBI,79100
 clonebox/container.py,sha256=tiYK1ZB-DhdD6A2FuMA0h_sRNkUI7KfYcJ0tFOcdyeM,6105
 clonebox/dashboard.py,sha256=RhSPvR6kWglqXeLkCWesBZQid7wv2WpJa6w78mXbPjY,4268
 clonebox/detector.py,sha256=aS_QlbG93-DE3hsjRt88E7O-PGC2TUBgUbP9wqT9g60,23221
@@ -9,9 +9,9 @@ clonebox/models.py,sha256=yBRUlJejpeJHZjvCYMGq1nXPFcmhLFxN-LqkEyveWsA,7913
 clonebox/profiles.py,sha256=VaKVuxCrgyMxx-8_WOTcw7E8irwGxUPhZHVY6RxYYiE,2034
 clonebox/validator.py,sha256=z4YuIgVnX6ZqfIdJtjKIFwZ-iWlRUnpX7gmWwq-Jr88,35352
 clonebox/templates/profiles/ml-dev.yaml,sha256=MT7Wu3xGBnYIsO5mzZ2GDI4AAEFGOroIx0eU3XjNARg,140
-clonebox-0.1.23.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-clonebox-0.1.23.dist-info/METADATA,sha256=Yr9EuaWmioFVeAQty15ueglVX6Ae85265PgonQ5DSHs,41627
-clonebox-0.1.23.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clonebox-0.1.23.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
-clonebox-0.1.23.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
-clonebox-0.1.23.dist-info/RECORD,,
+clonebox-0.1.24.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+clonebox-0.1.24.dist-info/METADATA,sha256=ua1S-CkW_inx_jQYxZLCEGvvRW6o3qY6HIZqJsark_U,46452
+clonebox-0.1.24.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clonebox-0.1.24.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
+clonebox-0.1.24.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
+clonebox-0.1.24.dist-info/RECORD,,