redeploy 0.2.67__tar.gz → 0.2.69__tar.gz

{redeploy-0.2.67 → redeploy-0.2.69}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redeploy
-Version: 0.2.67
+Version: 0.2.69
 Summary: Infrastructure migration toolkit: detect → plan → apply
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -32,17 +32,17 @@ Requires-Dist: mcp>=1.0; extra == "mcp"
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.67-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-34.2h-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.69-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-36.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (88 commits)
-- 👤 **Human dev:** ~$3416 (34.2h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (90 commits)
+- 👤 **Human dev:** ~$3606 (36.1h @ $100/h, 30min dedup)
 
 Generated on 2026-04-23 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.67-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.69-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.67 → redeploy-0.2.69}/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.67-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-34.2h-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.69-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-36.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (88 commits)
-- 👤 **Human dev:** ~$3416 (34.2h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (90 commits)
+- 👤 **Human dev:** ~$3606 (36.1h @ $100/h, 30min dedup)
 
 Generated on 2026-04-23 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.67-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.69-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.67 → redeploy-0.2.69}/pyproject.toml

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

{redeploy-0.2.67 → redeploy-0.2.69}/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.67"
+__version__ = "0.2.69"
 
 # ── Core models ───────────────────────────────────────────────────────────────
 from .models import (  # noqa: F401

{redeploy-0.2.67 → redeploy-0.2.69}/redeploy/cli/commands/blueprint.py

@@ -212,6 +212,12 @@ def show(blueprint_file, fmt, apply_config, query_expr):
     from ...models import DeviceBlueprint
 
     bp = DeviceBlueprint.load(Path(blueprint_file))
+
+    # --query: extract specific values with JMESPath
+    if query_expr is not None:
+        _execute_query_blueprint(bp, query_expr, fmt)
+        return
+
     if fmt == "json":
         import json as _json
         click.echo(_json.dumps(bp.model_dump(mode="json"), indent=2))

{redeploy-0.2.67 → redeploy-0.2.69}/redeploy/cli/commands/prompt_cmd.py

@@ -121,6 +121,8 @@ def _call_llm(schema: dict, user_prompt: str) -> str:
 
 def _parse_llm_response(raw: str) -> dict:
     """Parse JSON from LLM response, strip accidental fences and escape control characters."""
+    import re
+
     # Strip ```json ... ``` if present
     clean = raw.strip()
     if clean.startswith("```"):
@@ -129,18 +131,92 @@ def _parse_llm_response(raw: str) -> dict:
             line for line in lines
             if not line.strip().startswith("```")
         )
+
+    # Extract innermost balanced {...} if extra text surrounds it
+    def _extract_json(text: str) -> str:
+        start = text.find("{")
+        if start == -1:
+            return text
+        depth = 0
+        for i, ch in enumerate(text[start:], start):
+            if ch == "{":
+                depth += 1
+            elif ch == "}":
+                depth -= 1
+                if depth == 0:
+                    return text[start : i + 1]
+        return text
+
+    clean = _extract_json(clean)
+
     # Escape control characters (except \n, \r, \t) for JSON safety
     def escape_control_char(match):
         char = match.group(0)
-        # Keep allowed whitespace, escape others as \uXXXX
         if char in "\n\r\t":
             return char
         return f"\\u{ord(char):04x}"
-    
-    # Match any control character (ord < 32) except \n, \r, \t
-    import re
+
     clean = re.sub(r"[\x00-\x08\x0b\x0c\x0e-\x1f]", escape_control_char, clean)
-    return json.loads(clean)
+
+    # Try strict parse first
+    try:
+        return json.loads(clean)
+    except json.JSONDecodeError:
+        pass
+
+    # Fallback: try ujson (more lenient with some LLM quirks) if available
+    try:
+        import ujson
+        return ujson.loads(clean)
+    except Exception:
+        pass
+
+    # Repair trailing commas before ] or }
+    repaired = re.sub(r",(\s*[}\]])", r"\1", clean)
+    try:
+        return json.loads(repaired)
+    except json.JSONDecodeError:
+        pass
+
+    # Repair raw newlines inside string values by escaping them
+    def _escape_newlines_in_strings(text: str) -> str:
+        result = []
+        in_string = False
+        escape = False
+        for ch in text:
+            if escape:
+                result.append(ch)
+                escape = False
+                continue
+            if ch == "\\":
+                result.append(ch)
+                escape = True
+                continue
+            if ch == '"' and not in_string:
+                in_string = True
+                result.append(ch)
+                continue
+            if ch == '"' and in_string:
+                in_string = False
+                result.append(ch)
+                continue
+            if ch == "\n" and in_string:
+                result.append("\\n")
+                continue
+            if ch == "\r" and in_string:
+                result.append("\\r")
+                continue
+            result.append(ch)
+        return "".join(result)
+
+    repaired = _escape_newlines_in_strings(clean)
+    try:
+        return json.loads(repaired)
+    except json.JSONDecodeError:
+        pass
+
+    # Last resort: raise original error with cleaned text for debugging
+    raise json.JSONDecodeError("Failed to parse LLM JSON after all repairs", clean, 0)
 
 
 # ---------------------------------------------------------------------------

{redeploy-0.2.67 → redeploy-0.2.69}/redeploy/steps/__init__.py

@@ -19,11 +19,32 @@ from typing import Any, Optional
 
 from ..models import MigrationStep
 
-from . import builtins, kiosk
+from . import (
+    docker,
+    generic,
+    hardware,
+    k3s,
+    kiosk,
+    podman,
+    process,
+    scm,
+    transfer,
+)
 
 # Merge domain modules into a single flat registry.
+_ALL_MODULES = (
+    docker.ALL
+    + generic.ALL
+    + hardware.ALL
+    + k3s.ALL
+    + kiosk.ALL
+    + podman.ALL
+    + process.ALL
+    + scm.ALL
+    + transfer.ALL
+)
 _LIBRARY: dict[str, MigrationStep] = {
-    s.id: s for s in (builtins.ALL + kiosk.ALL)
+    s.id: s for s in _ALL_MODULES
 }
 
 

redeploy-0.2.69/redeploy/steps/docker.py

@@ -0,0 +1,40 @@
+"""Docker container runtime domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+DOCKER_PRUNE = _step(
+    id="docker_prune",
+    action=StepAction.SSH_CMD,
+    description="Prune unused Docker images and build cache",
+    command="docker image prune -f && docker builder prune -f",
+    risk=ConflictSeverity.LOW,
+)
+
+DOCKER_COMPOSE_DOWN = _step(
+    id="docker_compose_down",
+    action=StepAction.DOCKER_COMPOSE_DOWN,
+    description="Stop Docker Compose stack",
+    command="docker compose down",
+    risk=ConflictSeverity.MEDIUM,
+    rollback_command="docker compose up -d",
+)
+
+RESTART_TRAEFIK = _step(
+    id="restart_traefik",
+    action=StepAction.SSH_CMD,
+    description="Restart Traefik container",
+    command="docker restart $(docker ps -q --filter name=traefik) 2>/dev/null || true",
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    DOCKER_PRUNE,
+    DOCKER_COMPOSE_DOWN,
+    RESTART_TRAEFIK,
+]

redeploy-0.2.69/redeploy/steps/generic.py

@@ -0,0 +1,87 @@
+"""Generic / cross-domain utility steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+# ── waits ─────────────────────────────────────────────────────────────────────
+
+WAIT_30 = _step(
+    id="wait_startup",
+    action=StepAction.WAIT,
+    description="Wait 30 s for services to start",
+    seconds=30,
+    risk=ConflictSeverity.LOW,
+)
+
+WAIT_60 = _step(
+    id="wait_startup_long",
+    action=StepAction.WAIT,
+    description="Wait 60 s for services to start (slow build)",
+    seconds=60,
+    risk=ConflictSeverity.LOW,
+)
+
+# ── verify ────────────────────────────────────────────────────────────────────
+
+HTTP_HEALTH_CHECK = _step(
+    id="http_health_check",
+    action=StepAction.HTTP_CHECK,
+    description="Verify backend health endpoint",
+    url=None,   # must be set by caller
+    expect="healthy",
+    risk=ConflictSeverity.LOW,
+)
+
+VERSION_CHECK = _step(
+    id="version_check",
+    action=StepAction.VERSION_CHECK,
+    description="Verify deployed version",
+    url=None,   # must be set by caller
+    expect=None,
+    risk=ConflictSeverity.LOW,
+)
+
+# ── systemd generic ───────────────────────────────────────────────────────────
+
+SYSTEMCTL_RESTART = _step(
+    id="systemctl_restart",
+    action=StepAction.SYSTEMCTL_START,
+    description="Restart a systemd service (set command= to override)",
+    command="systemctl restart {service}",
+    risk=ConflictSeverity.LOW,
+)
+
+SYSTEMCTL_DAEMON_RELOAD = _step(
+    id="systemctl_daemon_reload",
+    action=StepAction.SSH_CMD,
+    description="Reload systemd daemon",
+    command="systemctl daemon-reload",
+    risk=ConflictSeverity.LOW,
+)
+
+# ── nginx ─────────────────────────────────────────────────────────────────────
+
+STOP_NGINX = _step(
+    id="stop_nginx",
+    action=StepAction.SYSTEMCTL_STOP,
+    service="nginx",
+    description="Stop host nginx (conflicts on port 80)",
+    command="systemctl stop nginx && systemctl disable nginx",
+    risk=ConflictSeverity.MEDIUM,
+    rollback_command="systemctl start nginx",
+)
+
+ALL: list[MigrationStep] = [
+    WAIT_30,
+    WAIT_60,
+    HTTP_HEALTH_CHECK,
+    VERSION_CHECK,
+    SYSTEMCTL_RESTART,
+    SYSTEMCTL_DAEMON_RELOAD,
+    STOP_NGINX,
+]

redeploy-0.2.69/redeploy/steps/hardware.py

@@ -0,0 +1,22 @@
+"""Hardware diagnostic domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+HARDWARE_DIAGNOSTIC = _step(
+    id="hardware_diagnostic",
+    action=StepAction.PLUGIN,
+    plugin_type="hardware_diagnostic",
+    description="Analyze system hardware and provide configuration recommendations",
+    plugin_params={"checks": ["platform", "cpu", "memory", "storage"], "platform": "auto", "verbose": True},
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    HARDWARE_DIAGNOSTIC,
+]

redeploy-0.2.69/redeploy/steps/k3s.py

@@ -0,0 +1,58 @@
+"""k3s / Kubernetes domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+FLUSH_K3S_IPTABLES = _step(
+    id="flush_k3s_iptables",
+    action=StepAction.SSH_CMD,
+    description="Flush k3s CNI-HOSTPORT-DNAT + KUBE-* chains (stale rules block Docker-proxy on 80/443)",
+    command=(
+        "iptables -t nat -F CNI-HOSTPORT-DNAT 2>/dev/null || true && "
+        "iptables -t nat -F CNI-HOSTPORT-MASQ 2>/dev/null || true && "
+        "iptables -t nat -F KUBE-SERVICES 2>/dev/null || true && "
+        "iptables -t nat -F KUBE-NODEPORTS 2>/dev/null || true && "
+        "iptables -t filter -F KUBE-FORWARD 2>/dev/null || true && "
+        "echo iptables-flushed"
+    ),
+    risk=ConflictSeverity.LOW,
+)
+
+DELETE_K3S_INGRESSES = _step(
+    id="delete_k3s_ingresses",
+    action=StepAction.KUBECTL_DELETE,
+    description="Delete k3s ingresses to remove iptables DNAT rules",
+    command="k3s kubectl delete ingress --all-namespaces --all 2>/dev/null || true",
+    risk=ConflictSeverity.LOW,
+)
+
+STOP_K3S = _step(
+    id="stop_k3s",
+    action=StepAction.SYSTEMCTL_STOP,
+    service="k3s",
+    description="Stop k3s to free ports 80/443",
+    command="systemctl stop k3s",
+    risk=ConflictSeverity.MEDIUM,
+    rollback_command="systemctl start k3s",
+)
+
+DISABLE_K3S = _step(
+    id="disable_k3s",
+    action=StepAction.SYSTEMCTL_DISABLE,
+    service="k3s",
+    description="Disable k3s on boot",
+    command="systemctl disable k3s",
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    FLUSH_K3S_IPTABLES,
+    DELETE_K3S_INGRESSES,
+    STOP_K3S,
+    DISABLE_K3S,
+]

redeploy-0.2.69/redeploy/steps/podman.py

@@ -0,0 +1,41 @@
+"""Podman / Quadlet domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+PODMAN_DAEMON_RELOAD = _step(
+    id="podman_daemon_reload",
+    action=StepAction.SYSTEMCTL_START,
+    description="Reload systemd to pick up Quadlet unit files",
+    command="systemctl --user daemon-reload",
+    risk=ConflictSeverity.LOW,
+)
+
+STOP_PODMAN = _step(
+    id="stop_podman",
+    action=StepAction.SYSTEMCTL_STOP,
+    service="podman",
+    description="Stop all Podman containers via systemd",
+    command="systemctl stop podman.service 2>/dev/null || podman stop --all 2>/dev/null || true",
+    risk=ConflictSeverity.MEDIUM,
+    rollback_command="systemctl start podman.service 2>/dev/null || true",
+)
+
+ENABLE_PODMAN_UNIT = _step(
+    id="enable_podman_unit",
+    action=StepAction.SYSTEMCTL_START,
+    description="Enable and start a Podman Quadlet unit (set service= to override)",
+    command="systemctl daemon-reload && systemctl enable --now {service}.service",
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    PODMAN_DAEMON_RELOAD,
+    STOP_PODMAN,
+    ENABLE_PODMAN_UNIT,
+]

redeploy-0.2.69/redeploy/steps/process.py

@@ -0,0 +1,32 @@
+"""Process-control domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+KILL_PROCESSES_ON_PORTS = _step(
+    id="kill_processes_on_ports",
+    action=StepAction.PLUGIN,
+    plugin_type="process_control",
+    description="Kill processes on specified ports (auto-detects PIDs)",
+    plugin_params={"ports": [], "strategy": "graceful", "timeout": 10, "notify": True},
+    risk=ConflictSeverity.LOW,
+)
+
+KILL_DEV_PROCESSES = _step(
+    id="kill_dev_processes",
+    action=StepAction.PLUGIN,
+    plugin_type="process_control",
+    description="Kill common dev server processes (vite, uvicorn, python)",
+    plugin_params={"ports": [8100, 8101, 8202, 3000, 5173], "strategy": "graceful", "timeout": 5, "notify": True},
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    KILL_PROCESSES_ON_PORTS,
+    KILL_DEV_PROCESSES,
+]

redeploy-0.2.69/redeploy/steps/scm.py

