@@ -0,0 +1,1720 @@
+"""Step definitions for devcontainer_lifecycle.feature.

@@ -507,0 +507,4 @@
+    # ── Devcontainer lifecycle cleanup (issue #514) ─────────────
+
+    @staticmethod
+    def stop_active_devcontainers(session_id: str = "") -> list[str]:

@@ -28,0 +55,4 @@
+#: S1 fix: regex pattern for valid Docker container IDs (12-64 hex chars).
+_CONTAINER_ID_PATTERN = re.compile(r"^[a-f0-9]{12,64}$")
+
+#: Registry of lifecycle trackers keyed by resource_id.

@@ -28,0 +146,4 @@
+        resource_id: ULID of the devcontainer resource.
+        workspace_folder: Path to the workspace containing devcontainer config.
+        run_command: Optional callable replacing subprocess.run for testing.
+        session_id: Optional session/plan ID to associate with this container

@@ -28,0 +304,4 @@
+            tracker = get_lifecycle_tracker(resource_id)
+            tracker = transition_state(
+                tracker,
+                ContainerLifecycleState.FAILED,

@@ -28,0 +342,4 @@
+
+    Raises:
+        ValueError: If the container is not in ``running`` state.
+        RuntimeError: If stop fails.

@@ -28,0 +371,4 @@
+                tracker.current_state.value,
+            )
+            return tracker
+        tracker = transition_state(

@@ -28,0 +464,4 @@
+    # associated with the calling session for scoped cleanup.
+    return activate_container(
+        resource_id,
+        workspace_folder,

@@ -28,0 +194,4 @@
+                "up",
+                "--workspace-folder",
+                workspace_folder,
+            ],

@@ -28,0 +430,4 @@
+            )
+            set_lifecycle_tracker(tracker)
+        raise RuntimeError(f"Failed to stop container: {exc}") from exc
+

@@ -28,0 +473,4 @@
+def start_health_check(
+    resource_id: str,
+    *,
+    interval: float = DEFAULT_HEALTH_CHECK_INTERVAL,

@@ -1061,0 +1151,4 @@
+        raise typer.Abort() from exc
+    except (ValueError, RuntimeError) as exc:
+        console.print(f"[red]Stop failed:[/red] {exc}")
+        raise typer.Abort() from exc

@@ -28,0 +50,4 @@
+logger = logging.getLogger(__name__)
+
+#: Default health check interval in seconds.
+DEFAULT_HEALTH_CHECK_INTERVAL: float = 30.0

@@ -28,0 +254,4 @@
+        start_health_check(resource_id, run_command=run_command)
+
+    except RuntimeError:
+        raise

@@ -28,0 +485,4 @@
+    """
+    if not resource_id:
+        raise ValueError("resource_id must not be empty")
+

@@ -28,0 +182,4 @@
+        tracker = transition_state(
+            tracker,
+            ContainerLifecycleState.BUILDING,
+            reason="lazy activation",