killpy 0.25.1__tar.gz → 1.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: killpy
-Version: 0.25.1
+Version: 1.0.0
 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/
@@ -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.0
   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.0
   hooks:
     - id: killpy
 ```

{killpy-0.25.1 → killpy-1.0.0}/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.0
   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.0
   hooks:
     - id: killpy
 ```

{killpy-0.25.1 → killpy-1.0.0}/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.0}/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.0}/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.0}/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.0}/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-0.25.1 → killpy-1.0.0}/killpy/detectors/artifacts.py

@@ -69,7 +69,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.0}/killpy/detectors/cache.py

@@ -147,6 +147,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.0}/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.0}/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.0}/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.0}/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.0}/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.0}/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.0}/killpy/detectors/tox.py

@@ -42,7 +42,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.0}/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.0}/killpy/detectors/venv.py

@@ -105,6 +105,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.0}/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.0}/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.0}/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.0}/killpy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: killpy
-Version: 0.25.1
+Version: 1.0.0
 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/
@@ -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.0
   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.0
   hooks:
     - id: killpy
 ```

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

@@ -1,6 +1,6 @@
 [project]
 name = "killpy"
-version = "0.25.1"
+version = "1.0.0"
 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 = [