docs: update AGENTS.md with multi-version runtime documentation

- Add --versions command to quick reference table
- Add multi-version runtimes section with usage examples
- Document endoflife.date integration in cli_audit module overview
- Update catalog count to 78 entries

Author: CybotTM

AGENTS.md

@@ -63,6 +63,8 @@ uv run python audit.py --help    # Verify CLI works
 | `make upgrade-managed` | Upgrade all package managers |
 | `make upgrade-dry-run` | Preview upgrades without changes |
 | `./scripts/set_auto_update.sh <tool>` | Enable auto-update for a tool |
+| `uv run python audit.py --versions` | Show multi-version runtime status |
+| `uv run python audit.py --versions php` | Show specific runtime versions |
 
 ## Data files
 
@@ -82,6 +84,20 @@ uv run python audit.py --help    # Verify CLI works
 - **Phase 2:** Installation & upgrade management (complete)
 - **Entry point:** `audit.py` → `cli_audit` package
 
+## Multi-version runtimes
+
+Runtimes supporting multiple concurrent versions (PHP, Python, Node.js, Ruby, Go) use dynamic detection from [endoflife.date](https://endoflife.date/) API.
+
+```bash
+# Show all runtime versions
+uv run python audit.py --versions
+
+# JSON output for scripting
+CLI_AUDIT_JSON=1 uv run python audit.py --versions
+```
+
+**Catalog config:** Tools with `multi_version.enabled: true` in their JSON catalog define detection strategies (binary patterns or version manager directories).
+
 ## When instructions conflict
 
 Nearest AGENTS.md wins. User prompts override all files.

cli_audit/AGENTS.md

@@ -10,9 +10,9 @@ The `cli_audit` package provides the core functionality for AI CLI Preparation:
 
 **Phase 1: Detection & Auditing (6 modules)**
 - `tools.py` — Tool definitions and metadata
-- `catalog.py` — JSON catalog management (76 entries)
-- `detection.py` — Installation detection, version extraction
-- `collectors.py` — Upstream version collection (GitHub, PyPI, npm, crates)
+- `catalog.py` — JSON catalog management (78 entries)
+- `detection.py` — Installation detection, version extraction, multi-version detection
+- `collectors.py` — Upstream version collection (GitHub, PyPI, npm, crates, endoflife.date)
 - `snapshot.py` — Snapshot-based caching
 - `render.py` — Output formatting and table rendering
 
@@ -56,6 +56,12 @@ local_state.json        # Gitignored - machine-specific installation state
 - Categories: python, node, go, rust, ruby, php, shell, git, devops, platform, ai, general
 - User preferences (auto_update) stored in user config, not catalog
 
+**Multi-version runtimes** (PHP, Python, Node.js, Ruby, Go):
+- Catalog entries with `multi_version.enabled: true` support concurrent versions
+- Version lifecycle data from [endoflife.date](https://endoflife.date/) API
+- Detection via binary patterns (`php8.4`) or version manager dirs (`~/.nvm/versions/node/`)
+- See: `collect_endoflife()`, `detect_multi_versions()`
+
 ## Setup & environment
 
 **Requirements:**