docs(agents): update all AGENTS.md files

- Update catalog count: 67 → 74 tools
- Update Python lines: ~7K
- Fix CLI examples: remove non-existent --only flag
- Add make upgrade-all command
- Update timestamps to 2025-11-29

Author: CybotTM

AGENTS.md

@@ -1,4 +1,4 @@
-<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-03 -->
+<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-29 -->
 
 # AGENTS.md (root)
 
@@ -17,7 +17,7 @@
 
 **AI CLI Preparation v2.0** - Tool version auditing and installation management for AI coding agents.
 
-**Architecture:** Modular design with 18 specialized Python modules, 67 JSON tool catalogs, and comprehensive testing.
+**Architecture:** Modular design with 18 specialized Python modules, 74 JSON tool catalogs, and comprehensive testing.
 
 - **Phase 1 (Complete):** Detection & auditing with modular refactoring
 - **Phase 2 (Complete):** Installation & upgrade management
@@ -52,15 +52,17 @@ make audit                   # Verify core workflows
 make audit               # Render from snapshot (<100ms)
 make update              # Collect fresh versions (~7s)
 make upgrade             # Interactive upgrade guide
+make upgrade-all         # Complete 5-stage system upgrade
 
 python3 audit.py         # Direct invocation
-python3 audit.py --only ripgrep  # Single tool audit
+python3 audit.py ripgrep # Single tool audit
+python3 audit.py --update ripgrep  # Update single tool
 ```
 
 **Key files:**
-- `audit.py` — Entry point (50 lines)
-- `cli_audit/` — 18 Python modules (6,608 lines)
-- `catalog/` — 67 JSON tool definitions
+- `audit.py` — Entry point
+- `cli_audit/` — 18 Python modules (~7K lines)
+- `catalog/` — 74 JSON tool definitions
 - `latest_versions.json` — Version cache
 - `tools_snapshot.json` — Snapshot data
 

cli_audit/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-03 -->
+<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-29 -->
 
 # cli_audit/ — Python Package
 
@@ -10,7 +10,7 @@ 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 (67 entries)
+- `catalog.py` — JSON catalog management (74 entries)
 - `detection.py` — Installation detection, version extraction
 - `collectors.py` — Upstream version collection (GitHub, PyPI, npm, crates)
 - `snapshot.py` — Snapshot-based caching
@@ -268,7 +268,7 @@ except json.JSONDecodeError as e:
 **Debugging:**
 ```bash
 # Enable debug logging
-CLI_AUDIT_DEBUG=1 python3 audit.py --only ripgrep
+CLI_AUDIT_DEBUG=1 python3 audit.py ripgrep
 
 # Test specific module
 python3 -c "from cli_audit.catalog import ToolCatalog; c = ToolCatalog(); print(len(c))"

scripts/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-03 -->
+<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-29 -->
 
 # Installation Scripts - Agent Guide
 
@@ -350,7 +350,7 @@ update_rust() {
 
 **Reconcile fails:**
 1. Check current installation: `which <tool>`
-2. Check installation method: `python3 audit.py --only <tool>` or `make audit`
+2. Check installation method: `python3 audit.py <tool>` or `make audit`
 3. Manually remove old version first: `apt remove <tool>` or `cargo uninstall <tool>`
 
 **Documentation:**

tests/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-03 -->
+<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-11-29 -->
 
 # tests/ — Test Suite
 

tools_snapshot.json

@@ -1,8 +1,8 @@
 {
   "__meta__": {
-    "collected_at": "2025-11-28T23:08:26Z",
+    "collected_at": "2025-11-28T23:11:19Z",
     "count": 74,
-    "created_at": "2025-11-28T23:08:26Z",
+    "created_at": "2025-11-28T23:11:19Z",
     "offline": false,
     "partial_failures": 0,
     "schema_version": 1
@@ -904,20 +904,6 @@
       "tool_url": "https://pypi.org/project/httpie/",
       "upstream_method": "pypi"
     },
-    {
-      "category": "other",
-      "hint": "",
-      "installed": "1.13.5",
-      "installed_method": "manual",
-      "installed_version": "1.13.5",
-      "latest_upstream": "1.14.0",
-      "latest_url": "https://github.com/hashicorp/terraform/releases/tag/1.14.0",
-      "latest_version": "1.14.0",
-      "status": "OUTDATED",
-      "tool": "terraform",
-      "tool_url": "https://github.com/hashicorp/terraform",
-      "upstream_method": "gh"
-    },
     {
       "category": "other",
       "hint": "",
@@ -1043,6 +1029,20 @@
       "tool": "kubectl",
       "tool_url": "https://github.com/kubernetes/kubernetes",
       "upstream_method": "gh"
+    },
+    {
+      "category": "other",
+      "hint": "",
+      "installed": "1.14.0",
+      "installed_method": "manual",
+      "installed_version": "1.14.0",
+      "latest_upstream": "1.14.0",
+      "latest_url": "https://github.com/hashicorp/terraform/releases/tag/1.14.0",
+      "latest_version": "1.14.0",
+      "status": "UP-TO-DATE",
+      "tool": "terraform",
+      "tool_url": "https://github.com/hashicorp/terraform",
+      "upstream_method": "gh"
     }
   ]
 }