@@ -0,0 +1,22 @@
+"""Source-control management domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+GIT_PULL = _step(
+    id="git_pull",
+    action=StepAction.SSH_CMD,
+    description="Pull latest code from git (cd to remote_dir first)",
+    command="git -C ~/app pull --ff-only",
+    risk=ConflictSeverity.LOW,
+    rollback_command="git -C ~/app reset --hard HEAD@{1}",
+)
+
+ALL: list[MigrationStep] = [
+    GIT_PULL,
+]

redeploy-0.2.69/redeploy/steps/transfer.py

@@ -0,0 +1,22 @@
+"""File-transfer domain steps."""
+from __future__ import annotations
+
+from ..models import ConflictSeverity, MigrationStep, StepAction
+
+
+def _step(id: str, action: StepAction, description: str, **kw) -> MigrationStep:
+    return MigrationStep(id=id, action=action, description=description, **kw)
+
+
+SYNC_ENV = _step(
+    id="sync_env",
+    action=StepAction.SCP,
+    description="Copy .env file to remote",
+    src=None,   # caller sets src/dst
+    dst=None,
+    risk=ConflictSeverity.LOW,
+)
+
+ALL: list[MigrationStep] = [
+    SYNC_ENV,
+]

redeploy-0.2.69/redeploy/tests/test_steps_registry.py

@@ -0,0 +1,109 @@
+"""Tests that every domain module in redeploy.steps is correctly wired into StepLibrary."""
+from __future__ import annotations
+
+import pytest
+
+from redeploy.models import MigrationStep
+from redeploy.steps import StepLibrary
+from redeploy.steps import (
+    docker,
+    generic,
+    hardware,
+    k3s,
+    kiosk,
+    podman,
+    process,
+    scm,
+    transfer,
+)
+
+
+ALL_MODULES = [
+    docker,
+    generic,
+    hardware,
+    k3s,
+    kiosk,
+    podman,
+    process,
+    scm,
+    transfer,
+]
+
+
+class TestNoDuplicateIds:
+    def test_no_duplicate_ids_within_each_module(self):
+        for mod in ALL_MODULES:
+            ids = [s.id for s in mod.ALL]
+            assert len(ids) == len(set(ids)), f"duplicate ids in {mod.__name__}: {ids}"
+
+    def test_no_duplicate_ids_across_all_modules(self):
+        all_ids = []
+        for mod in ALL_MODULES:
+            all_ids.extend(s.id for s in mod.ALL)
+        assert len(all_ids) == len(set(all_ids)), f"duplicate ids across modules: {all_ids}"
+
+
+class TestAllStepsReachableViaLibrary:
+    @pytest.mark.parametrize(
+        "module",
+        ALL_MODULES,
+        ids=lambda m: m.__name__.split(".")[-1],
+    )
+    def test_every_step_in_library(self, module):
+        for step in module.ALL:
+            found = StepLibrary.get(step.id)
+            assert found is not None, f"{step.id} missing from StepLibrary"
+            assert isinstance(found, MigrationStep)
+
+
+class TestLibraryGetReturnsCopy:
+    def test_mutating_copy_does_not_affect_template(self):
+        s1 = StepLibrary.get("http_health_check")
+        s2 = StepLibrary.get("http_health_check")
+        assert s1 is not s2
+        s1.url = "https://modified.example.com"
+        assert s2.url != s1.url
+
+
+class TestKnownStepsExist:
+    def test_k3s_steps(self):
+        for sid in ("flush_k3s_iptables", "delete_k3s_ingresses", "stop_k3s", "disable_k3s"):
+            assert StepLibrary.get(sid) is not None
+
+    def test_docker_steps(self):
+        for sid in ("docker_prune", "docker_compose_down", "restart_traefik"):
+            assert StepLibrary.get(sid) is not None
+
+    def test_podman_steps(self):
+        for sid in ("podman_daemon_reload", "stop_podman", "enable_podman_unit"):
+            assert StepLibrary.get(sid) is not None
+
+    def test_generic_steps(self):
+        for sid in (
+            "wait_startup",
+            "wait_startup_long",
+            "http_health_check",
+            "version_check",
+            "systemctl_restart",
+            "systemctl_daemon_reload",
+            "stop_nginx",
+        ):
+            assert StepLibrary.get(sid) is not None
+
+    def test_scm_steps(self):
+        assert StepLibrary.get("git_pull") is not None
+
+    def test_transfer_steps(self):
+        assert StepLibrary.get("sync_env") is not None
+
+    def test_process_steps(self):
+        for sid in ("kill_processes_on_ports", "kill_dev_processes"):
+            assert StepLibrary.get(sid) is not None
+
+    def test_hardware_steps(self):
+        assert StepLibrary.get("hardware_diagnostic") is not None
+
+    def test_kiosk_steps(self):
+        for sid in ("kanshi_dsi_only", "autostart_kiosk", "browser_kiosk_script"):
+            assert StepLibrary.get(sid) is not None