Function cleanup

launch_camoufox.py:214–342

()

# --- Cleanup function (executed on exit) (from dev - more detailed logging and checks) ---
def cleanup():
    global camoufox_proc
    logger.info("--- Starting cleanup routine (launch_camoufox.py) ---")
    if camoufox_proc and camoufox_proc.poll() is None:
        pid = camoufox_proc.pid
        logger.info(f"Terminating Camoufox internal subprocess (PID: {pid})...")
        try:
            if (
                sys.platform != "win32"
                and hasattr(os, "getpgid")
                and hasattr(os, "killpg")
            ):
                try:
                    pgid = os.getpgid(pid)
                    logger.info(
                        f"  Sending SIGTERM to Camoufox process group (PGID: {pgid})..."
                    )
                    os.killpg(pgid, signal.SIGTERM)
                except ProcessLookupError:
                    logger.info(
                        f"  Camoufox process group (PID: {pid}) not found, attempting direct termination..."
                    )
                    camoufox_proc.terminate()
            else:
                if sys.platform == "win32":
                    logger.info(
                        f"🔥 [ID-02] Windows Force-Kill Strategy: Using immediate /F /T for process tree (PID: {pid})"
                    )
                    # [ID-02] Enhanced Windows Force-Kill: Immediate /F /T without grace period
                    result = subprocess.run(
                        ["taskkill", "/F", "/T", "/PID", str(pid)],
                        capture_output=True,
                        text=True,
                        timeout=5,
                    )
                    if result.returncode == 0:
                        logger.info(
                            "  ✅ Successfully force-killed Camoufox process tree via taskkill."
                        )
                    else:
                        logger.warning(
                            f"  ⚠️ Taskkill /F /T returned code {result.returncode}: {result.stderr.strip()}"
                        )
                        # Fallback: try regular terminate
                        camoufox_proc.terminate()
                else:
                    logger.info(f"  Sending SIGTERM to Camoufox (PID: {pid})...")
                    camoufox_proc.terminate()
            camoufox_proc.wait(timeout=5)
            logger.info(
                f"  ✓ Camoufox (PID: {pid}) successfully terminated via SIGTERM."
            )
        except subprocess.TimeoutExpired:
            logger.warning(
                f"  ⚠️ Camoufox (PID: {pid}) SIGTERM timed out. Sending SIGKILL to force terminate..."
            )
            if (
                sys.platform != "win32"