redeploy 0.2.29__tar.gz → 0.2.31__tar.gz

{redeploy-0.2.29 → redeploy-0.2.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redeploy
-Version: 0.2.29
+Version: 0.2.31
 Summary: Infrastructure migration toolkit: detect → plan → apply
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -27,17 +27,17 @@ Requires-Dist: pfix>=0.1.60; extra == "dev"
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.29-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.35-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-15.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.31-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.3500 (49 commits)
-- 👤 **Human dev:** ~$1495 (15.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (51 commits)
+- 👤 **Human dev:** ~$1597 (16.0h @ $100/h, 30min dedup)
 
 Generated on 2026-04-21 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.29-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.31-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 Infrastructure migration and device deploy toolkit — VPS, Raspberry Pi kiosk, Podman Quadlet, k3s.
 

{redeploy-0.2.29 → redeploy-0.2.31}/README.md

@@ -3,17 +3,17 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.29-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.35-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-15.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.31-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.3500 (49 commits)
-- 👤 **Human dev:** ~$1495 (15.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (51 commits)
+- 👤 **Human dev:** ~$1597 (16.0h @ $100/h, 30min dedup)
 
 Generated on 2026-04-21 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.29-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.31-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 Infrastructure migration and device deploy toolkit — VPS, Raspberry Pi kiosk, Podman Quadlet, k3s.
 

{redeploy-0.2.29 → redeploy-0.2.31}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "redeploy"
-version = "0.2.29"
+version = "0.2.31"
 description = "Infrastructure migration toolkit: detect → plan → apply"
 readme = "README.md"
 requires-python = ">=3.11"

{redeploy-0.2.29 → redeploy-0.2.31}/redeploy/__init__.py

@@ -7,7 +7,7 @@ Public API (stable from 0.2.0, semver guaranteed)::
 
 Everything not listed in ``__all__`` is internal and may change without notice.
 """
-__version__ = "0.2.29"
+__version__ = "0.2.31"
 
 # ── Core models ───────────────────────────────────────────────────────────────
 from .models import (  # noqa: F401

{redeploy-0.2.29 → redeploy-0.2.31}/redeploy/cli/commands/devices.py

@@ -13,9 +13,10 @@ from rich.table import Table
 @click.command()
 @click.option("--tag", default=None, help="Filter by tag")
 @click.option("--strategy", default=None, help="Filter by strategy")
+@click.option("--rpi", is_flag=True, help="Show only Raspberry Pi devices")
 @click.option("--reachable", is_flag=True, help="Show only recently-seen devices")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def devices(tag, strategy, reachable, as_json):
+def devices(tag, strategy, rpi, reachable, as_json):
     """List known devices from ~/.config/redeploy/devices.yaml.
 
     \b
@@ -35,6 +36,8 @@ def devices(tag, strategy, reachable, as_json):
         devs = [d for d in devs if tag in d.tags]
     if strategy:
         devs = [d for d in devs if d.strategy == strategy]
+    if rpi:
+        devs = [d for d in devs if "raspberry-pi" in d.tags]
     if reachable:
         devs = [d for d in devs if d.is_reachable]
 
@@ -64,12 +67,16 @@ def devices(tag, strategy, reachable, as_json):
     for d in devs:
         seen = d.last_seen.strftime("%m-%d %H:%M") if d.last_seen else "never"
         ssh = "[green]✓[/green]" if d.last_ssh_ok else "[red]✗[/red]"
+        tags_str = ",".join(d.tags) or "—"
+        # Highlight raspberry-pi tag
+        if "raspberry-pi" in d.tags:
+            tags_str = tags_str.replace("raspberry-pi", "[bold magenta]raspberry-pi[/bold magenta]")
         t.add_row(
             d.id,
             d.host,
             d.strategy,
             d.app or "—",
-            ",".join(d.tags) or "—",
+            tags_str,
             seen,
             ssh,
         )
@@ -130,17 +137,20 @@ def scan(subnet, ssh_users, ssh_port, ping, no_mdns, timeout, no_save):
     )
 
     ssh_ok = [h for h in found if h.ssh_ok]
-    console.print(f"  found {len(found)} host(s), {len(ssh_ok)} SSH-accessible\n")
+    rpi_count = sum(1 for h in found if h.is_raspberry_pi)
+    console.print(f"  found {len(found)} host(s), {len(ssh_ok)} SSH-accessible, {rpi_count} Raspberry Pi\n")
 
     t = Table(show_header=True, box=None, padding=(0, 2))
     t.add_column("IP")
     t.add_column("Hostname", style="dim")
     t.add_column("MAC", style="dim")
     t.add_column("SSH user", style="cyan")
+    t.add_column("RPi", style="bold magenta")
     t.add_column("Source", style="dim")
     for h in found:
         ssh_col = f"[green]{h.ssh_user}[/green]" if h.ssh_ok else "[red]✗[/red]"
-        t.add_row(h.ip, h.hostname or "—", h.mac or "—", ssh_col, h.source)
+        rpi_col = "🍓" if h.is_raspberry_pi else "—"
+        t.add_row(h.ip, h.hostname or "—", h.mac or "—", ssh_col, rpi_col, h.source)
     console.print(t)
 
     if not no_save and ssh_ok:

{redeploy-0.2.29 → redeploy-0.2.31}/redeploy/discovery.py

@@ -38,6 +38,24 @@ class DiscoveredHost:
     ssh_user: str = ""
     source: str = "unknown"
     ports_open: list[int] = field(default_factory=list)
+    is_raspberry_pi: bool = False
+
+
+# ── Raspberry Pi identification ─────────────────────────────────────────────────
+
+_RPI_MAC_PREFIXES = [
+    "b8:27:eb",  # Raspberry Pi Foundation
+    "dc:a6:32",  # Raspberry Pi Trading
+    "e4:5f:01",  # Raspberry Pi Trading
+    "28:cd:c1",  # Raspberry Pi 5
+]
+
+def _is_raspberry_pi_mac(mac: str) -> bool:
+    """Check if MAC address belongs to Raspberry Pi."""
+    if not mac:
+        return False
+    mac_prefix = mac[:8].lower()
+    return mac_prefix in _RPI_MAC_PREFIXES
 
 
 # ── Individual scanners ───────────────────────────────────────────────────────
@@ -89,7 +107,12 @@ def _scan_arp_cache() -> list[DiscoveredHost]:
             parts = line.split()
             if len(parts) >= 5 and re.match(r"\d+\.\d+\.\d+\.\d+", parts[0]):
                 mac = parts[4] if len(parts) > 4 else ""
-                results.append(DiscoveredHost(ip=parts[0], mac=mac, source="arp"))
+                results.append(DiscoveredHost(
+                    ip=parts[0], 
+                    mac=mac, 
+                    source="arp",
+                    is_raspberry_pi=_is_raspberry_pi_mac(mac)
+                ))
         if results:
             logger.debug(f"arp (ip neigh): {len(results)} hosts")
             return results
@@ -101,7 +124,13 @@ def _scan_arp_cache() -> list[DiscoveredHost]:
             # ? (192.168.1.1) at aa:bb:cc:dd:ee:ff [ether] on eth0
             m = re.search(r"\((\d+\.\d+\.\d+\.\d+)\).*?([0-9a-f]{2}:[0-9a-f]{2}:[0-9a-f:]+)", line, re.I)
             if m:
-                results.append(DiscoveredHost(ip=m.group(1), mac=m.group(2), source="arp"))
+                mac = m.group(2)
+                results.append(DiscoveredHost(
+                    ip=m.group(1), 
+                    mac=mac, 
+                    source="arp",
+                    is_raspberry_pi=_is_raspberry_pi_mac(mac)
+                ))
     logger.debug(f"arp: {len(results)} hosts")
     return results
 
@@ -250,6 +279,8 @@ def _merge(hosts: list[DiscoveredHost]) -> list[DiscoveredHost]:
                 existing.ssh_user = existing.ssh_user or h.ssh_user
             if existing.source == "unknown":
                 existing.source = h.source
+            if h.is_raspberry_pi:
+                existing.is_raspberry_pi = True
         else:
             by_ip[h.ip] = h
     return list(by_ip.values())
@@ -302,6 +333,11 @@ def discover(
 
     found = _merge(found)
 
+    # Log Raspberry Pi devices
+    rpi_devices = [h for h in found if h.is_raspberry_pi]
+    if rpi_devices:
+        logger.info(f"Found {len(rpi_devices)} Raspberry Pi device(s): {', '.join(h.ip for h in rpi_devices)}")
+
     # SSH probe
     if probe_ssh and found:
         logger.info(f"SSH probe: {len(found)} hosts ({timeout}s timeout each)")
@@ -339,9 +375,14 @@ def update_registry(
                 existing.hostname = h.hostname
             if h.ssh_ok:
                 existing.last_ssh_ok = now
+            if h.is_raspberry_pi and "raspberry-pi" not in existing.tags:
+                existing.tags.append("raspberry-pi")
             reg.upsert(existing)
         elif h.ssh_ok:
             # Only auto-add SSH-accessible devices
+            tags = ["discovered"]
+            if h.is_raspberry_pi:
+                tags.append("raspberry-pi")
             reg.upsert(KnownDevice(
                 id=device_id,
                 host=device_id,
@@ -352,7 +393,7 @@ def update_registry(
                 last_seen=now,
                 last_ssh_ok=now,
                 source=h.source,
-                tags=["discovered"],
+                tags=tags,
             ))
 
     if save:

redeploy-0.2.31/redeploy/plugins/builtin/hardware_diagnostic.py

@@ -0,0 +1,282 @@
+"""Hardware diagnostic plugin for redeploy.
+
+Analyzes system hardware and provides configuration recommendations.
+Supports Raspberry Pi variants and desktop platforms.
+
+Usage in deployment.yaml:
+    extra_steps:
+      - id: analyze_hardware
+        action: plugin
+        plugin_type: hardware_diagnostic
+        plugin_params:
+          checks: ["platform", "cpu", "memory", "storage", "gpio", "usb", "audio"]
+          platform: "auto"  # or "rpi3", "rpi4", "rpi5", "desktop"
+          verbose: true
+"""
+from __future__ import annotations
+
+import os
+import subprocess
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional
+
+from loguru import logger
+
+from redeploy.plugins import PluginContext, register_plugin
+
+
+@dataclass
+class HardwareInfo:
+    """Hardware diagnostic information."""
+    platform: str
+    cpu_model: str
+    cpu_cores: int
+    memory_mb: int
+    storage_gb: float
+    gpio_available: bool
+    usb_devices: List[str]
+    audio_devices: List[str]
+    network_interfaces: List[str]
+    issues: List[str]
+    recommendations: List[str]
+
+
+def _run_command(cmd: str) -> str:
+    """Run shell command and return output."""
+    try:
+        result = subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=10)
+        return result.stdout.strip()
+    except Exception as e:
+        logger.debug(f"Command failed: {cmd} - {e}")
+        return ""
+
+
+def _detect_platform() -> str:
+    """Detect the platform type."""
+    # Check for Raspberry Pi
+    model_file = "/proc/device-tree/model"
+    if os.path.exists(model_file):
+        try:
+            with open(model_file, "r") as f:
+                model = f.read().strip("\x00")
+                if "Raspberry Pi 5" in model:
+                    return "rpi5"
+                elif "Raspberry Pi 4" in model:
+                    return "rpi4"
+                elif "Raspberry Pi 3" in model:
+                    return "rpi3"
+        except Exception:
+            pass
+
+    # Check CPU info
+    cpuinfo = _run_command("cat /proc/cpuinfo")
+    if "Raspberry Pi" in cpuinfo or "BCM" in cpuinfo:
+        return "rpi_unknown"
+
+    # Check architecture
+    arch = _run_command("uname -m")
+    if arch == "aarch64":
+        return "arm64_unknown"
+    elif arch == "x86_64":
+        return "desktop"
+
+    return "unknown"
+
+
+def _get_cpu_info() -> tuple[str, int]:
+    """Get CPU model and core count."""
+    cpuinfo = _run_command("cat /proc/cpuinfo")
+    model = "unknown"
+    cores = 0
+
+    for line in cpuinfo.split("\n"):
+        if line.startswith("model name"):
+            model = line.split(":", 1)[1].strip()
+        elif line.startswith("Hardware"):
+            model = line.split(":", 1)[1].strip()
+        elif line.startswith("processor"):
+            cores += 1
+
+    return model, max(cores, 1)
+
+
+def _get_memory_mb() -> int:
+    """Get total memory in MB."""
+    meminfo = _run_command("cat /proc/meminfo")
+    for line in meminfo.split("\n"):
+        if line.startswith("MemTotal"):
+            kb = int(line.split()[1])
+            return kb // 1024
+    return 0
+
+
+def _get_storage_gb() -> float:
+    """Get available storage in GB."""
+    output = _run_command("df -h /")
+    if output:
+        lines = output.split("\n")
+        if len(lines) > 1:
+            parts = lines[1].split()
+            if len(parts) > 3:
+                available = parts[3]
+                if available.endswith("G"):
+                    return float(available.rstrip("G"))
+                elif available.endswith("M"):
+                    return float(available.rstrip("M")) / 1024
+    return 0.0
+
+
+def _check_gpio() -> bool:
+    """Check if GPIO is available."""
+    # Check for GPIO character device
+    return os.path.exists("/dev/gpiochip0") or os.path.exists("/dev/gpiomem")
+
+
+def _get_usb_devices() -> List[str]:
+    """Get list of USB devices."""
+    output = _run_command("lsusb")
+    devices = []
+    for line in output.split("\n"):
+        if line:
+            parts = line.split(" ", 6)
+            if len(parts) > 6:
+                devices.append(parts[6])
+    return devices
+
+
+def _get_audio_devices() -> List[str]:
+    """Get list of audio devices."""
+    output = _run_command("aplay -l")
+    devices = []
+    for line in output.split("\n"):
+        if line.startswith("card"):
+            devices.append(line.strip())
+    return devices
+
+
+def _get_network_interfaces() -> List[str]:
+    """Get list of network interfaces."""
+    output = _run_command("ip -o link show")
+    interfaces = []
+    for line in output.split("\n"):
+        if line:
+            parts = line.split(":")
+            if len(parts) > 1:
+                iface = parts[1].strip()
+                if iface != "lo":
+                    interfaces.append(iface)
+    return interfaces
+
+
+def _analyze_hardware(platform: str, verbose: bool = False) -> HardwareInfo:
+    """Perform comprehensive hardware analysis."""
+    platform = platform if platform != "auto" else _detect_platform()
+    cpu_model, cpu_cores = _get_cpu_info()
+    memory_mb = _get_memory_mb()
+    storage_gb = _get_storage_gb()
+    gpio_available = _check_gpio()
+    usb_devices = _get_usb_devices()
+    audio_devices = _get_audio_devices()
+    network_interfaces = _get_network_interfaces()
+
+    issues = []
+    recommendations = []
+
+    # Platform-specific checks
+    if platform.startswith("rpi"):
+        if memory_mb < 1024:
+            issues.append(f"Low memory: {memory_mb}MB (recommended: >= 2GB for RPi)")
+            recommendations.append("Consider upgrading to RPi4/5 with 2GB+ RAM")
+        if storage_gb < 5:
+            issues.append(f"Low storage: {storage_gb}GB (recommended: >= 8GB)")
+            recommendations.append("Free up disk space or use larger SD card")
+
+        if platform == "rpi5":
+            if not gpio_available:
+                issues.append("GPIO not available on RPi5")
+                recommendations.append("Check kernel configuration for GPIO support")
+        elif platform in ["rpi3", "rpi4"]:
+            if not gpio_available:
+                issues.append("GPIO not available")
+                recommendations.append("Enable GPIO in config.txt or check permissions")
+
+    elif platform == "desktop":
+        if memory_mb < 4096:
+            issues.append(f"Low memory: {memory_mb}MB (recommended: >= 4GB for desktop)")
+            recommendations.append("Consider upgrading RAM for better performance")
+
+    # General checks
+    if not network_interfaces:
+        issues.append("No network interfaces detected")
+        recommendations.append("Check network configuration")
+
+    if verbose:
+        logger.info(f"Platform: {platform}")
+        logger.info(f"CPU: {cpu_model} ({cpu_cores} cores)")
+        logger.info(f"Memory: {memory_mb}MB")
+        logger.info(f"Storage: {storage_gb}GB available")
+        logger.info(f"GPIO: {'Available' if gpio_available else 'Not available'}")
+        logger.info(f"USB devices: {len(usb_devices)}")
+        logger.info(f"Audio devices: {len(audio_devices)}")
+        logger.info(f"Network interfaces: {network_interfaces}")
+
+    return HardwareInfo(
+        platform=platform,
+        cpu_model=cpu_model,
+        cpu_cores=cpu_cores,
+        memory_mb=memory_mb,
+        storage_gb=storage_gb,
+        gpio_available=gpio_available,
+        usb_devices=usb_devices,
+        audio_devices=audio_devices,
+        network_interfaces=network_interfaces,
+        issues=issues,
+        recommendations=recommendations,
+    )
+
+
+@register_plugin("hardware_diagnostic")
+def hardware_diagnostic(ctx: PluginContext) -> None:
+    """Perform hardware diagnostics and provide recommendations."""
+    checks = ctx.params.get("checks", ["platform", "cpu", "memory", "storage"])
+    platform = ctx.params.get("platform", "auto")
+    verbose = ctx.params.get("verbose", True)
+    dry_run = ctx.dry_run
+
+    if dry_run:
+        logger.info("[DRY RUN] Would analyze hardware")
+        ctx.step.status = "done"
+        ctx.step.result = "dry_run"
+        return
+
+    logger.info("Starting hardware diagnostic...")
+
+    hw_info = _analyze_hardware(platform, verbose)
+
+    # Build result message
+    result_parts = []
+    result_parts.append(f"Platform: {hw_info.platform}")
+    result_parts.append(f"CPU: {hw_info.cpu_model} ({hw_info.cpu_cores} cores)")
+    result_parts.append(f"Memory: {hw_info.memory_mb}MB")
+    result_parts.append(f"Storage: {hw_info.storage_gb}GB")
+    result_parts.append(f"GPIO: {'OK' if hw_info.gpio_available else 'N/A'}")
+
+    if hw_info.issues:
+        result_parts.append(f"Issues: {len(hw_info.issues)}")
+        for issue in hw_info.issues:
+            logger.warning(f"  - {issue}")
+
+    if hw_info.recommendations:
+        result_parts.append(f"Recommendations: {len(hw_info.recommendations)}")
+        for rec in hw_info.recommendations:
+            logger.info(f"  - {rec}")
+
+    ctx.step.result = "; ".join(result_parts)
+    ctx.step.description = f"Hardware diagnostic: {hw_info.platform}, {hw_info.memory_mb}MB RAM"
+
+    if hw_info.issues:
+        ctx.step.status = "done"  # Still done, but with warnings
+        logger.warning(f"Hardware diagnostic completed with {len(hw_info.issues)} issues")
+    else:
+        ctx.step.status = "done"
+        logger.info("Hardware diagnostic completed successfully")

redeploy-0.2.31/redeploy/plugins/builtin/process_control.py

@@ -0,0 +1,123 @@
+"""Process control plugin for redeploy.
+
+Automatically kills processes on specified ports before deployment.
+Supports port ranges, process name filtering, and graceful vs force kill.
+
+Usage in deployment.yaml:
+    extra_steps:
+      - id: kill_processes_on_ports
+        action: plugin
+        plugin_type: process_control
+        plugin_params:
+          ports: [8100, 8101, 8202]
+          strategy: graceful  # or 'force'
+          timeout: 10
+          notify: true
+"""
+from __future__ import annotations
+
+import socket
+import time
+from typing import Optional
+
+from loguru import logger
+
+from redeploy.models import ConflictSeverity, MigrationStep
+from redeploy.plugins import PluginContext, register_plugin
+
+
+def _find_pid_on_port(port: int) -> Optional[int]:
+    """Find PID of process listening on port (Linux only)."""
+    try:
+        with open("/proc/net/tcp", "r") as f:
+            for line in f:
+                parts = line.strip().split()
+                if len(parts) >= 10:
+                    # Format: local_addr rem_addr st tx_queue rx_queue ...
+                    # local_addr format: hex_ip:hex_port
+                    local_addr = parts[1].split(":")[-1]
+                    hex_port = int(local_addr, 16)
+                    if hex_port == port:
+                        inode = parts[9]
+                        # Find PID by inode in /proc/*/fd
+                        import os
+                        for pid_dir in os.listdir("/proc"):
+                            if pid_dir.isdigit():
+                                fd_dir = f"/proc/{pid_dir}/fd"
+                                if os.path.exists(fd_dir):
+                                    for fd in os.listdir(fd_dir):
+                                        try:
+                                            link = os.readlink(os.path.join(fd_dir, fd))
+                                            if f"socket:[{inode}]" in link:
+                                                return int(pid_dir)
+                                        except (OSError, ValueError):
+                                            continue
+    except Exception as e:
+        logger.debug(f"Could not find PID on port {port}: {e}")
+    return None
+
+
+def _kill_process(pid: int, force: bool = False) -> bool:
+    """Kill a process by PID. Returns True if successful."""
+    try:
+        import os
+        import signal
+        sig = signal.SIGKILL if force else signal.SIGTERM
+        os.kill(pid, sig)
+        return True
+    except ProcessLookupError:
+        return False
+    except PermissionError:
+        logger.warning(f"Permission denied to kill PID {pid}")
+        return False
+
+
+@register_plugin("process_control")
+def process_control(ctx: PluginContext) -> None:
+    """Kill processes on specified ports."""
+    ports = ctx.params.get("ports", [])
+    strategy = ctx.params.get("strategy", "graceful")
+    timeout = ctx.params.get("timeout", 10)
+    notify = ctx.params.get("notify", True)
+    dry_run = ctx.dry_run
+
+    if not ports:
+        logger.warning("process_control: no ports specified")
+        ctx.step.status = "done"
+        ctx.step.result = "no_ports"
+        return
+
+    if dry_run:
+        logger.info(f"[DRY RUN] Would kill processes on ports: {ports}")
+        ctx.step.status = "done"
+        ctx.step.result = "dry_run"
+        return
+
+    killed = []
+    for port in ports:
+        pid = _find_pid_on_port(port)
+        if pid:
+            logger.info(f"Found process PID {pid} on port {port}")
+            if strategy == "graceful":
+                _kill_process(pid, force=False)
+                # Wait for graceful shutdown
+                time.sleep(2)
+                # Check if still running
+                if _find_pid_on_port(port) == pid:
+                    logger.warning(f"Process {pid} on port {port} did not stop gracefully, force killing")
+                    _kill_process(pid, force=True)
+            else:
+                _kill_process(pid, force=True)
+            killed.append((port, pid))
+        else:
+            logger.debug(f"No process found on port {port}")
+
+    if killed:
+        ctx.step.result = f"killed:{len(killed)}_processes"
+        if notify:
+            ctx.step.description = f"Killed {len(killed)} process(es) on ports {ports}"
+    else:
+        ctx.step.result = "no_processes_to_kill"
+        ctx.step.description = f"No processes found on ports {ports}"
+
+    ctx.step.status = "done"