Function windows_descendants

scripts/run-test-wave.py:126–156

True if any live process still claims `pid` as its parent. Used only when the suite leader has already exited: `taskkill /T` cannot walk a tree from a dead PID, so cleanup is proven by asking whether anything is still parented to it. One level deep on purpose -- Windows does not rep

(pid: int, timeout: int)

def windows_descendants(pid: int, timeout: int) -> bool:
    """True if any live process still claims `pid` as its parent.

    Used only when the suite leader has already exited: `taskkill /T` cannot
    walk a tree from a dead PID, so cleanup is proven by asking whether anything
    is still parented to it. One level deep on purpose -- Windows does not
    reparent orphans, so a grandchild keeps pointing at its own (dead) parent
    and would not be found here. That is a weaker proof than taskkill /T, which
    is why it is reserved for the case where the strong proof is impossible.
    """
    try:
        completed = subprocess.run(
            [
                "powershell.exe",
                "-NoProfile",
                "-NonInteractive",
                "-Command",
                "@(Get-CimInstance Win32_Process -Filter "
                f"'ParentProcessId={pid}').Count",
            ],
            check=False,
            stdin=subprocess.DEVNULL,
            capture_output=True,
            text=True,
            timeout=timeout,
        )
    except (OSError, subprocess.TimeoutExpired):
        return True  # cannot prove absence -> assume the worst
    if completed.returncode != 0:
        return True
    return (completed.stdout or "").strip() not in ("0", "")


def terminate_process_tree(active: ActiveSuite, kill_grace: int) -> None: