aws-bootstrap-g4dn 0.7.0__tar.gz → 0.8.0__tar.gz

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/CLAUDE.md

@@ -71,7 +71,7 @@ Entry point: `aws-bootstrap = "aws_bootstrap.cli:main"` (installed via `uv sync`
 - **`launch`** — provisions an EC2 instance (spot by default, falls back to on-demand on capacity errors); adds SSH config alias (e.g. `aws-gpu1`) to `~/.ssh/config`; `--python-version` controls which Python `uv` installs in the remote venv; `--ssh-port` overrides the default SSH port (22) for security group ingress, connection checks, and SSH config; `--ebs-storage SIZE` creates and attaches a new gp3 EBS data volume (mounted at `/data`); `--ebs-volume-id ID` attaches an existing EBS volume (mutually exclusive with `--ebs-storage`)
 - **`status`** — lists all non-terminated instances (including `shutting-down`) with type, IP, SSH alias, EBS data volumes, pricing (spot price/hr or on-demand), uptime, and estimated cost for running spot instances; `--gpu` flag queries GPU info via SSH, reporting both CUDA toolkit version (from `nvcc`) and driver-supported max (from `nvidia-smi`); `--instructions` (default: on) prints connection commands (SSH, Jupyter tunnel, VSCode Remote SSH, GPU benchmark) for each running instance; suppress with `--no-instructions`
 - **`terminate`** — terminates instances by ID or SSH alias (e.g. `aws-gpu1`, resolved via `~/.ssh/config`), or all aws-bootstrap instances in the region if no arguments given; removes SSH config aliases; deletes associated EBS data volumes by default; `--keep-ebs` preserves volumes and prints reattach commands
-- **`cleanup`** — removes stale `~/.ssh/config` entries for terminated/non-existent instances; compares managed SSH config blocks against live EC2 instances; `--dry-run` previews removals without modifying config; `--yes` skips the confirmation prompt
+- **`cleanup`** — removes stale `~/.ssh/config` entries for terminated/non-existent instances; compares managed SSH config blocks against live EC2 instances; `--include-ebs` also finds and deletes orphan EBS data volumes (volumes in `available` state whose linked instance no longer exists); `--dry-run` previews removals without modifying config; `--yes` skips the confirmation prompt
 - **`list instance-types`** — lists EC2 instance types matching a family prefix (default: `g4dn`), showing vCPUs, memory, and GPU info
 - **`list amis`** — lists available AMIs matching a name pattern (default: Deep Learning Base OSS Nvidia Driver GPU AMIs), sorted newest-first
 

{aws_bootstrap_g4dn-0.7.0/aws_bootstrap_g4dn.egg-info → aws_bootstrap_g4dn-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aws-bootstrap-g4dn
-Version: 0.7.0
+Version: 0.8.0
 Summary: Bootstrap AWS EC2 GPU instances for hybrid local-remote development
 Author: Adam Ever-Hadani
 License-Expression: MIT
@@ -317,6 +317,12 @@ aws-bootstrap cleanup
 # Preview what would be removed without modifying config
 aws-bootstrap cleanup --dry-run
 
+# Also find and delete orphan EBS data volumes
+aws-bootstrap cleanup --include-ebs
+
+# Preview orphan volumes without deleting
+aws-bootstrap cleanup --include-ebs --dry-run
+
 # Skip confirmation prompt
 aws-bootstrap cleanup --yes
 ```
@@ -350,6 +356,7 @@ Key behaviors:
 - New volumes are formatted as ext4; existing volumes are mounted as-is
 - Volumes are tagged for automatic discovery by `status` and `terminate`
 - `terminate` deletes data volumes by default; use `--keep-ebs` to preserve them
+- **Orphan cleanup** — use `aws-bootstrap cleanup --include-ebs` to find and delete orphan volumes (e.g. from spot interruptions or forgotten `--keep-ebs` volumes). Use `--dry-run` to preview
 - **Spot-safe** — data volumes survive spot interruptions. If AWS reclaims your instance, the volume detaches automatically and can be reattached to a new instance with `--ebs-volume-id`
 - EBS volumes must be in the same availability zone as the instance
 - Mount failures are non-fatal — the instance remains usable

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/README.md

@@ -296,6 +296,12 @@ aws-bootstrap cleanup
 # Preview what would be removed without modifying config
 aws-bootstrap cleanup --dry-run
 
+# Also find and delete orphan EBS data volumes
+aws-bootstrap cleanup --include-ebs
+
+# Preview orphan volumes without deleting
+aws-bootstrap cleanup --include-ebs --dry-run
+
 # Skip confirmation prompt
 aws-bootstrap cleanup --yes
 ```
@@ -329,6 +335,7 @@ Key behaviors:
 - New volumes are formatted as ext4; existing volumes are mounted as-is
 - Volumes are tagged for automatic discovery by `status` and `terminate`
 - `terminate` deletes data volumes by default; use `--keep-ebs` to preserve them
+- **Orphan cleanup** — use `aws-bootstrap cleanup --include-ebs` to find and delete orphan volumes (e.g. from spot interruptions or forgotten `--keep-ebs` volumes). Use `--dry-run` to preview
 - **Spot-safe** — data volumes survive spot interruptions. If AWS reclaims your instance, the volume detaches automatically and can be reattached to a new instance with `--ebs-volume-id`
 - EBS volumes must be in the same availability zone as the instance
 - Mount failures are non-fatal — the instance remains usable

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/aws_bootstrap/cli.py

@@ -17,6 +17,7 @@ from .ec2 import (
     delete_ebs_volume,
     ensure_security_group,
     find_ebs_volumes_for_instance,
+    find_orphan_ebs_volumes,
     find_tagged_instances,
     get_latest_ami,
     get_spot_price,
@@ -778,10 +779,11 @@ def terminate(ctx, region, profile, yes, keep_ebs, instance_ids):
 @main.command()
 @click.option("--dry-run", is_flag=True, default=False, help="Show what would be removed without removing.")
 @click.option("--yes", "-y", is_flag=True, default=False, help="Skip confirmation prompt.")
+@click.option("--include-ebs", is_flag=True, default=False, help="Also find and delete orphan EBS data volumes.")
 @click.option("--region", default="us-west-2", show_default=True, help="AWS region.")
 @click.option("--profile", default=None, help="AWS profile override.")
 @click.pass_context
-def cleanup(ctx, dry_run, yes, region, profile):
+def cleanup(ctx, dry_run, yes, include_ebs, region, profile):
     """Remove stale SSH config entries for terminated instances."""
     session = boto3.Session(profile_name=profile, region_name=region)
     ec2 = session.client("ec2")
@@ -794,57 +796,113 @@ def cleanup(ctx, dry_run, yes, region, profile):
     live_ids = {inst["InstanceId"] for inst in live_instances}
 
     stale = find_stale_ssh_hosts(live_ids)
-    if not stale:
+
+    # Orphan EBS discovery
+    orphan_volumes: list[dict] = []
+    if include_ebs:
+        orphan_volumes = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_ids)
+
+    if not stale and not orphan_volumes:
         if is_text(ctx):
-            click.secho("No stale SSH config entries found.", fg="green")
+            msg = "No stale SSH config entries found."
+            if include_ebs:
+                msg = "No stale SSH config entries or orphan EBS volumes found."
+            click.secho(msg, fg="green")
         else:
             result_key = "stale" if dry_run else "cleaned"
-            emit({result_key: []}, ctx=ctx)
+            result: dict = {result_key: []}
+            if include_ebs:
+                ebs_key = "orphan_volumes" if dry_run else "deleted_volumes"
+                result[ebs_key] = []
+            emit(result, ctx=ctx)
         return
 
     if is_text(ctx):
-        click.secho(f"\n  Found {len(stale)} stale SSH config entry(ies):\n", bold=True, fg="cyan")
-        for iid, alias in stale:
-            click.echo("  " + click.style(alias, fg="bright_white") + f"  ({iid})")
+        if stale:
+            click.secho(f"\n  Found {len(stale)} stale SSH config entry(ies):\n", bold=True, fg="cyan")
+            for iid, alias in stale:
+                click.echo("  " + click.style(alias, fg="bright_white") + f"  ({iid})")
+        if orphan_volumes:
+            click.secho(f"\n  Found {len(orphan_volumes)} orphan EBS volume(s):\n", bold=True, fg="cyan")
+            for vol in orphan_volumes:
+                click.echo(
+                    "  "
+                    + click.style(vol["VolumeId"], fg="bright_white")
+                    + f"  ({vol['Size']} GB, was {vol['InstanceId']})"
+                )
 
     if dry_run:
         if is_text(ctx):
             click.echo()
             for iid, alias in stale:
                 info(f"Would remove {alias} ({iid})")
+            for vol in orphan_volumes:
+                info(f"Would delete {vol['VolumeId']} ({vol['Size']} GB)")
         else:
-            emit(
-                {
-                    "stale": [{"instance_id": iid, "alias": alias} for iid, alias in stale],
-                    "dry_run": True,
-                },
-                ctx=ctx,
-            )
+            result = {
+                "stale": [{"instance_id": iid, "alias": alias} for iid, alias in stale],
+                "dry_run": True,
+            }
+            if include_ebs:
+                result["orphan_volumes"] = [
+                    {
+                        "volume_id": vol["VolumeId"],
+                        "size_gb": vol["Size"],
+                        "instance_id": vol["InstanceId"],
+                    }
+                    for vol in orphan_volumes
+                ]
+            emit(result, ctx=ctx)
         return
 
     if not yes:
         click.echo()
-        if not click.confirm(f"  Remove {len(stale)} stale entry(ies)?"):
+        parts = []
+        if stale:
+            parts.append(f"{len(stale)} stale SSH entry(ies)")
+        if orphan_volumes:
+            parts.append(f"{len(orphan_volumes)} orphan EBS volume(s)")
+        if not click.confirm(f"  Remove {' and '.join(parts)}?"):
             click.secho("  Cancelled.", fg="yellow")
             return
 
-    results = cleanup_stale_ssh_hosts(live_ids)
+    ssh_results = cleanup_stale_ssh_hosts(live_ids) if stale else []
+
+    # Delete orphan EBS volumes
+    deleted_volumes: list[dict] = []
+    for vol in orphan_volumes:
+        try:
+            delete_ebs_volume(ec2, vol["VolumeId"])
+            deleted_volumes.append({"volume_id": vol["VolumeId"], "size_gb": vol["Size"], "deleted": True})
+        except (botocore.exceptions.ClientError, botocore.exceptions.BotoCoreError) as exc:
+            if is_text(ctx):
+                warn(f"Failed to delete {vol['VolumeId']}: {exc}")
+            deleted_volumes.append({"volume_id": vol["VolumeId"], "size_gb": vol["Size"], "deleted": False})
 
     if not is_text(ctx):
-        emit(
-            {
-                "cleaned": [{"instance_id": r.instance_id, "alias": r.alias, "removed": r.removed} for r in results],
-            },
-            ctx=ctx,
-        )
+        result = {
+            "cleaned": [{"instance_id": r.instance_id, "alias": r.alias, "removed": r.removed} for r in ssh_results],
+        }
+        if include_ebs:
+            result["deleted_volumes"] = deleted_volumes
+        emit(result, ctx=ctx)
         return
 
     click.echo()
-    for r in results:
+    for r in ssh_results:
         success(f"Removed {r.alias} ({r.instance_id})")
+    for vol in deleted_volumes:
+        if vol["deleted"]:
+            success(f"Deleted {vol['volume_id']} ({vol['size_gb']} GB)")
 
     click.echo()
-    success(f"Cleaned up {len(results)} stale entry(ies).")
+    parts = []
+    if ssh_results:
+        parts.append(f"{len(ssh_results)} stale entry(ies)")
+    if deleted_volumes:
+        ok_count = sum(1 for v in deleted_volumes if v["deleted"])
+        parts.append(f"{ok_count} orphan volume(s)")
+    success(f"Cleaned up {' and '.join(parts)}.")
 
 
 # ---------------------------------------------------------------------------

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/aws_bootstrap/ec2.py

@@ -468,3 +468,39 @@ def find_ebs_volumes_for_instance(ec2_client, instance_id: str, tag_value: str)
             }
         )
     return volumes
