Function log_port_cleanup

ci/util/port_utils.py:192–220

Log port cleanup operations to debug log file. Args: message: Log message to write log_dir: Optional custom log directory (default: project_root/.logs/debug_attached)

(message: str, log_dir: Path | None = None)

def log_port_cleanup(message: str, log_dir: Path | None = None) -> None:
    """Log port cleanup operations to debug log file.

    Args:
        message: Log message to write
        log_dir: Optional custom log directory (default: project_root/.logs/debug_attached)
    """
    try:
        # Default to project root .logs directory if not specified
        if log_dir is None:
            # Assume this module is in ci/util/, so project root is two levels up
            project_root = Path(__file__).parent.parent.parent
            log_dir = project_root / ".logs" / "debug_attached"

        log_file = log_dir / "port_cleanup.log"

        # Create directory if it doesn't exist
        log_dir.mkdir(parents=True, exist_ok=True)

        # Append log entry with timestamp
        timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
        with open(log_file, "a", encoding="utf-8") as f:
            f.write(f"[{timestamp}] {message}\n")
    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise
    except Exception:
        # Silently ignore logging errors - don't fail the operation
        pass


def kill_port_users(port: str) -> None: