refactorai-cli 0.2.26__tar.gz → 0.2.27__tar.gz

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: refactorai-cli
-Version: 0.2.26
+Version: 0.2.27
 Summary: Local-first CLI for the refactor platform
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -53,6 +53,6 @@ python -m twine upload ./refactorai-cli/dist/*
 ## Install test (local)
 
 ```bash
-python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.26-py3-none-any.whl
+python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.27-py3-none-any.whl
 refactor --version
 ```

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/README.md

@@ -42,6 +42,6 @@ python -m twine upload ./refactorai-cli/dist/*
 ## Install test (local)
 
 ```bash
-python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.26-py3-none-any.whl
+python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.27-py3-none-any.whl
 refactor --version
 ```

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "refactorai-cli"
-version = "0.2.26"
+version = "0.2.27"
 description = "Local-first CLI for the refactor platform"
 readme = "README.md"
 requires-python = ">=3.11"

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/refactorai_cli/__init__.py

@@ -5,4 +5,4 @@ the shared `refactor_core` pipeline from a project folder while staying
 authenticated to the hosted platform via a developer key.
 """
 
-__version__ = "0.2.26"
+__version__ = "0.2.27"

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/refactorai_cli/commands/setup_cmds.py

@@ -18,6 +18,19 @@ def _ask_approval(auto_approve: bool, prompt: str) -> bool:
     return True
 
 
+def _applehv_fallback_applied() -> bool:
+    """Return True when S1 precheck applied Podman applehv fallback."""
+    payload = get_setup_diagnostics()
+    stages = payload.get("stages") or {}
+    s1 = stages.get("S1") or {}
+    if not isinstance(s1, dict):
+        return False
+    output = s1.get("output") or {}
+    if not isinstance(output, dict):
+        return False
+    return bool(output.get("podman_applehv_fallback_applied"))
+
+
 def setup(
     yes: bool = typer.Option(False, "--yes", help="Auto-approve setup actions."),
     resume: bool = typer.Option(False, "--resume", help="Resume from last incomplete stage."),
@@ -72,5 +85,7 @@ def setup(
     elif result.sandbox_ready is False:
         detail = result.sandbox_reason or "Podman missing or not ready."
         console.print(f"[yellow]sandbox[/yellow]: not ready ({detail})")
+    if _applehv_fallback_applied():
+        console.print("[yellow]sandbox fallback[/yellow]: applied provider=applehv")
     console.print(f"[bold]completed stages[/bold]: {', '.join(result.completed_stages)}")
     console.print("[bold]next[/bold]: run `refactor init` and then `refactor review .`")

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/refactorai_cli/setup_flow.py

@@ -193,6 +193,24 @@ def _host_runtime_repair_plan(runtime: str) -> list[str]:
     return []
 
 
+def _is_krunkit_missing_error(detail: str) -> bool:
+    """Detect Podman startup failures caused by missing krunkit on macOS."""
+    text = str(detail or "").strip().lower()
+    return "krunkit" in text and ("not found" in text or "executable file" in text)
+
+
+def _podman_applehv_fallback_plan() -> list[str]:
+    """Return recovery commands to recreate Podman machine with applehv."""
+    if sys.platform != "darwin":
+        return []
+    return [
+        "podman machine stop >/dev/null 2>&1 || true",
+        "podman machine rm --force >/dev/null 2>&1 || true",
+        "podman machine init --provider applehv",
+        "podman machine start",
+    ]
+
+
 def _run_host_plan(commands: list[str], emit: Callable[[str], None] | None = None) -> tuple[bool, str]:
     """Run host-level setup commands sequentially."""
     for command in commands:
@@ -250,12 +268,59 @@ def _stage_s1_precheck(_ask_approval: Callable[[str], bool], _emit: Callable[[st
     podman_repair_plan: list[str] = []
     podman_repair_approved = False
     podman_repair_attempted = False
+    podman_applehv_fallback_plan: list[str] = []
+    podman_applehv_fallback_approved = False
+    podman_applehv_fallback_attempted = False
+    podman_applehv_fallback_applied = False
+    podman_applehv_fallback_error = ""
     disk = shutil.disk_usage(str(refactor_home()))
     blockers: list[str] = []
     if disk.free < 2 * 1024 * 1024 * 1024:
         blockers.append("Less than 2GB free disk available in REFACTOR_HOME filesystem.")
     if blockers:
         raise SetupError("Precheck failed: " + "; ".join(blockers))
+
+    def _attempt_applehv_fallback(failure_detail: str) -> bool:
+        nonlocal podman_applehv_fallback_plan
+        nonlocal podman_applehv_fallback_approved
+        nonlocal podman_applehv_fallback_attempted
+        nonlocal podman_applehv_fallback_applied
+        nonlocal podman_applehv_fallback_error
+        if not _is_krunkit_missing_error(failure_detail):
+            return False
+        if not podman_applehv_fallback_plan:
+            podman_applehv_fallback_plan = _podman_applehv_fallback_plan()
+        if not podman_applehv_fallback_plan:
+            return False
+        if _emit:
+            _emit(
+                "Detected Podman startup failure due to missing `krunkit`. "
+                "Offering Apple Hypervisor fallback..."
+            )
+        podman_applehv_fallback_approved = _ask_approval(
+            "Podman start failed because `krunkit` is missing. "
+            "Recreate Podman machine with `applehv` provider now? "
+            "This can remove existing Podman machine state."
+        )
+        if not podman_applehv_fallback_approved:
+            podman_applehv_fallback_error = "fallback_not_approved"
+            return False
+        podman_applehv_fallback_attempted = True
+        if _emit:
+            _emit("Applying Podman fallback with `applehv` provider...")
+        ok, fallback_detail = _run_host_plan(podman_applehv_fallback_plan, emit=_emit)
+        if not ok:
+            podman_applehv_fallback_error = fallback_detail
+            return False
+        podman_applehv_fallback_applied = True
+        podman_applehv_fallback_error = ""
+        return True
+
+    def _applehv_manual_hint() -> str:
+        if not podman_applehv_fallback_plan:
+            return ""
+        return " To recover on macOS, run: " + "; ".join(podman_applehv_fallback_plan) + "."
+
     if not runtime:
         podman_install_plan = _host_runtime_install_plan("podman")
         if podman_install_plan:
@@ -268,11 +333,21 @@ def _stage_s1_precheck(_ask_approval: Callable[[str], bool], _emit: Callable[[st
                     _emit("Podman was not found. Running guided host install plan...")
                 ok, detail = _run_host_plan(podman_install_plan, emit=_emit)
                 if not ok:
-                    raise SetupError(
-                        "Podman host install failed: "
-                        f"{detail}. Install manually and retry (`refactor doctor --sandbox`)."
-                    )
-                runtime, reason = resolve_engine_runtime("podman")
+                    if _attempt_applehv_fallback(detail):
+                        runtime, reason = resolve_engine_runtime("podman")
+                        if not runtime:
+                            raise SetupError(
+                                "Apple Hypervisor fallback completed but Podman is still unavailable. "
+                                "Verify PATH and retry (`refactor doctor --sandbox`)."
+                            )
+                    else:
+                        fallback_hint = _applehv_manual_hint()
+                        raise SetupError(
+                            "Podman host install failed: "
+                            f"{detail}.{fallback_hint} Install manually and retry (`refactor doctor --sandbox`)."
+                        )
+                if not runtime:
+                    runtime, reason = resolve_engine_runtime("podman")
                 if not runtime:
                     raise SetupError(
                         "Podman install completed but runtime is still unavailable. "
@@ -297,10 +372,11 @@ def _stage_s1_precheck(_ask_approval: Callable[[str], bool], _emit: Callable[[st
                         _emit("Podman is installed but not ready. Running repair plan...")
                     ok, detail = _run_host_plan(podman_repair_plan, emit=_emit)
                     if not ok:
-                        raise SetupError(
-                            "Podman runtime repair failed: "
-                            f"{detail}. Run `podman machine start` and retry."
-                        )
+                        if not _attempt_applehv_fallback(detail):
+                            raise SetupError(
+                                "Podman runtime repair failed: "
+                                f"{detail}.{_applehv_manual_hint()} Run `podman machine start` and retry."
+                            )
                     podman_ready, podman_ready_reason = _podman_runtime_ready(str(runtime))
                     if not podman_ready:
                         raise SetupError(
@@ -332,6 +408,11 @@ def _stage_s1_precheck(_ask_approval: Callable[[str], bool], _emit: Callable[[st
         "podman_repair_plan": podman_repair_plan,
         "podman_repair_approved": podman_repair_approved,
         "podman_repair_attempted": podman_repair_attempted,
+        "podman_applehv_fallback_plan": podman_applehv_fallback_plan,
+        "podman_applehv_fallback_approved": podman_applehv_fallback_approved,
+        "podman_applehv_fallback_attempted": podman_applehv_fallback_attempted,
+        "podman_applehv_fallback_applied": podman_applehv_fallback_applied,
+        "podman_applehv_fallback_error": podman_applehv_fallback_error,
         "disk_free_mb": int(disk.free / (1024 * 1024)),
     }
 

{refactorai_cli-0.2.26 → refactorai_cli-0.2.27}/refactorai_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: refactorai-cli
-Version: 0.2.26
+Version: 0.2.27
 Summary: Local-first CLI for the refactor platform
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -53,6 +53,6 @@ python -m twine upload ./refactorai-cli/dist/*
 ## Install test (local)
 
 ```bash
-python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.26-py3-none-any.whl
+python -m pip install ./refactorai-cli/dist/refactorai_cli-0.2.27-py3-none-any.whl
 refactor --version
 ```