App, lib, cmds: Fix mypy.explicit-override fallout

This commit adds @override decorators to approximately 300 methods
across 76 files that inherit from base classes such as AbstractCmd,
FileContext, ExecContext, Distro, SSHClient, and others.

The decorator ensures the type checker can verify that overridden
methods have compatible signatures and prevents accidental shadowing
of inherited methods without intent.

Files modified include command classes, library modules, distro
implementations, and SSH client implementations.

Assisted-by: unsloth/Qwen3.6-35B-A3B-GGUF:IQ4_NL with pi.dev v
Signed-off-by: Jan Lindemann <jan@janware.com>

src/python/jw/pkg/lib/distros/arch/Distro.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import override, TYPE_CHECKING
 
 from ...Distro import Distro as Base
 
@@ -26,27 +26,32 @@ class Distro(Base):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+    @override
     async def _ref(self) -> None:
         raise NotImplementedError(
             'distro refresh is not yet implemented for Arch-like distributions'
         )
 
+    @override
     async def _dup(self, download_only: bool) -> None:
         args = ['-Su']
         if download_only:
             args.append('-w')
         await self.pacman(args)
 
+    @override
     async def _reboot_required(self, verbose: bool) -> bool:
         raise NotImplementedError(
             'distro reboot-required is not yet implemented for Arch-like distributions'
         )
 
+    @override
     async def _select_by_name(self, names: Iterable[str]) -> Iterable[Package]:
         raise NotImplementedError(
             'distro select is not yet implemented for Arch-like distributions'
         )
 
+    @override
     async def _install(self, names: Iterable[str], only_update: bool) -> None:
         if only_update:
             raise NotImplementedError('--only-update is not yet implemented for pacman')
@@ -54,11 +59,13 @@ class Distro(Base):
         args.extend(names)
         await self.pacman(args)
 
+    @override
     async def _delete(self, names: Iterable[str]) -> None:
         raise NotImplementedError(
             'distro delete not yet implemented for Arch-like distributions'
         )
 
+    @override
     async def _pkg_files(self, name: str) -> Iterable[str]:
         raise NotImplementedError(
             'distro pkg ls yet implemented for Arch-like distributions'

src/python/jw/pkg/lib/distros/debian/Distro.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import os
 
-from typing import TYPE_CHECKING
+from typing import override, TYPE_CHECKING
 
 from ...Distro import Distro as Base
 from ...log import NOTICE, log
@@ -38,9 +38,11 @@ class Distro(Base):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+    @override
     async def _ref(self) -> None:
         await self.apt_get(['update'])
 
+    @override
     async def _dup(self, download_only: bool) -> None:
         args: list[str] = []
         if download_only:
@@ -48,6 +50,7 @@ class Distro(Base):
         args.append('upgrade')
         await self.apt_get(args)
 
+    @override
     async def _reboot_required(self, verbose: bool) -> bool:
         reboot_required = '/run/reboot_required'
         if os.path.exists(reboot_required):
@@ -64,9 +67,11 @@ class Distro(Base):
             log(NOTICE, f"No. {reboot_required} doesn't exist.")
         return False
 
+    @override
     async def _select_by_name(self, names: Iterable[str]) -> Iterable[Package]:
         return await query_packages(names, ec = self.ctx)
 
+    @override
     async def _install(self, names: Iterable[str], only_update: bool) -> None:
         args = ['install']
         if only_update:
@@ -75,8 +80,10 @@ class Distro(Base):
         args.extend(names)
         await self.apt_get(args)
 
+    @override
     async def _delete(self, names: Iterable[str]) -> None:
         await self.dpkg(['-P', *names], sudo = True)
 
+    @override
     async def _pkg_files(self, name: str) -> Iterable[str]:
         return await list_files(name, ec = self.ctx)

src/python/jw/pkg/lib/distros/suse/Distro.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import override, TYPE_CHECKING
 
 from ...Distro import Distro as Base
 from ...pm.rpm import list_files, query_packages, run_rpm
@@ -43,9 +43,11 @@ class Distro(Base):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+    @override
     async def _ref(self) -> None:
         await self.zypper(['refresh'])
 
+    @override
     async def _dup(self, download_only: bool) -> None:
         args = ['dup']
         if download_only:
@@ -53,6 +55,7 @@ class Distro(Base):
         args += self.__update_extra_opts
         await self.zypper(args)
 
+    @override
     async def _reboot_required(self, verbose: bool) -> bool:
         opts = []
         if not verbose:
@@ -64,22 +67,27 @@ class Distro(Base):
             return True
         return False
 
+    @override
     async def _select_by_name(self, names: Iterable[str]) -> Iterable[Package]:
         return await query_packages(names, ec = self.ctx)
 
+    @override
     async def _install(self, names: Iterable[str], only_update: bool) -> None:
         cmd = ['update' if only_update else 'install']
         cmd += self.__update_extra_opts
         cmd += names
         await self.zypper(cmd)
 
+    @override
     async def _install_local_files(
         self, paths: Iterable[str], only_update: bool
     ) -> None:
         await self.rpm(['-U', '--reinstall', *paths])
 
+    @override
     async def _delete(self, names: Iterable[str]) -> None:
         await self.rpm(['-e', *names], sudo = True)
 
+    @override
     async def _pkg_files(self, name: str) -> Iterable[str]:
         return await list_files(name, ec = self.ctx)