+
+
+def find_orphan_ebs_volumes(ec2_client, tag_value: str, live_instance_ids: set[str]) -> list[dict]:
+    """Find aws-bootstrap EBS volumes whose linked instance no longer exists.
+
+    Only returns volumes in ``available`` state (not attached to any instance).
+    Volumes that are ``in-use`` are never considered orphans, even if their
+    tagged instance ID is not in *live_instance_ids*.
+
+    Returns a list of dicts with VolumeId, Size, State, and InstanceId
+    (the instance ID from the ``aws-bootstrap-instance`` tag).
+    """
+    try:
+        response = ec2_client.describe_volumes(
+            Filters=[
+                {"Name": "tag:created-by", "Values": [tag_value]},
+                {"Name": "status", "Values": ["available"]},
+            ]
+        )
+    except botocore.exceptions.ClientError:
+        return []
+
+    orphans = []
+    for vol in response.get("Volumes", []):
+        tags = {t["Key"]: t["Value"] for t in vol.get("Tags", [])}
+        linked_instance = tags.get("aws-bootstrap-instance", "")
+        if linked_instance and linked_instance not in live_instance_ids:
+            orphans.append(
+                {
+                    "VolumeId": vol["VolumeId"],
+                    "Size": vol["Size"],
+                    "State": vol["State"],
+                    "InstanceId": linked_instance,
+                }
+            )
+    return orphans

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/aws_bootstrap/tests/test_cli.py

@@ -1258,6 +1258,103 @@ def test_cleanup_with_yes(mock_find, mock_session, mock_stale, mock_cleanup):
     mock_cleanup.assert_called_once()
 
 
+# ---------------------------------------------------------------------------
+# cleanup --include-ebs
+# ---------------------------------------------------------------------------
+
+
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes", return_value=[])
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_include_ebs_no_orphans(mock_find, mock_session, mock_stale, mock_orphan):
+    runner = CliRunner()
+    result = runner.invoke(main, ["cleanup", "--include-ebs"])
+    assert result.exit_code == 0
+    assert "No stale SSH config entries or orphan EBS volumes found." in result.output
+    mock_orphan.assert_called_once()
+
+
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes")
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_include_ebs_dry_run(mock_find, mock_session, mock_stale, mock_orphan):
+    mock_orphan.return_value = [
+        {"VolumeId": "vol-orphan1", "Size": 50, "State": "available", "InstanceId": "i-dead1234"},
+    ]
+    runner = CliRunner()
+    result = runner.invoke(main, ["cleanup", "--include-ebs", "--dry-run"])
+    assert result.exit_code == 0
+    assert "Would delete vol-orphan1" in result.output
+    assert "50 GB" in result.output
+
+
+@patch("aws_bootstrap.cli.delete_ebs_volume")
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes")
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_include_ebs_delete_with_yes(mock_find, mock_session, mock_stale, mock_orphan, mock_delete):
+    mock_orphan.return_value = [
+        {"VolumeId": "vol-orphan1", "Size": 50, "State": "available", "InstanceId": "i-dead1234"},
+    ]
+    runner = CliRunner()
+    result = runner.invoke(main, ["cleanup", "--include-ebs", "--yes"])
+    assert result.exit_code == 0
+    assert "Deleted vol-orphan1" in result.output
+    mock_delete.assert_called_once_with(mock_session.return_value.client.return_value, "vol-orphan1")
+
+
+@patch("aws_bootstrap.cli.delete_ebs_volume")
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes")
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_include_ebs_json(mock_find, mock_session, mock_stale, mock_orphan, mock_delete):
+    mock_orphan.return_value = [
+        {"VolumeId": "vol-orphan1", "Size": 50, "State": "available", "InstanceId": "i-dead1234"},
+    ]
+    runner = CliRunner()
+    result = runner.invoke(main, ["-o", "json", "cleanup", "--include-ebs", "--yes"])
+    assert result.exit_code == 0
+    data = json.loads(result.output)
+    assert "deleted_volumes" in data
+    assert len(data["deleted_volumes"]) == 1
+    assert data["deleted_volumes"][0]["volume_id"] == "vol-orphan1"
+    assert data["deleted_volumes"][0]["deleted"] is True
+
+
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes")
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_include_ebs_dry_run_json(mock_find, mock_session, mock_stale, mock_orphan):
+    mock_orphan.return_value = [
+        {"VolumeId": "vol-orphan1", "Size": 50, "State": "available", "InstanceId": "i-dead1234"},
+    ]
+    runner = CliRunner()
+    result = runner.invoke(main, ["-o", "json", "cleanup", "--include-ebs", "--dry-run"])
+    assert result.exit_code == 0
+    data = json.loads(result.output)
+    assert data["dry_run"] is True
+    assert "orphan_volumes" in data
+    assert data["orphan_volumes"][0]["volume_id"] == "vol-orphan1"
+    assert data["orphan_volumes"][0]["size_gb"] == 50
+
+
+@patch("aws_bootstrap.cli.find_orphan_ebs_volumes", return_value=[])
+@patch("aws_bootstrap.cli.find_stale_ssh_hosts", return_value=[])
+@patch("aws_bootstrap.cli.boto3.Session")
+@patch("aws_bootstrap.cli.find_tagged_instances", return_value=[])
+def test_cleanup_without_include_ebs_skips_volume_check(mock_find, mock_session, mock_stale, mock_orphan):
+    """Without --include-ebs, orphan volume discovery should not be called."""
+    runner = CliRunner()
+    result = runner.invoke(main, ["cleanup"])
+    assert result.exit_code == 0
+    mock_orphan.assert_not_called()
+
+
 # ---------------------------------------------------------------------------
 # --output structured format tests
 # ---------------------------------------------------------------------------

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/aws_bootstrap/tests/test_ebs.py

@@ -14,6 +14,7 @@ from aws_bootstrap.ec2 import (
     delete_ebs_volume,
     detach_ebs_volume,
     find_ebs_volumes_for_instance,
+    find_orphan_ebs_volumes,
     validate_ebs_volume,
 )
 
@@ -243,3 +244,92 @@ def test_find_ebs_volumes_client_error_returns_empty():
     )
     volumes = find_ebs_volumes_for_instance(ec2, "i-test", "aws-bootstrap-g4dn")
     assert volumes == []
+
+
+# ---------------------------------------------------------------------------
+# find_orphan_ebs_volumes
+# ---------------------------------------------------------------------------
+
+
+def test_find_orphan_ebs_volumes_returns_orphans():
+    """Volumes whose linked instance is not live should be returned."""
+    ec2 = MagicMock()
+    ec2.describe_volumes.return_value = {
+        "Volumes": [
+            {
+                "VolumeId": "vol-orphan1",
+                "Size": 50,
+                "State": "available",
+                "Tags": [
+                    {"Key": "created-by", "Value": "aws-bootstrap-g4dn"},
+                    {"Key": "aws-bootstrap-instance", "Value": "i-dead1234"},
+                ],
+            }
+        ]
+    }
+    orphans = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_instance_ids=set())
+    assert len(orphans) == 1
+    assert orphans[0]["VolumeId"] == "vol-orphan1"
+    assert orphans[0]["InstanceId"] == "i-dead1234"
+    assert orphans[0]["Size"] == 50
+
+    # Verify the API was called with status=available filter
+    filters = ec2.describe_volumes.call_args[1]["Filters"]
+    filter_names = {f["Name"] for f in filters}
+    assert "status" in filter_names
+
+
+def test_find_orphan_ebs_volumes_excludes_live_instances():
+    """Volumes linked to a live instance should NOT be returned."""
+    ec2 = MagicMock()
+    ec2.describe_volumes.return_value = {
+        "Volumes": [
+            {
+                "VolumeId": "vol-attached",
+                "Size": 96,
+                "State": "available",
+                "Tags": [
+                    {"Key": "created-by", "Value": "aws-bootstrap-g4dn"},
+                    {"Key": "aws-bootstrap-instance", "Value": "i-live123"},
+                ],
+            }
+        ]
+    }
+    orphans = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_instance_ids={"i-live123"})
+    assert orphans == []
+
+
+def test_find_orphan_ebs_volumes_empty():
+    """No volumes at all should return empty list."""
+    ec2 = MagicMock()
+    ec2.describe_volumes.return_value = {"Volumes": []}
+    orphans = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_instance_ids=set())
+    assert orphans == []
+
+
+def test_find_orphan_ebs_volumes_skips_no_instance_tag():
+    """Volumes without aws-bootstrap-instance tag should be skipped."""
+    ec2 = MagicMock()
+    ec2.describe_volumes.return_value = {
+        "Volumes": [
+            {
+                "VolumeId": "vol-notag",
+                "Size": 10,
+                "State": "available",
+                "Tags": [{"Key": "created-by", "Value": "aws-bootstrap-g4dn"}],
+            }
+        ]
+    }
+    orphans = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_instance_ids=set())
+    assert orphans == []
+
+
+def test_find_orphan_ebs_volumes_client_error():
+    """ClientError should return empty list."""
+    ec2 = MagicMock()
+    ec2.describe_volumes.side_effect = botocore.exceptions.ClientError(
+        {"Error": {"Code": "UnauthorizedOperation", "Message": "no access"}},
+        "DescribeVolumes",
+    )
+    orphans = find_orphan_ebs_volumes(ec2, "aws-bootstrap-g4dn", live_instance_ids=set())
+    assert orphans == []

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0/aws_bootstrap_g4dn.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aws-bootstrap-g4dn
-Version: 0.7.0
+Version: 0.8.0
 Summary: Bootstrap AWS EC2 GPU instances for hybrid local-remote development
 Author: Adam Ever-Hadani
 License-Expression: MIT
@@ -317,6 +317,12 @@ aws-bootstrap cleanup
 # Preview what would be removed without modifying config
 aws-bootstrap cleanup --dry-run
 
+# Also find and delete orphan EBS data volumes
+aws-bootstrap cleanup --include-ebs
+
+# Preview orphan volumes without deleting
+aws-bootstrap cleanup --include-ebs --dry-run
+
 # Skip confirmation prompt
 aws-bootstrap cleanup --yes
 ```
@@ -350,6 +356,7 @@ Key behaviors:
 - New volumes are formatted as ext4; existing volumes are mounted as-is
 - Volumes are tagged for automatic discovery by `status` and `terminate`
 - `terminate` deletes data volumes by default; use `--keep-ebs` to preserve them
+- **Orphan cleanup** — use `aws-bootstrap cleanup --include-ebs` to find and delete orphan volumes (e.g. from spot interruptions or forgotten `--keep-ebs` volumes). Use `--dry-run` to preview
 - **Spot-safe** — data volumes survive spot interruptions. If AWS reclaims your instance, the volume detaches automatically and can be reattached to a new instance with `--ebs-volume-id`
 - EBS volumes must be in the same availability zone as the instance
 - Mount failures are non-fatal — the instance remains usable

{aws_bootstrap_g4dn-0.7.0 → aws_bootstrap_g4dn-0.8.0}/uv.lock

@@ -33,7 +33,7 @@ requires-dist = [
 dev = [
     { name = "mypy", specifier = ">=1.19.1" },
     { name = "pytest", specifier = ">=9.0.2" },
-    { name = "ruff", specifier = ">=0.14" },
+    { name = "ruff", specifier = ">=0.15" },
     { name = "types-pyyaml", specifier = ">=6.0.12.20250915" },
     { name = "types-tabulate", specifier = ">=0.9.0.20241207" },
 ]