redeploy 0.2.57__tar.gz → 0.2.59__tar.gz

{redeploy-0.2.57 → redeploy-0.2.59}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redeploy
-Version: 0.2.57
+Version: 0.2.59
 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.57-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-28.9h-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.59-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-29.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (77 commits)
-- 👤 **Human dev:** ~$2886 (28.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (79 commits)
+- 👤 **Human dev:** ~$2897 (29.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.57-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.59-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.57 → redeploy-0.2.59}/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.57-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-28.9h-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.59-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-29.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (77 commits)
-- 👤 **Human dev:** ~$2886 (28.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (79 commits)
+- 👤 **Human dev:** ~$2897 (29.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.57-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.59-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.57 → redeploy-0.2.59}/pyproject.toml

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

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

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/cli/commands/device_map_renderers.py

@@ -147,7 +147,7 @@ def render_rich(console: Console, dm: "DeviceMap") -> None:
         ]
         rt_str = "  ".join(r for r in runtimes if r) or "—"
         console.print(
-            f"\n[bold]Infra[/bold]  strategy=[cyan]{infra.detected_strategy.value}[/cyan]"
+            f"\n[bold]Infra[/bold]  strategy=[cyan]{infra.detected_strategy}[/cyan]"
             f"  version={infra.current_version or '?'}  {rt_str}"
         )
 

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/cli/commands/plan_apply.py

@@ -186,7 +186,7 @@ def migrate(ctx, host, app, domain, target, strategy, target_version,
     state = d.run()
     d.save(state, Path(infra_out))
     console.print(
-        f"  Strategy: {state.detected_strategy.value}  "
+        f"  Strategy: {state.detected_strategy}  "
         f"  Version: {state.current_version or '?'}  "
         f"  Conflicts: {len(state.conflicts)}"
     )
@@ -412,7 +412,7 @@ def _perform_live_detect(console, spec):
     )
     state = d.run()
     console.print(
-        f"  detected: {state.detected_strategy.value}  "
+        f"  detected: {state.detected_strategy}  "
         f"version={state.current_version or '?'}  "
         f"conflicts={len(state.conflicts)}"
     )

redeploy-0.2.59/redeploy/cli/commands/version/utils/__init__.py

@@ -0,0 +1,8 @@
+"""Shared version-command utilities."""
+from .git_config import resolve_package_release_git_config
+from .changelog_config import resolve_package_release_changelog_config
+
+__all__ = [
+    "resolve_package_release_git_config",
+    "resolve_package_release_changelog_config",
+]

redeploy-0.2.59/redeploy/cli/commands/version/utils/changelog_config.py

@@ -0,0 +1,27 @@
+"""Resolve changelog config for a package release."""
+from __future__ import annotations
+
+from typing import Any
+
+
+def resolve_package_release_changelog_config(
+    manifest_model: Any,
+    package_name: str | None,
+    *,
+    allow_root_fallback: bool,
+) -> Any:
+    """Return the changelog config for *package_name* with optional root fallback."""
+    if not package_name:
+        return manifest_model.changelog
+
+    package_manifest = manifest_model.get_package(package_name)
+    if package_manifest is None:
+        raise ValueError(f"Package '{package_name}' not found in manifest")
+
+    if package_manifest.changelog is not None:
+        return package_manifest.changelog
+
+    if allow_root_fallback:
+        return manifest_model.changelog
+
+    return None

redeploy-0.2.59/redeploy/cli/commands/version/utils/git_config.py

@@ -0,0 +1,27 @@
+"""Resolve git-config for a package release."""
+from __future__ import annotations
+
+from typing import Any
+
+
+def resolve_package_release_git_config(
+    manifest_model: Any,
+    package_name: str | None,
+    *,
+    allow_root_fallback: bool,
+) -> Any:
+    """Return the git config for *package_name* with optional root fallback."""
+    if not package_name:
+        return manifest_model.git
+
+    package_manifest = manifest_model.get_package(package_name)
+    if package_manifest is None:
+        raise ValueError(f"Package '{package_name}' not found in manifest")
+
+    if package_manifest.git is not None:
+        return package_manifest.git
+
+    if allow_root_fallback:
+        return manifest_model.git
+
+    return None

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/cli/core.py

@@ -126,7 +126,7 @@ def run_detect_for_spec(
     d = Detector(host=spec.source.host, app=spec.source.app, domain=spec.source.domain)
     state = d.run()
     console.print(
-        f"  detected: {state.detected_strategy.value}  "
+        f"  detected: {state.detected_strategy}  "
         f"version={state.current_version or '?'}  "
         f"conflicts={len(state.conflicts)}"
     )

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/cli/display.py

@@ -36,7 +36,7 @@ def print_infrastructure_summary(console: "Console", state, host: str) -> None:
     t.add_column("key", style="dim")
     t.add_column("value")
     t.add_row("App", state.app)
-    t.add_row("Strategy (detected)", state.detected_strategy.value)
+    t.add_row("Strategy (detected)", state.detected_strategy)
     t.add_row("Version", state.current_version or "unknown")
     t.add_row("Docker", state.runtime.docker or "—")
     t.add_row("k3s", state.runtime.k3s or "—")

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/detect/workflow.py

@@ -398,7 +398,7 @@ class DetectionWorkflow:
                 host_res = self._deep_detect(host_res)
                 if host_res.state:
                     logger.info(
-                        f"[workflow]   strategy={host_res.state.detected_strategy.value}  "
+                        f"[workflow]   strategy={host_res.state.detected_strategy}  "
                         f"ports={sorted(host_res.state.ports.keys())}  "
                         f"conflicts={len(host_res.state.conflicts)}"
                     )

{redeploy-0.2.57 → redeploy-0.2.59}/redeploy/iac/docker_compose.py

@@ -399,6 +399,40 @@ class DockerComposeParser:
     def _parse_service_command(self, cfg: dict) -> Optional[str]:
         return str(cfg["command"]) if cfg.get("command") else None
 
+    def _build_service_info(
+        self,
+        *,
+        name: str,
+        cfg: dict,
+        image: Optional[str],
+        ports: list[PortInfo],
+        volumes: list[VolumeInfo],
+        env: dict[str, str],
+        env_files: list[str],
+        svc_networks: list[str],
+        depends_on: list[str],
+        healthcheck: Optional[str],
+        build_context: Optional[str],
+        replicas: int,
+        labels: dict[str, str],
+    ) -> ServiceInfo:
+        return ServiceInfo(
+            name=name,
+            image=image,
+            ports=ports,
+            volumes=volumes,
+            env=env,
+            env_files=env_files,
+            networks=svc_networks,
+            depends_on=depends_on,
+            healthcheck=healthcheck,
+            restart=cfg.get("restart"),
+            command=self._parse_service_command(cfg),
+            build_context=build_context,
+            replicas=replicas,
+            labels=labels,
+        )
+
     def _parse_service(self, name: str, cfg: dict,
                        env_context: dict[str, str],
                        spec: ParsedSpec) -> ServiceInfo:
@@ -413,18 +447,17 @@ class DockerComposeParser:
         replicas = self._parse_service_replicas(cfg)
         labels = self._parse_service_labels(cfg)
 
-        return ServiceInfo(
+        return self._build_service_info(
             name=name,
+            cfg=cfg,
             image=image,
             ports=ports,
             volumes=volumes,
             env=env,
             env_files=env_files,
-            networks=svc_networks,
+            svc_networks=svc_networks,
             depends_on=depends_on,
             healthcheck=healthcheck,
-            restart=cfg.get("restart"),
-            command=self._parse_service_command(cfg),
             build_context=build_context,
             replicas=replicas,
             labels=labels,

redeploy-0.2.59/redeploy/models/__init__.py

@@ -0,0 +1,121 @@
+"""redeploy.models — shared data models (backward-compat re-export hub).
+
+This package was refactored from the monolithic ``redeploy.models`` module
+(R3, 0.2.53).  All public names remain importable from the top-level
+package for backward compatibility.
+"""
+from __future__ import annotations
+
+# ── core ─────────────────────────────────────────────────────────────────────
+from .enums import (
+    ConflictSeverity,
+    DeployStrategy,
+    StepAction,
+    StepStatus,
+    _STRATEGY_ALIASES,
+)
+from .persisted import PersistedModel
+
+# ── hardware ─────────────────────────────────────────────────────────────────
+from .hardware import (
+    BacklightInfo,
+    DrmOutput,
+    HardwareDiagnostic,
+    HardwareInfo,
+    I2CBusInfo,
+)
+
+# ── infra state ─────────────────────────────────────────────────────────────
+from .infra import (
+    AppHealthInfo,
+    ConflictInfo,
+    InfraState,
+    PortInfo,
+    RuntimeInfo,
+    ServiceInfo,
+)
+
+# ── pipeline ─────────────────────────────────────────────────────────────────
+from .pipeline import Hook, PipelinePhase
+
+# ── spec & target ───────────────────────────────────────────────────────────
+from .spec import (
+    InfraSpec,
+    MigrationSpec,
+    TargetConfig,
+    _migrate_legacy_post_deploy,
+)
+
+# ── plan ─────────────────────────────────────────────────────────────────────
+from .plan import MigrationPlan, MigrationStep
+
+# ── manifest ─────────────────────────────────────────────────────────────────
+from .manifest import EnvironmentConfig, ProjectManifest
+
+# ── blueprint ────────────────────────────────────────────────────────────────
+from .blueprint import (
+    BlueprintSource,
+    DeviceBlueprint,
+    HardwareRequirements,
+    ServicePort,
+    ServiceSpec,
+    VolumeMount,
+)
+
+# ── device registry / map ───────────────────────────────────────────────────
+from .devices import (
+    DeployRecord,
+    DeviceMap,
+    DeviceRegistry,
+    KnownDevice,
+)
+
+__all__ = [
+    # enums
+    "ConflictSeverity",
+    "DeployStrategy",
+    "StepAction",
+    "StepStatus",
+    "_STRATEGY_ALIASES",
+    # persisted
+    "PersistedModel",
+    # hardware
+    "BacklightInfo",
+    "DrmOutput",
+    "HardwareDiagnostic",
+    "HardwareInfo",
+    "I2CBusInfo",
+    # infra
+    "AppHealthInfo",
+    "ConflictInfo",
+    "InfraState",
+    "PortInfo",
+    "RuntimeInfo",
+    "ServiceInfo",
+    # pipeline
+    "Hook",
+    "PipelinePhase",
+    # spec
+    "InfraSpec",
+    "MigrationSpec",
+    "TargetConfig",
+    "_migrate_legacy_post_deploy",
+    # plan
+    "MigrationPlan",
+    "MigrationStep",
+    # manifest
+    "EnvironmentConfig",
+    "ProjectManifest",
+    # blueprint
+    "BlueprintSource",
+    "DeviceBlueprint",
+    "HardwareRequirements",
+    "ServicePort",
+    "ServiceSpec",
+    "VolumeMount",
+    # devices
+    "DeployRecord",
+    "DeviceMap",
+    "DeviceRegistry",
+    "KnownDevice",
+]

redeploy-0.2.59/redeploy/models/blueprint.py

@@ -0,0 +1,95 @@
+"""Device blueprint models — portable deployment recipes."""
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+from .hardware import HardwareInfo
+from .persisted import PersistedModel
+
+
+_DEFAULT_BLUEPRINT_DIR = Path.home() / ".config" / "redeploy" / "blueprints"
+
+
+class ServicePort(BaseModel):
+    host: int
+    container: int
+    protocol: str = "tcp"
+
+
+class VolumeMount(BaseModel):
+    host: str
+    container: str
+    read_only: bool = False
+
+
+class ServiceSpec(BaseModel):
+    name: str
+    image: str
+    platform: str = ""
+    ports: list[ServicePort] = Field(default_factory=list)
+    volumes: list[VolumeMount] = Field(default_factory=list)
+    env: dict[str, str] = Field(default_factory=dict)
+    command: Optional[str] = None
+    healthcheck: Optional[str] = None
+    depends_on: list[str] = Field(default_factory=list)
+    labels: dict[str, str] = Field(default_factory=dict)
+    restart: str = "unless-stopped"
+    network_mode: Optional[str] = None
+    privileged: bool = False
+    source_ref: Optional[str] = None
+
+
+class HardwareRequirements(BaseModel):
+    arch: str = "linux/arm64"
+    min_ram_mb: int = 0
+    min_disk_gb: int = 0
+    display_type: Optional[str] = None
+    display_resolution: Optional[str] = None
+    i2c_required: bool = False
+    gpio_required: bool = False
+    features: list[str] = Field(default_factory=list)
+
+
+class BlueprintSource(BaseModel):
+    device_id: Optional[str] = None
+    device_name: Optional[str] = None
+    migration_file: Optional[str] = None
+    markpact_files: list[str] = Field(default_factory=list)
+    compose_files: list[str] = Field(default_factory=list)
+    extracted_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+
+
+class DeviceBlueprint(PersistedModel):
+    """Self-contained, portable deployment recipe."""
+    name: str
+    version: str = "0.0.0"
+    description: str = ""
+    tags: list[str] = Field(default_factory=list)
+    created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+
+    services: list[ServiceSpec] = Field(default_factory=list)
+    hardware: HardwareRequirements = Field(default_factory=HardwareRequirements)
+    app_url: Optional[str] = None
+    deploy_strategy: str = "podman_quadlet"
+    env_file: Optional[str] = None
+    notes: str = ""
+    source: BlueprintSource = Field(default_factory=BlueprintSource)
+
+    def service(self, name: str) -> Optional[ServiceSpec]:
+        return next((s for s in self.services if s.name == name), None)
+
+    def save(self, path: Optional[Path] = None) -> Path:
+        p = path or _DEFAULT_BLUEPRINT_DIR / f"{self.name}.blueprint.yaml"
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(self.to_yaml())
+        return p
+
+    @classmethod
+    def list_saved(cls) -> list[Path]:
+        if not _DEFAULT_BLUEPRINT_DIR.exists():
+            return []
+        return sorted(_DEFAULT_BLUEPRINT_DIR.glob("*.blueprint.yaml"))

redeploy-0.2.59/redeploy/models/devices.py

@@ -0,0 +1,170 @@
+"""Device registry and device-map models."""
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+import yaml
+from pydantic import BaseModel, Field, PrivateAttr
+
+from .hardware import HardwareInfo
+from .infra import InfraState
+from .persisted import PersistedModel
+
+
+_DEFAULT_DEVICE_MAP_DIR = Path.home() / ".config" / "redeploy" / "device-maps"
+
+
+class DeployRecord(BaseModel):
+    """Single deployment event recorded for a device."""
+    timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+    spec_name: str = ""
+    from_strategy: str = ""
+    to_strategy: str = ""
+    version: str = ""
+    ok: bool = True
+    steps_total: int = 0
+    steps_ok: int = 0
+    note: str = ""
+
+
+class KnownDevice(BaseModel):
+    """Device known to redeploy — persisted in ~/.config/redeploy/devices.yaml."""
+    id: str
+    host: str = ""
+    name: str = ""
+    tags: list[str] = Field(default_factory=list)
+    strategy: str = "docker_full"
+    app: str = ""
+    domain: str = ""
+    remote_dir: str = ""
+    ssh_port: int = 22
+    ssh_key: Optional[str] = None
+
+    ip: str = ""
+    mac: str = ""
+    hostname: str = ""
+    ssh_user: str = ""
+    last_seen: Optional[datetime] = None
+    last_ssh_ok: Optional[datetime] = None
+    source: str = "manual"
+
+    hardware: Optional[HardwareInfo] = None
+    deploys: list[DeployRecord] = Field(default_factory=list)
+
+    @property
+    def last_deploy(self) -> Optional[DeployRecord]:
+        return self.deploys[-1] if self.deploys else None
+
+    @property
+    def is_reachable(self) -> bool:
+        if self.last_seen is None:
+            return False
+        return (datetime.now(timezone.utc) - self.last_seen).total_seconds() < 300
+
+    def record_deploy(self, record: DeployRecord) -> None:
+        self.deploys.append(record)
+        self.deploys = self.deploys[-50:]
+
+
+class DeviceMap(PersistedModel):
+    """Full, persisted snapshot of a device: identity + InfraState + HardwareInfo."""
+    id: str
+    host: str = ""
+    name: str = ""
+    tags: list[str] = Field(default_factory=list)
+    scanned_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+
+    hardware: Optional[HardwareInfo] = None
+    infra: Optional[InfraState] = None
+    issues: list[dict] = Field(default_factory=list)
+
+    @property
+    def has_errors(self) -> bool:
+        return any(i.get("severity") in ("error", "critical") for i in self.issues)
+
+    @property
+    def display_summary(self) -> str:
+        if not self.hardware:
+            return "no hardware data"
+        hw = self.hardware
+        dsi = next((o for o in hw.drm_outputs if "DSI" in o.name), None)
+        if dsi:
+            mode = dsi.modes[0] if dsi.modes else "?"
+            bl = hw.backlights[0].brightness if hw.backlights else "?"
+            return f"DSI {dsi.connector} {dsi.status} {mode} backlight={bl}"
+        return "no DSI"
+
+    def save(self, path: Optional[Path] = None) -> Path:
+        p = path or _DEFAULT_DEVICE_MAP_DIR / f"{self.id.replace('/', '_').replace('@', '_at_')}.yaml"
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(self.to_yaml())
+        return p
+
+    @classmethod
+    def load_for(cls, device_id: str) -> Optional[DeviceMap]:
+        p = _DEFAULT_DEVICE_MAP_DIR / f"{device_id.replace('/', '_').replace('@', '_at_')}.yaml"
+        if p.exists():
+            return cls.load(p)
+        return None
+
+    @classmethod
+    def list_saved(cls) -> list[Path]:
+        if not _DEFAULT_DEVICE_MAP_DIR.exists():
+            return []
+        return sorted(_DEFAULT_DEVICE_MAP_DIR.glob("*.yaml"))
+
+
+class DeviceRegistry(BaseModel):
+    """Persistent device registry — stored at ~/.config/redeploy/devices.yaml."""
+    devices: list[KnownDevice] = Field(default_factory=list)
+    _path: Optional[Path] = PrivateAttr(default=None)
+
+    def get(self, device_id: str) -> Optional[KnownDevice]:
+        return next((d for d in self.devices if d.id == device_id), None)
+
+    def upsert(self, device: KnownDevice) -> None:
+        for i, d in enumerate(self.devices):
+            if d.id == device.id:
+                self.devices[i] = device
+                return
+        self.devices.append(device)
+
+    def remove(self, device_id: str) -> bool:
+        before = len(self.devices)
+        self.devices = [d for d in self.devices if d.id != device_id]
+        return len(self.devices) < before
+
+    def by_tag(self, tag: str) -> list[KnownDevice]:
+        return [d for d in self.devices if tag in d.tags]
+
+    def by_strategy(self, strategy: str) -> list[KnownDevice]:
+        return [d for d in self.devices if d.strategy == strategy]
+
+    def reachable(self) -> list[KnownDevice]:
+        return [d for d in self.devices if d.is_reachable]
+
+    @classmethod
+    def default_path(cls) -> Path:
+        return Path.home() / ".config" / "redeploy" / "devices.yaml"
+
+    @classmethod
+    def load(cls, path: Optional[Path] = None) -> DeviceRegistry:
+        p = path or cls.default_path()
+        if not p.exists():
+            return cls()
+        raw = yaml.safe_load(p.read_text()) or {}
+        devices = [KnownDevice(**d) for d in raw.get("devices", [])]
+        reg = cls(devices=devices)
+        reg._path = p
+        return reg
+
+    def save(self, path: Optional[Path] = None) -> None:
+        p = path or self._path or self.default_path()
+        p.parent.mkdir(parents=True, exist_ok=True)
+        data = {"devices": [d.model_dump(mode="json") for d in self.devices]}
+        tmp = p.with_suffix(".tmp")
+        tmp.write_text(yaml.dump(data, allow_unicode=True, sort_keys=False))
+        tmp.chmod(0o600)
+        tmp.replace(p)