redeploy 0.2.1__tar.gz → 0.2.4__tar.gz

{redeploy-0.2.1 → redeploy-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redeploy
-Version: 0.2.1
+Version: 0.2.4
 Summary: Infrastructure migration toolkit: detect → plan → apply
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -26,17 +26,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.1-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-$2.40-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-4.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.4-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-$3.30-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-5.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $2.4000 (16 commits)
-- 👤 **Human dev:** ~$420 (4.2h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.3000 (22 commits)
+- 👤 **Human dev:** ~$533 (5.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-20 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.1-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.4-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.
 
@@ -350,7 +350,57 @@ extra_steps:
     insert_before: docker_build_pull   # runs before build, not after verify
 ```
 
-## `redeploy.yaml` project manifest
+## Plugin system
+
+Extend the step pipeline with custom action types using `action: plugin`:
+
+```yaml
+extra_steps:
+  - id: reload_kiosk
+    action: plugin
+    plugin_type: browser_reload
+    description: Reload kiosk browser after deploy
+    plugin_params:
+      port: 9222
+      ignore_cache: true
+      url_contains: "localhost:8100"
+```
+
+### Built-in plugins
+
+| `plugin_type` | Description | `plugin_params` |
+|---------------|-------------|-----------------|
+| `browser_reload` | Reload Chromium via CDP (Chrome DevTools Protocol) over SSH | `port` (9222), `ignore_cache` (true), `url_contains` ("") |
+
+### Writing a custom plugin
+
+Place a `.py` file in `./redeploy_plugins/` (project-local) or `~/.redeploy/plugins/` (user-global):
+
+```python
+# ./redeploy_plugins/notify.py
+from redeploy.plugins import register_plugin, PluginContext
+from redeploy.models import StepStatus
+
+@register_plugin("notify_slack")
+def notify_slack(ctx: PluginContext) -> None:
+    webhook = ctx.params["webhook"]
+    ctx.probe.run(f"curl -X POST {webhook} -d '{{\"text\":\"deployed!\"}}'")
+    ctx.step.result = "notified"
+    ctx.step.status = StepStatus.DONE
+```
+
+`PluginContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `step` | `MigrationStep` | Current step — set `result` and `status` here |
+| `host` | `str` | SSH host (e.g. `pi@192.168.1.5`) |
+| `probe` | `RemoteProbe` | Call `probe.run(cmd)` for remote SSH commands |
+| `emitter` | `ProgressEmitter?` | Emit mid-step progress: `emitter.progress(step.id, msg)` |
+| `params` | `dict` | Shortcut for `step.plugin_params` |
+| `dry_run` | `bool` | Skip side-effects if True |
+
+
 
 Place in project root — `redeploy run` (no args) uses it automatically.
 Supports **named environments** for multi-target projects:

{redeploy-0.2.1 → redeploy-0.2.4}/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.1-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-$2.40-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-4.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.4-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-$3.30-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-5.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $2.4000 (16 commits)
-- 👤 **Human dev:** ~$420 (4.2h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.3000 (22 commits)
+- 👤 **Human dev:** ~$533 (5.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-20 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.1-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.4-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.
 
@@ -327,7 +327,57 @@ extra_steps:
     insert_before: docker_build_pull   # runs before build, not after verify
 ```
 
-## `redeploy.yaml` project manifest
+## Plugin system
+
+Extend the step pipeline with custom action types using `action: plugin`:
+
+```yaml
+extra_steps:
+  - id: reload_kiosk
+    action: plugin
+    plugin_type: browser_reload
+    description: Reload kiosk browser after deploy
+    plugin_params:
+      port: 9222
+      ignore_cache: true
+      url_contains: "localhost:8100"
+```
+
+### Built-in plugins
+
+| `plugin_type` | Description | `plugin_params` |
+|---------------|-------------|-----------------|
+| `browser_reload` | Reload Chromium via CDP (Chrome DevTools Protocol) over SSH | `port` (9222), `ignore_cache` (true), `url_contains` ("") |
+
+### Writing a custom plugin
+
+Place a `.py` file in `./redeploy_plugins/` (project-local) or `~/.redeploy/plugins/` (user-global):
+
+```python
+# ./redeploy_plugins/notify.py
+from redeploy.plugins import register_plugin, PluginContext
+from redeploy.models import StepStatus
+
+@register_plugin("notify_slack")
+def notify_slack(ctx: PluginContext) -> None:
+    webhook = ctx.params["webhook"]
+    ctx.probe.run(f"curl -X POST {webhook} -d '{{\"text\":\"deployed!\"}}'")
+    ctx.step.result = "notified"
+    ctx.step.status = StepStatus.DONE
+```
+
+`PluginContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `step` | `MigrationStep` | Current step — set `result` and `status` here |
+| `host` | `str` | SSH host (e.g. `pi@192.168.1.5`) |
+| `probe` | `RemoteProbe` | Call `probe.run(cmd)` for remote SSH commands |
+| `emitter` | `ProgressEmitter?` | Emit mid-step progress: `emitter.progress(step.id, msg)` |
+| `params` | `dict` | Shortcut for `step.plugin_params` |
+| `dry_run` | `bool` | Skip side-effects if True |
+
+
 
 Place in project root — `redeploy run` (no args) uses it automatically.
 Supports **named environments** for multi-target projects:

{redeploy-0.2.1 → redeploy-0.2.4}/pyproject.toml

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

{redeploy-0.2.1 → redeploy-0.2.4}/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.1"
+__version__ = "0.2.4"
 
 # ── Core models ───────────────────────────────────────────────────────────────
 from .models import (  # noqa: F401
@@ -55,6 +55,36 @@ from .patterns import (  # noqa: F401
     pattern_registry,
 )
 
+# ── Observability (first-class from 0.2.0) ────────────────────────────────────
+from .observe import (  # noqa: F401
+    AuditEntry,
+    DeployAuditLog,
+    DeployReport,
+)
+
+# ── IaC parsers (first-class from 0.3.0) ──────────────────────────────────────
+from .iac import (  # noqa: F401
+    ParsedSpec,
+    Parser,
+    ParserRegistry,
+    PortInfo,
+    ServiceInfo,
+    VolumeInfo,
+    ConversionWarning,
+    parse_file,
+    parse_dir,
+    parser_registry,
+)
+
+# ── Plugin system (first-class from 0.2.2) ────────────────────────────────────
+from .plugins import (  # noqa: F401
+    PluginContext,
+    PluginRegistry,
+    register_plugin,
+    load_user_plugins,
+    registry as plugin_registry,
+)
+
 __all__ = [
     # version
     "__version__",
@@ -95,4 +125,25 @@ __all__ = [
     "get_pattern",
     "list_patterns",
     "pattern_registry",
+    # observability
+    "AuditEntry",
+    "DeployAuditLog",
+    "DeployReport",
+    # iac parsers
+    "ParsedSpec",
+    "Parser",
+    "ParserRegistry",
+    "PortInfo",
+    "ServiceInfo",
+    "VolumeInfo",
+    "ConversionWarning",
+    "parse_file",
+    "parse_dir",
+    "parser_registry",
+    # plugin system
+    "PluginContext",
+    "PluginRegistry",
+    "register_plugin",
+    "load_user_plugins",
+    "plugin_registry",
 ]

{redeploy-0.2.1 → redeploy-0.2.4}/redeploy/apply/executor.py

@@ -14,6 +14,7 @@ from loguru import logger
 
 from ..detect.remote import RemoteProbe
 from ..models import MigrationPlan, MigrationStep, StepAction, StepStatus
+from ..plugins import PluginContext, registry as _plugin_registry
 
 
 class ProgressEmitter:
@@ -121,7 +122,9 @@ class Executor:
     def __init__(self, plan: MigrationPlan, dry_run: bool = False,
                  ssh_key: Optional[str] = None,
                  progress_yaml: bool = False,
-                 progress_stream: IO[str] = None):
+                 progress_stream: IO[str] = None,
+                 audit_log: bool = True,
+                 audit_path: Optional["Path"] = None):
         self.plan = plan
         self.dry_run = dry_run
         self.probe = RemoteProbe(plan.host)
@@ -131,15 +134,24 @@ class Executor:
         self._emitter: Optional[ProgressEmitter] = (
             ProgressEmitter(progress_stream) if progress_yaml else None
         )
+        self._audit_log = audit_log
+        self._audit_path = audit_path
+        self._t0: float = 0.0
+
+    @property
+    def completed_steps(self) -> list[MigrationStep]:
+        return list(self._completed)
 
     def run(self) -> bool:
         """Execute all steps. Returns True if all passed."""
+        self._t0 = time.monotonic()
         prefix = "[DRY RUN] " if self.dry_run else ""
         logger.info(f"{prefix}Applying plan: {len(self.plan.steps)} steps "
                     f"({self.plan.from_strategy.value} → {self.plan.to_strategy.value})")
         if self._emitter:
             self._emitter.start(self.plan)
 
+        ok = True
         for i, step in enumerate(self.plan.steps, 1):
             try:
                 if self._emitter:
@@ -157,12 +169,27 @@ class Executor:
                     self._emitter.failed(len(self._completed), len(self.plan.steps), str(e))
                 if not self.dry_run:
                     self._rollback()
-                return False
-
-        logger.info(f"{'[DRY RUN] ' if self.dry_run else ''}All {len(self.plan.steps)} steps completed")
-        if self._emitter:
-            self._emitter.done(len(self.plan.steps))
-        return True
+                ok = False
+                break
+
+        elapsed = time.monotonic() - self._t0
+        if ok:
+            logger.info(f"{'[DRY RUN] ' if self.dry_run else ''}All {len(self.plan.steps)} steps completed")
+            if self._emitter:
+                self._emitter.done(len(self.plan.steps))
+        self._write_audit(ok=ok, elapsed_s=elapsed)
+        return ok
+
+    def _write_audit(self, *, ok: bool, elapsed_s: float) -> None:
+        if not self._audit_log:
+            return
+        try:
+            from ..observe import DeployAuditLog
+            log = DeployAuditLog(path=self._audit_path)
+            log.record(self.plan, self._completed, ok=ok,
+                       elapsed_s=elapsed_s, dry_run=self.dry_run)
+        except Exception as exc:  # never crash the executor
+            logger.debug(f"audit_log write failed (non-fatal): {exc}")
 
     # ── step dispatcher ───────────────────────────────────────────────────────
 
@@ -191,6 +218,7 @@ class Executor:
             StepAction.HTTP_CHECK:          self._run_http_check,
             StepAction.VERSION_CHECK:       self._run_version_check,
             StepAction.WAIT:                self._run_wait,
+            StepAction.PLUGIN:              self._run_plugin,
         }
 
         handler = dispatch.get(step.action)
@@ -391,6 +419,25 @@ class Executor:
         step.status = StepStatus.DONE
         step.result = f"version {step.expect} confirmed"
 
+    def _run_plugin(self, step: MigrationStep) -> None:
+        """Dispatch to a registered plugin handler."""
+        plugin_type = step.plugin_type
+        if not plugin_type:
+            raise StepError(step, "plugin action requires plugin_type field")
+        handler = _plugin_registry.get(plugin_type)
+        if not handler:
+            available = ", ".join(_plugin_registry.names()) or "(none loaded)"
+            raise StepError(step, f"unknown plugin_type '{plugin_type}'. Available: {available}")
+        ctx = PluginContext(
+            step=step,
+            host=self.plan.host,
+            probe=self.probe,
+            emitter=self._emitter,
+            params=step.plugin_params,
+            dry_run=self.dry_run,
+        )
+        handler(ctx)
+
     def _run_wait(self, step: MigrationStep) -> None:
         total = step.seconds
         if total <= 0: