killpy 0.25.1__tar.gz → 1.0.1__tar.gz

{killpy-0.25.1 → killpy-1.0.1}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: killpy
-Version: 0.25.1
+Version: 1.0.1
 Summary: Find and delete unused Python environments (.venv, conda, poetry, pipenv, pipx, pyenv, uv) and caches to free disk space — from a fast terminal UI or a single CLI command.
 Project-URL: Homepage, https://github.com/Tlaloc-Es/killpy
 Project-URL: Documentation, https://tlaloc-es.github.io/killpy/
 Project-URL: Repository, https://github.com/Tlaloc-Es/killpy
 Project-URL: Bug Tracker, https://github.com/Tlaloc-Es/killpy/issues
 Keywords: venv,virtualenv,conda,poetry,pipenv,pipx,pyenv,uv,cleanup,disk-space,cache,cli,tui,textual,developer-tools
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Console :: Curses
 Classifier: Intended Audience :: Developers
@@ -196,7 +196,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 | Key | Action |
 |-----|--------|
 | `↑` / `↓` or `k` / `j` | Move cursor up / down (vim-style) |
-| `/` | Open live search/filter bar (regex supported) |
+| `/` | Open live search/filter bar (substring match) |
 | `Escape` | Close search bar and clear filter |
 | `T` | Toggle multi-select mode on / off |
 | `Space` | *(Multi-select)* Toggle current row selected |
@@ -211,7 +211,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 
 ### Search / filter
 
-Press `/` to open the filter bar at the bottom of the screen. Type any string or a Python regex — the venv table updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
+Press `/` to open the filter bar at the bottom of the screen. Type any text — the venv table filters by path substring (case-insensitive) and updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
 
 ### Multi-select mode
 
@@ -265,7 +265,7 @@ ______________________________________________________________________
 killpy list                               # list all detected environments
 killpy list --path ~/projects             # scan a specific path
 killpy list --type venv --type conda      # filter by type (repeatable)
-killpy list --older-than 90               # not accessed in the last 90 days
+killpy list --older-than 90               # not modified in the last 90 days
 killpy list --json                        # output as a JSON array
 killpy list --json-stream                 # stream as NDJSON — one line per env
 killpy list --quiet                       # suppress progress output (scripts/CI)
@@ -284,7 +284,7 @@ The **Path** column mirrors the form of `--path`: a relative `--path` produces r
     "absolute_path": "/home/user/projects/my-app/.venv",
     "name": "my-app/.venv",
     "type": "venv",
-    "last_accessed": "2025-11-02T14:23:01+00:00",
+    "last_modified": "2025-11-02T14:23:01+00:00",
     "size_bytes": 54393984,
     "size_human": "51.88 MB",
     "managed_by": null,
@@ -417,8 +417,7 @@ Category is assigned deterministically by applying the following rules in order:
 |----------|------|----------|
 | 1 | Orphan (`is_orphan=True`) **and** `age ≥ 180 days` | `HIGH` |
 | 2 | Active git repository **or** `age < 120 days` | `LOW` |
-| 3 | `age ≥ 120 days` | `MEDIUM` |
-| 4 | Fallback | `LOW` |
+| 3 | `age ≥ 120 days` *(exhaustive fallback)* | `MEDIUM` |
 
 Age and orphan status are the dominant signals. Size does not affect the category.
 
@@ -498,7 +497,7 @@ Yes. Run `killpy --path ~` to scan your home folder. The `stats` command gives a
 killpy delete --type venv --older-than 90 --yes
 ```
 
-Deletes every `.venv` / `pyvenv.cfg` env not accessed in the last 90 days, without prompting.
+Deletes every `.venv` / `pyvenv.cfg` env not modified in the last 90 days, without prompting.
 
 **How do I use killpy in a CI pipeline or script?**
 
@@ -604,7 +603,7 @@ ______________________________________________________________________
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy                  # remove __pycache__ on every commit
     - id: killpy-clean-caches     # also removes .mypy_cache, .pytest_cache, .ruff_cache
@@ -629,7 +628,7 @@ Typical minimal setup (safe for daily use):
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy
 ```

{killpy-0.25.1 → killpy-1.0.1}/README.md

@@ -167,7 +167,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 | Key | Action |
 |-----|--------|
 | `↑` / `↓` or `k` / `j` | Move cursor up / down (vim-style) |
-| `/` | Open live search/filter bar (regex supported) |
+| `/` | Open live search/filter bar (substring match) |
 | `Escape` | Close search bar and clear filter |
 | `T` | Toggle multi-select mode on / off |
 | `Space` | *(Multi-select)* Toggle current row selected |
@@ -182,7 +182,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 
 ### Search / filter
 
-Press `/` to open the filter bar at the bottom of the screen. Type any string or a Python regex — the venv table updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
+Press `/` to open the filter bar at the bottom of the screen. Type any text — the venv table filters by path substring (case-insensitive) and updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
 
 ### Multi-select mode
 
@@ -236,7 +236,7 @@ ______________________________________________________________________
 killpy list                               # list all detected environments
 killpy list --path ~/projects             # scan a specific path
 killpy list --type venv --type conda      # filter by type (repeatable)
-killpy list --older-than 90               # not accessed in the last 90 days
+killpy list --older-than 90               # not modified in the last 90 days
 killpy list --json                        # output as a JSON array
 killpy list --json-stream                 # stream as NDJSON — one line per env
 killpy list --quiet                       # suppress progress output (scripts/CI)
@@ -255,7 +255,7 @@ The **Path** column mirrors the form of `--path`: a relative `--path` produces r
     "absolute_path": "/home/user/projects/my-app/.venv",
     "name": "my-app/.venv",
     "type": "venv",
-    "last_accessed": "2025-11-02T14:23:01+00:00",
+    "last_modified": "2025-11-02T14:23:01+00:00",
     "size_bytes": 54393984,
     "size_human": "51.88 MB",
     "managed_by": null,
@@ -388,8 +388,7 @@ Category is assigned deterministically by applying the following rules in order:
 |----------|------|----------|
 | 1 | Orphan (`is_orphan=True`) **and** `age ≥ 180 days` | `HIGH` |
 | 2 | Active git repository **or** `age < 120 days` | `LOW` |
-| 3 | `age ≥ 120 days` | `MEDIUM` |
-| 4 | Fallback | `LOW` |
+| 3 | `age ≥ 120 days` *(exhaustive fallback)* | `MEDIUM` |
 
 Age and orphan status are the dominant signals. Size does not affect the category.
 
@@ -469,7 +468,7 @@ Yes. Run `killpy --path ~` to scan your home folder. The `stats` command gives a
 killpy delete --type venv --older-than 90 --yes
 ```
 
-Deletes every `.venv` / `pyvenv.cfg` env not accessed in the last 90 days, without prompting.
+Deletes every `.venv` / `pyvenv.cfg` env not modified in the last 90 days, without prompting.
 
 **How do I use killpy in a CI pipeline or script?**
 
@@ -575,7 +574,7 @@ ______________________________________________________________________
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy                  # remove __pycache__ on every commit
     - id: killpy-clean-caches     # also removes .mypy_cache, .pytest_cache, .ruff_cache
@@ -600,7 +599,7 @@ Typical minimal setup (safe for daily use):
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy
 ```

{killpy-0.25.1 → killpy-1.0.1}/killpy/cli.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import asyncio
-import re
 import subprocess
 import sys
 from datetime import datetime
@@ -297,7 +296,7 @@ class TableApp(App):
         yield Label("", id="status-label")
         yield Label("", id="selected-path-label")
         yield Input(
-            placeholder="Filter by path (regex)… Esc to clear",
+            placeholder="Filter by path… Esc to clear",
             id="search-input",
         )
         yield Label("", id="multi-select-label")
@@ -337,7 +336,7 @@ class TableApp(App):
             {
                 "path": str(environment.path),
                 "type": environment.type,
-                "last_modified": environment.last_accessed_str,
+                "last_modified": environment.last_modified_str,
                 "size": environment.size_bytes,
                 "size_human": environment.size_human,
                 "health": self._health_by_path.get(str(environment.path), ""),
@@ -382,13 +381,10 @@ class TableApp(App):
         table.clear(columns=True)
         table.add_columns(*self.get_headers_for_table("venv-table"))
         self._venv_display_indices = []
+        query = self._filter_query.lower()
         for i, row in enumerate(self.venv_rows):
-            if self._filter_query:
-                try:
-                    if not re.search(self._filter_query, row["path"], re.IGNORECASE):
-                        continue
-                except re.error:
-                    pass  # invalid regex — show all
+            if query and query not in row["path"].lower():
+                continue
             self._venv_display_indices.append(i)
             env = row["environment"]
             type_label = ("\u26a0\ufe0f " if env.is_system_critical else "") + row[

{killpy-0.25.1 → killpy-1.0.1}/killpy/commands/_utils.py

@@ -68,7 +68,7 @@ def filter_envs(
         names such as ``"venv"`` and ``"cache"`` are automatically expanded to
         their concrete sub-type values via :data:`_TYPE_ALIASES`.
     older_than:
-        If provided, only environments not accessed in the last *older_than* days
+        If provided, only environments not modified in the last *older_than* days
         are kept.
     """
     now = datetime.now(tz=timezone.utc)
@@ -84,6 +84,6 @@ def filter_envs(
 
     if older_than is not None:
         cutoff = now - timedelta(days=older_than)
-        result = [e for e in result if e.last_accessed < cutoff]
+        result = [e for e in result if e.last_modified < cutoff]
 
     return result

{killpy-0.25.1 → killpy-1.0.1}/killpy/commands/delete.py

@@ -37,7 +37,7 @@ from killpy.scanner import Scanner
     type=int,
     default=None,
     metavar="DAYS",
-    help="Only delete environments not accessed in the last N days.",
+    help="Only delete environments not modified in the last N days.",
 )
 @click.option(
     "--dry-run",

{killpy-0.25.1 → killpy-1.0.1}/killpy/commands/doctor.py

@@ -195,7 +195,7 @@ def _output_rich(
 
         now = datetime.now(tz=timezone.utc)
         for se in top:
-            la = se.env.last_accessed
+            la = se.env.last_modified
             if la.tzinfo is None:
                 la = la.replace(tzinfo=timezone.utc)
             age_days = (now - la).days
@@ -264,7 +264,7 @@ def _print_category_table(
 
     now = datetime.now(tz=timezone.utc)
     for se in scored_envs:
-        la = se.env.last_accessed
+        la = se.env.last_modified
         if la.tzinfo is None:
             la = la.replace(tzinfo=timezone.utc)
         age_days = (now - la).days

{killpy-0.25.1 → killpy-1.0.1}/killpy/commands/list.py

@@ -58,7 +58,7 @@ def _print_table(envs: list, console: Console) -> None:
     table = Table(show_header=True, header_style="bold cyan")
     table.add_column("Type", style="dim", min_width=10)
     table.add_column("Name", min_width=20)
-    table.add_column("Last accessed", min_width=12)
+    table.add_column("Last modified", min_width=12)
     table.add_column("Size", justify="right", min_width=9)
     table.add_column("Path")
 
@@ -66,7 +66,7 @@ def _print_table(envs: list, console: Console) -> None:
         table.add_row(
             env.type,
             env.name,
-            env.last_accessed_str,
+            env.last_modified_str,
             env.size_human,
             str(env.path),
         )
@@ -101,7 +101,7 @@ def _print_table(envs: list, console: Console) -> None:
     type=int,
     default=None,
     metavar="DAYS",
-    help="Only show environments not accessed in the last N days.",
+    help="Only show environments not modified in the last N days.",
 )
 @click.option(
     "--json-stream",

killpy-1.0.1/killpy/detectors/_shared_walk.py

@@ -0,0 +1,110 @@
+"""Single shared filesystem walk for the tree-walking detectors.
+
+``venv`` / ``cache`` / ``artifacts`` / ``tox`` each used to run their own
+``os.walk`` over the scan root, and ``get_total_size`` re-walked every
+environment they found — walking a large tree several times over.
+
+This module performs **one** traversal: each directory is classified as an
+environment *container* (a venv, a cache dir, a build artifact, or ``.tox``);
+a match is recorded, its size is summed once, and its subtree is pruned.
+Environment pruning is always applied — once a venv is found, nothing inside it
+is scanned again — which also collapses the cache/artifact double-counting that
+used to happen inside environments.
+
+Callers pass the set of detector names whose results they want (``active``).
+Pruning happens on every container regardless of ``active``, so asking for a
+subset yields exactly what running those detectors alone would.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+
+from killpy.detectors.base import VCS_PRUNE_DIRS
+from killpy.files import get_total_size
+from killpy.models import Environment
+
+logger = logging.getLogger(__name__)
+
+_CACHE_DIRS = frozenset({"__pycache__", ".mypy_cache", ".pytest_cache", ".ruff_cache"})
+_ARTIFACT_EXACT = frozenset({"dist", "build"})
+_ARTIFACT_SUFFIXES = (".egg-info", ".dist-info")
+
+#: Map every ``Environment.type`` the shared walk (and the cache global scan)
+#: can produce back to the detector that owns it — used to group results per
+#: detector for progress callbacks.
+TYPE_TO_DETECTOR: dict[str, str] = {
+    ".venv": "venv",
+    "pyvenv.cfg": "venv",
+    "__pycache__": "cache",
+    ".mypy_cache": "cache",
+    ".pytest_cache": "cache",
+    ".ruff_cache": "cache",
+    "pip-cache": "cache",
+    "uv-cache": "cache",
+    "artifacts": "artifacts",
+    "tox": "tox",
+}
+
+
+def _classify(basename: str, filenames: list[str]) -> tuple[str, str] | None:
+    """Return ``(detector_name, env_type)`` if the dir is a container, else ``None``."""
+    if basename == ".venv" or "pyvenv.cfg" in filenames:
+        return ("venv", ".venv" if basename == ".venv" else "pyvenv.cfg")
+    if basename in _CACHE_DIRS:
+        return ("cache", basename)
+    if basename in _ARTIFACT_EXACT or any(
+        basename.endswith(suffix) for suffix in _ARTIFACT_SUFFIXES
+    ):
+        return ("artifacts", "artifacts")
+    if basename == ".tox":
+        return ("tox", "tox")
+    return None
+
+
+def _make_env(path: Path, env_type: str) -> Environment | None:
+    """Build an :class:`Environment` for *path*, summing its size once."""
+    try:
+        stat = path.stat()
+        return Environment(
+            path=path,
+            name=str(path),
+            type=env_type,
+            last_modified=datetime.fromtimestamp(stat.st_mtime, tz=timezone.utc),
+            size_bytes=get_total_size(path),
+        )
+    except (FileNotFoundError, OSError) as exc:
+        logger.debug("Skipping %s: %s", path, exc)
+        return None
+
+
+def walk_environments(root: Path, active: set[str]) -> list[Environment]:
+    """Walk *root* once and return environments for the ``active`` detector set.
+
+    Each directory that matches a container type is reported (when its detector
+    is in *active*) and its subtree pruned; VCS and ``site-packages`` trees are
+    never descended into.
+    """
+    envs: list[Environment] = []
+    for current, dirnames, filenames in os.walk(root, topdown=True):
+        dirnames[:] = [d for d in dirnames if d not in VCS_PRUNE_DIRS]
+        current_path = Path(current)
+        if current_path != root:
+            match = _classify(current_path.name, filenames)
+            if match is not None:
+                detector_name, env_type = match
+                if detector_name in active:
+                    env = _make_env(current_path, env_type)
+                    if env is not None:
+                        envs.append(env)
+                dirnames[:] = []  # env-pruning: never descend into a container
+                continue
+        # A bare ``site-packages`` (e.g. a conda env, which has no pyvenv.cfg) is
+        # not a container but must not be scanned for caches/artifacts. ``.venv``
+        # IS a container — detected on entry — so it is deliberately not pruned
+        # here (that would stop us from ever reporting it).
+        dirnames[:] = [d for d in dirnames if d != "site-packages"]
+    return envs

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/artifacts.py

@@ -42,6 +42,7 @@ class ArtifactsDetector(AbstractDetector):
 
     name = "artifacts"
     always_available = True  # pure filesystem walk
+    shared_walk = True  # tree scan served by killpy.detectors._shared_walk
 
     def detect(self, path: Path) -> list[Environment]:
         envs: list[Environment] = []
@@ -69,7 +70,7 @@ class ArtifactsDetector(AbstractDetector):
                                 path=artifact_path,
                                 name=str(artifact_path),
                                 type="artifacts",
-                                last_accessed=mtime,
+                                last_modified=mtime,
                                 size_bytes=size,
                             )
                         )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/base.py

@@ -62,6 +62,11 @@ class AbstractDetector(ABC):
     required_tool: ClassVar[str | None] = None
     #: ``True`` for detectors that always apply (pure filesystem walks).
     always_available: ClassVar[bool] = False
+    #: ``True`` when this detector's tree scan is served by the single shared
+    #: walk (``killpy.detectors._shared_walk``) instead of its own ``os.walk``.
+    #: The :class:`~killpy.scanner.Scanner` batches all such detectors into one
+    #: traversal; ``detect`` is kept for direct use and tests.
+    shared_walk: ClassVar[bool] = False
 
     @abstractmethod
     def detect(self, path: Path) -> list[Environment]:
@@ -78,6 +83,15 @@ class AbstractDetector(ABC):
             use it as the walk root.
         """
 
+    def scan_global(self, path: Path) -> list[Environment]:
+        """Environments found outside the shared tree walk (e.g. global caches).
+
+        Empty by default; :class:`~killpy.detectors.cache.CacheDetector` overrides
+        it to report the global pip/uv caches.  Called by the Scanner only for
+        detectors with ``shared_walk = True``.
+        """
+        return []
+
     def _candidate_dirs(self) -> tuple[Path, ...]:
         """Directories whose existence makes this detector applicable.
 

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/cache.py

@@ -72,6 +72,7 @@ class CacheDetector(AbstractDetector):
 
     name = "cache"
     always_available = True  # pure filesystem walk
+    shared_walk = True  # local tree scan served by killpy.detectors._shared_walk
 
     def detect(self, path: Path) -> list[Environment]:
         envs: list[Environment] = []
@@ -79,6 +80,10 @@ class CacheDetector(AbstractDetector):
         envs.extend(self._scan_global(path))
         return envs
 
+    def scan_global(self, path: Path) -> list[Environment]:
+        """Global pip/uv caches — the part not covered by the shared tree walk."""
+        return self._scan_global(path)
+
     # ------------------------------------------------------------------ #
 
     def _scan_local(self, root: Path) -> list[Environment]:
@@ -147,6 +152,6 @@ def _make_cache_env(cache_path: Path, tag: str) -> Environment:
         path=cache_path,
         name=str(cache_path),
         type=tag,
-        last_accessed=mtime,
+        last_modified=mtime,
         size_bytes=size,
     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/conda.py

@@ -97,7 +97,7 @@ class CondaDetector(AbstractDetector):
                         path=env_path,
                         name=env_name,
                         type="conda",
-                        last_accessed=mtime,
+                        last_modified=mtime,
                         size_bytes=size,
                         managed_by="conda",
                     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/hatch.py

@@ -73,7 +73,7 @@ class HatchDetector(AbstractDetector):
                                 path=env_dir,
                                 name=f"{project_dir.name}/{env_dir.name}",
                                 type="hatch",
-                                last_accessed=mtime,
+                                last_modified=mtime,
                                 size_bytes=size,
                             )
                         )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/pipenv.py

@@ -62,7 +62,7 @@ class PipenvDetector(AbstractDetector):
                             path=venv_path,
                             name=venv_path.name,
                             type="pipenv",
-                            last_accessed=mtime,
+                            last_modified=mtime,
                             size_bytes=size,
                         )
                     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/pipx.py

@@ -126,7 +126,7 @@ class PipxDetector(AbstractDetector):
                         path=candidate,
                         name=package_name,
                         type="pipx",
-                        last_accessed=mtime,
+                        last_modified=mtime,
                         size_bytes=size,
                         managed_by="pipx",
                     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/poetry.py

@@ -72,7 +72,7 @@ class PoetryDetector(AbstractDetector):
                             path=venv_path,
                             name=venv_path.name,
                             type="poetry",
-                            last_accessed=mtime,
+                            last_modified=mtime,
                             size_bytes=size,
                         )
                     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/pyenv.py

@@ -68,7 +68,7 @@ class PyenvDetector(AbstractDetector):
                             path=version_dir,
                             name=version_dir.name,
                             type="pyenv",
-                            last_accessed=mtime,
+                            last_modified=mtime,
                             size_bytes=size,
                         )
                     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/tox.py

@@ -19,6 +19,7 @@ class ToxDetector(AbstractDetector):
 
     name = "tox"
     always_available = True  # pure filesystem walk
+    shared_walk = True  # tree scan served by killpy.detectors._shared_walk
 
     def detect(self, path: Path) -> list[Environment]:
         envs: list[Environment] = []
@@ -42,7 +43,7 @@ class ToxDetector(AbstractDetector):
                                 path=tox_path,
                                 name=str(tox_path),
                                 type="tox",
-                                last_accessed=mtime,
+                                last_modified=mtime,
                                 size_bytes=size,
                             )
                         )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/uv.py

@@ -81,7 +81,7 @@ class UvDetector(AbstractDetector):
                             path=env_dir,
                             name=env_dir.name,
                             type="uv",
-                            last_accessed=mtime,
+                            last_modified=mtime,
                             size_bytes=size,
                             managed_by=managed_by,
                         )

{killpy-0.25.1 → killpy-1.0.1}/killpy/detectors/venv.py

@@ -57,6 +57,7 @@ class VenvDetector(AbstractDetector):
 
     name = "venv"
     always_available = True  # pure filesystem walk
+    shared_walk = True  # tree scan served by killpy.detectors._shared_walk
 
     def detect(self, path: Path) -> list[Environment]:
         # Inner dedup: the ".venv" scan and the pyvenv.cfg scan below can both
@@ -105,6 +106,6 @@ def _make_env(dir_path: Path, tag: str) -> Environment:
         path=dir_path,
         name=str(dir_path),
         type=tag,
-        last_accessed=mtime,
+        last_modified=mtime,
         size_bytes=size,
     )

{killpy-0.25.1 → killpy-1.0.1}/killpy/intelligence/scoring.py

@@ -69,8 +69,8 @@ class ScoringService:
         size_score = self._normalize_size(env.size_bytes)
         explanation.append(f"Size: {env.size_human}")
 
-        age_score, age_days = self._normalize_age(env.last_accessed)
-        explanation.append(f"Last accessed {age_days} days ago")
+        age_score, age_days = self._normalize_age(env.last_modified)
+        explanation.append(f"Last modified {age_days} days ago")
 
         is_orphan, orphan_score = self._orphan_score(env.path)
         has_project_files = not is_orphan
@@ -132,11 +132,11 @@ class ScoringService:
         return 1.0 / (1.0 + math.exp(-k * (size_bytes - x0)))
 
     @staticmethod
-    def _normalize_age(last_accessed: datetime) -> tuple[float, int]:
+    def _normalize_age(last_modified: datetime) -> tuple[float, int]:
         """Return (age_score, age_days) where age_score is linear [0, 1]."""
         now = datetime.now(tz=timezone.utc)
         try:
-            la = last_accessed
+            la = last_modified
             if la.tzinfo is None:
                 la = la.replace(tzinfo=timezone.utc)
             age_days = max(0, (now - la).days)

{killpy-0.25.1 → killpy-1.0.1}/killpy/intelligence/suggestions.py

@@ -9,8 +9,9 @@ from killpy.models import ScoredEnvironment, Suggestion
 
 # Age thresholds in days.
 _HIGH_AGE_ORPHAN_THRESHOLD = 180  # orphan + age >= this → HIGH
-_MEDIUM_AGE_THRESHOLD = 120  # age >= this → MEDIUM
-_LOW_AGE_THRESHOLD = 120  # age < this → LOW
+# Single LOW/MEDIUM cutoff: age < this → LOW (recently modified), age >= this →
+# MEDIUM (stale). Active git always forces LOW regardless of age.
+_STALE_AGE_THRESHOLD = 120
 
 _ACTION_HIGH = "Delete — unused and orphaned"
 _ACTION_MEDIUM = "Review — possibly unused"
@@ -59,8 +60,8 @@ class SuggestionEngine:
 
     @staticmethod
     def _age_days(scored: ScoredEnvironment) -> int:
-        """Return age in days based on env.last_accessed."""
-        la = scored.env.last_accessed
+        """Return age in days based on env.last_modified."""
+        la = scored.env.last_modified
         if la.tzinfo is None:
             la = la.replace(tzinfo=timezone.utc)
         return max(0, (datetime.now(tz=timezone.utc) - la).days)
@@ -81,32 +82,27 @@ class SuggestionEngine:
         # ── Rule 1: HIGH — orphan and stale ────────────────────────────────────
         if is_orphan and age_days >= _HIGH_AGE_ORPHAN_THRESHOLD:
             reasons.append("Orphan — no project files found nearby")
-            reasons.append(f"Not used in {age_days} days")
+            reasons.append(f"Not modified in {age_days} days")
             return "HIGH", _ACTION_HIGH
 
         # ── Rule 2: LOW — active git or very recent ─────────────────────────────
-        if is_active_git or age_days < _LOW_AGE_THRESHOLD:
+        if is_active_git or age_days < _STALE_AGE_THRESHOLD:
             if is_active_git:
                 reasons.append("Active git repository")
-            if age_days < _LOW_AGE_THRESHOLD:
-                reasons.append(f"Recently used ({age_days} days ago)")
+            if age_days < _STALE_AGE_THRESHOLD:
+                reasons.append(f"Recently modified ({age_days} days ago)")
             action = _ACTION_LOW_ACTIVE if is_active_git else _ACTION_LOW
             return "LOW", action
 
-        # ── Rule 3: MEDIUM — moderately old ────────────────────────────────────
-        if age_days >= _MEDIUM_AGE_THRESHOLD:
-            if is_orphan:
-                reasons.append("Orphan — no project files found nearby")
-            reasons.append(f"Not used in {age_days} days")
-            if (
-                scored.git_info is not None
-                and scored.git_info.is_git_repo
-                and not scored.git_info.is_active
-            ):
-                reasons.append("Associated git repo has no recent commits")
-            return "MEDIUM", _ACTION_MEDIUM
-
-        # ── Rule 4: FALLBACK → LOW ──────────────────────────────────────────────
-        if is_active_git:
-            reasons.append("Active git repository")
-        return "LOW", _ACTION_LOW
+        # ── Rule 3: MEDIUM — stale (not active, age >= _STALE_AGE_THRESHOLD) ────
+        # Exhaustive fallback: everything not caught by Rules 1–2 is stale.
+        if is_orphan:
+            reasons.append("Orphan — no project files found nearby")
+        reasons.append(f"Not modified in {age_days} days")
+        if (
+            scored.git_info is not None
+            and scored.git_info.is_git_repo
+            and not scored.git_info.is_active
+        ):
+            reasons.append("Associated git repo has no recent commits")
+        return "MEDIUM", _ACTION_MEDIUM

{killpy-0.25.1 → killpy-1.0.1}/killpy/models.py

@@ -35,8 +35,9 @@ class Environment:
     type:
         Short detector tag, e.g. ``"venv"``, ``"pyvenv.cfg"``, ``"poetry"``,
         ``"conda"``, ``"pipx"``, ``"cache"``, ``"uv"``, ``"artifacts"``…
-    last_accessed:
-        Timestamp of the last modification reported by the filesystem.
+    last_modified:
+        Last modification time (``st_mtime``) of the environment root, as
+        reported by the filesystem — not an access time.
     size_bytes:
         Total size in bytes (recursive directory sum).
     managed_by:
@@ -48,7 +49,7 @@ class Environment:
     path: Path
     name: str
     type: str
-    last_accessed: datetime
+    last_modified: datetime
     size_bytes: int
     managed_by: str | None = None
     is_system_critical: bool = False
@@ -63,9 +64,9 @@ class Environment:
         return format_size(self.size_bytes)
 
     @property
-    def last_accessed_str(self) -> str:
+    def last_modified_str(self) -> str:
         """Formatted date string ``DD/MM/YYYY`` for display."""
-        return self.last_accessed.strftime("%d/%m/%Y")
+        return self.last_modified.strftime("%d/%m/%Y")
 
     # ------------------------------------------------------------------ #
     #  Serialisation                                                       #
@@ -83,7 +84,7 @@ class Environment:
             "absolute_path": str(abs_path),
             "name": self.name,
             "type": self.type,
-            "last_accessed": self.last_accessed.isoformat(),
+            "last_modified": self.last_modified.isoformat(),
             "size_bytes": self.size_bytes,
             "size_human": self.size_human,
             "managed_by": self.managed_by,

{killpy-0.25.1 → killpy-1.0.1}/killpy/scanner.py

@@ -22,6 +22,7 @@ from collections.abc import AsyncIterator, Callable
 from pathlib import Path
 
 from killpy.detectors import ALL_DETECTORS, AbstractDetector
+from killpy.detectors._shared_walk import TYPE_TO_DETECTOR, walk_environments
 from killpy.detectors.pyenv import _pyenv_root
 from killpy.models import Environment
 
@@ -85,24 +86,28 @@ class Scanner:
         seen: set[Path] = set()
         results: list[Environment] = []
 
-        for detector in self._detectors:
-            if not detector.can_handle():
-                logger.debug("Skipping %s (can_handle=False)", detector.name)
-                continue
+        applicable = [d for d in self._detectors if d.can_handle()]
+        shared = [d for d in applicable if d.shared_walk]
+        others = [d for d in applicable if not d.shared_walk]
+
+        # One traversal shared by every filesystem-walking detector.
+        for detector, found in self._shared_walk_groups(shared, path):
+            processed = self._process(found, seen)
+            results.extend(processed)
+            if on_progress is not None:
+                on_progress(detector, processed)
+
+        # The remaining detectors scan their own global directories.
+        for detector in others:
             try:
                 found = detector.detect(path)
             except Exception as exc:  # noqa: BLE001
                 logger.warning("Detector %s raised: %s", detector.name, exc)
                 found = []
-
-            deduped = self._deduplicate(found, seen)
-            deduped = self._apply_exclusions(deduped)
-            for env in deduped:
-                self._mark_system_critical(env)
-            results.extend(deduped)
-
+            processed = self._process(found, seen)
+            results.extend(processed)
             if on_progress is not None:
-                on_progress(detector, deduped)
+                on_progress(detector, processed)
 
         results.sort(key=lambda e: e.size_bytes, reverse=True)
         return results
@@ -123,28 +128,70 @@ class Scanner:
                     table.add_row(env)
         """
         applicable = [d for d in self._detectors if d.can_handle()]
+        shared = [d for d in applicable if d.shared_walk]
+        others = [d for d in applicable if not d.shared_walk]
         seen: set[Path] = set()
 
-        async def _run(detector: AbstractDetector):
+        async def _run_shared() -> list[tuple[AbstractDetector, list[Environment]]]:
             try:
-                return detector, await asyncio.to_thread(detector.detect, path)
+                return await asyncio.to_thread(self._shared_walk_groups, shared, path)
+            except Exception as exc:  # noqa: BLE001
+                logger.warning("Shared walk raised: %s", exc)
+                return [(d, []) for d in shared]
+
+        async def _run_one(
+            detector: AbstractDetector,
+        ) -> list[tuple[AbstractDetector, list[Environment]]]:
+            try:
+                return [(detector, await asyncio.to_thread(detector.detect, path))]
             except Exception as exc:  # noqa: BLE001
                 logger.warning("Detector %s raised: %s", detector.name, exc)
-                return detector, []
+                return [(detector, [])]
+
+        tasks = [asyncio.create_task(_run_one(d)) for d in others]
+        if shared:
+            tasks.append(asyncio.create_task(_run_shared()))
 
-        tasks = [asyncio.create_task(_run(d)) for d in applicable]
         for coro in asyncio.as_completed(tasks):
-            detector, found = await coro
-            deduped = self._deduplicate(found, seen)
-            deduped = self._apply_exclusions(deduped)
-            for env in deduped:
-                self._mark_system_critical(env)
-            yield detector, deduped
+            for detector, found in await coro:
+                deduped = self._process(found, seen)
+                yield detector, deduped
 
     # ------------------------------------------------------------------ #
     #  Helpers                                                             #
     # ------------------------------------------------------------------ #
 
+    def _shared_walk_groups(
+        self, shared: list[AbstractDetector], path: Path
+    ) -> list[tuple[AbstractDetector, list[Environment]]]:
+        """Run the one shared walk, returning ``(detector, envs)`` per detector.
+
+        The local tree is walked once for the union of *shared* detector names;
+        each detector also contributes its own global scan (pip/uv caches).
+        Results are grouped back per detector via :data:`TYPE_TO_DETECTOR` so the
+        per-detector progress contract is preserved.
+        """
+        if not shared:
+            return []
+        active = {d.name for d in shared}
+        found = walk_environments(path, active)
+        for detector in shared:
+            found.extend(detector.scan_global(path))
+        by_name: dict[str, list[Environment]] = {d.name: [] for d in shared}
+        for env in found:
+            name = TYPE_TO_DETECTOR.get(env.type)
+            if name in by_name:
+                by_name[name].append(env)
+        return [(d, by_name[d.name]) for d in shared]
+
+    def _process(self, found: list[Environment], seen: set[Path]) -> list[Environment]:
+        """Deduplicate, apply exclusions, and flag system-critical envs."""
+        deduped = self._deduplicate(found, seen)
+        deduped = self._apply_exclusions(deduped)
+        for env in deduped:
+            self._mark_system_critical(env)
+        return deduped
+
     @staticmethod
     def _deduplicate(envs: list[Environment], seen: set[Path]) -> list[Environment]:
         """Filter out environments whose resolved path has already been seen.

{killpy-0.25.1 → killpy-1.0.1}/killpy.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: killpy
-Version: 0.25.1
+Version: 1.0.1
 Summary: Find and delete unused Python environments (.venv, conda, poetry, pipenv, pipx, pyenv, uv) and caches to free disk space — from a fast terminal UI or a single CLI command.
 Project-URL: Homepage, https://github.com/Tlaloc-Es/killpy
 Project-URL: Documentation, https://tlaloc-es.github.io/killpy/
 Project-URL: Repository, https://github.com/Tlaloc-Es/killpy
 Project-URL: Bug Tracker, https://github.com/Tlaloc-Es/killpy/issues
 Keywords: venv,virtualenv,conda,poetry,pipenv,pipx,pyenv,uv,cleanup,disk-space,cache,cli,tui,textual,developer-tools
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Console :: Curses
 Classifier: Intended Audience :: Developers
@@ -196,7 +196,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 | Key | Action |
 |-----|--------|
 | `↑` / `↓` or `k` / `j` | Move cursor up / down (vim-style) |
-| `/` | Open live search/filter bar (regex supported) |
+| `/` | Open live search/filter bar (substring match) |
 | `Escape` | Close search bar and clear filter |
 | `T` | Toggle multi-select mode on / off |
 | `Space` | *(Multi-select)* Toggle current row selected |
@@ -211,7 +211,7 @@ Environments flagged with `⚠️` are actively in use (the environment killpy r
 
 ### Search / filter
 
-Press `/` to open the filter bar at the bottom of the screen. Type any string or a Python regex — the venv table updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
+Press `/` to open the filter bar at the bottom of the screen. Type any text — the venv table filters by path substring (case-insensitive) and updates live as you type. Press `Escape` or submit an empty value to clear the filter and return to the full list.
 
 ### Multi-select mode
 
@@ -265,7 +265,7 @@ ______________________________________________________________________
 killpy list                               # list all detected environments
 killpy list --path ~/projects             # scan a specific path
 killpy list --type venv --type conda      # filter by type (repeatable)
-killpy list --older-than 90               # not accessed in the last 90 days
+killpy list --older-than 90               # not modified in the last 90 days
 killpy list --json                        # output as a JSON array
 killpy list --json-stream                 # stream as NDJSON — one line per env
 killpy list --quiet                       # suppress progress output (scripts/CI)
@@ -284,7 +284,7 @@ The **Path** column mirrors the form of `--path`: a relative `--path` produces r
     "absolute_path": "/home/user/projects/my-app/.venv",
     "name": "my-app/.venv",
     "type": "venv",
-    "last_accessed": "2025-11-02T14:23:01+00:00",
+    "last_modified": "2025-11-02T14:23:01+00:00",
     "size_bytes": 54393984,
     "size_human": "51.88 MB",
     "managed_by": null,
@@ -417,8 +417,7 @@ Category is assigned deterministically by applying the following rules in order:
 |----------|------|----------|
 | 1 | Orphan (`is_orphan=True`) **and** `age ≥ 180 days` | `HIGH` |
 | 2 | Active git repository **or** `age < 120 days` | `LOW` |
-| 3 | `age ≥ 120 days` | `MEDIUM` |
-| 4 | Fallback | `LOW` |
+| 3 | `age ≥ 120 days` *(exhaustive fallback)* | `MEDIUM` |
 
 Age and orphan status are the dominant signals. Size does not affect the category.
 
@@ -498,7 +497,7 @@ Yes. Run `killpy --path ~` to scan your home folder. The `stats` command gives a
 killpy delete --type venv --older-than 90 --yes
 ```
 
-Deletes every `.venv` / `pyvenv.cfg` env not accessed in the last 90 days, without prompting.
+Deletes every `.venv` / `pyvenv.cfg` env not modified in the last 90 days, without prompting.
 
 **How do I use killpy in a CI pipeline or script?**
 
@@ -604,7 +603,7 @@ ______________________________________________________________________
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy                  # remove __pycache__ on every commit
     - id: killpy-clean-caches     # also removes .mypy_cache, .pytest_cache, .ruff_cache
@@ -629,7 +628,7 @@ Typical minimal setup (safe for daily use):
 
 ```yaml
 - repo: https://github.com/Tlaloc-Es/KillPy
-  rev: 0.25.1
+  rev: 1.0.1
   hooks:
     - id: killpy
 ```

{killpy-0.25.1 → killpy-1.0.1}/killpy.egg-info/SOURCES.txt

@@ -22,6 +22,7 @@ killpy/commands/find.py
 killpy/commands/list.py
 killpy/commands/stats.py
 killpy/detectors/__init__.py
+killpy/detectors/_shared_walk.py
 killpy/detectors/artifacts.py
 killpy/detectors/base.py
 killpy/detectors/cache.py

{killpy-0.25.1 → killpy-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "killpy"
-version = "0.25.1"
+version = "1.0.1"
 description = "Find and delete unused Python environments (.venv, conda, poetry, pipenv, pipx, pyenv, uv) and caches to free disk space — from a fast terminal UI or a single CLI command."
 readme = "README.md"
 keywords = [
@@ -21,7 +21,7 @@ keywords = [
     "developer-tools",
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
     "Environment :: Console :: Curses",
     "Intended Audience :: Developers",
@@ -75,6 +75,9 @@ package = true
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "-v --tb=short --cov=killpy --cov-report=term-missing --cov-report=xml"
+markers = [
+    "integration: system-level end-to-end tests (real envs + real deletion); require KILLPY_INTEGRATION=1",
+]
 
 [tool.coverage.run]
 branch = true
@@ -103,5 +106,9 @@ lint = "ruff check killpy tests"
 format = "ruff format killpy tests"
 type = "mypy killpy"
 
+[tool.poe.tasks.integration]
+cmd = "pytest -m integration --no-cov tests/integration"
+env = { KILLPY_INTEGRATION = "1" }
+
 [project.scripts]
 killpy = "killpy.__main__:cli"