feat(ci): Regnerate category indexes in stale component removal PRs

Signed-off-by: Giulio Frasca <gfrasca@redhat.com>

Author: gmfrasca

.github/scripts/stale_component_handler/README.md

@@ -16,6 +16,7 @@ Handles components approaching or past their verification deadline.
 3. For **stale** components:
    - Creates a branch `remove-stale-{component-name}`
    - Removes the component directory
+   - Regenerates the category README to update the index
    - Opens a PR with `stale-component-removal` label
    - Adds component owners as reviewers
 

.github/scripts/stale_component_handler/removal_pr_body.md.j2

@@ -8,6 +8,11 @@ This PR removes the component **{{ name }}** which has not been verified in {{ a
 | Last Verified           | {{ last_verified }} |
 | Days Since Verification | {{ age_days }}      |
 
+### Changes
+
+- Removes `{{ path }}/` directory
+- Updates category README to remove component from index
+
 ### Maintainers
 
 {{ owners_mention }}

.github/scripts/stale_component_handler/stale_component_handler.py

@@ -5,10 +5,10 @@
 """
 
 import argparse
+import json
 import os
 import subprocess
 import sys
-import json
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -187,6 +187,7 @@ def create_removal_pr(repo: str, component: dict, repo_path: Path, dry_run: bool
         print(f"[DRY RUN] Would create removal PR: {title}")
         print(f"  Branch: {branch_name}")
         print(f"  Removes: {path}")
+        print(f"  Updates: {Path(path).parent}/README.md (category index)")
         print(f"  Reviewers: {owners}")
         return True
 
@@ -221,6 +222,18 @@ def create_removal_pr(repo: str, component: dict, repo_path: Path, dry_run: bool
             print(f"Component directory not found: {component_dir}", file=sys.stderr)
             return False
 
+        # Regenerate category README to remove the component from the index
+        category_dir = component_dir.parent
+        is_component = "components" in path
+        try:
+            index_generator = CategoryIndexGenerator(category_dir, is_component=is_component)
+            category_readme_content = index_generator.generate()
+            category_readme_path = category_dir / "README.md"
+            category_readme_path.write_text(category_readme_content)
+            subprocess.run(["git", "add", str(category_readme_path)], check=True, capture_output=True)
+        except Exception as e:
+            print(f"Warning: Could not regenerate category README: {e}", file=sys.stderr)
+
         # Commit the change
         commit_msg = f"Remove stale component: {name}\n\nComponent has not been verified in {component['age_days']} days."
         subprocess.run(["git", "commit", "-m", commit_msg], check=True, capture_output=True)
@@ -258,8 +271,7 @@ def create_removal_pr(repo: str, component: dict, repo_path: Path, dry_run: bool
 
 
 def handle_stale_components(repo: str, token: str | None, dry_run: bool) -> None:
-    """Handle stale components: issues for warnable or stale components,
-    and additionally creates PRs for fully stale components."""
+    """Handle stale components: issues for warnings, removal PRs for stale."""
     repo_path = REPO_ROOT
     results = scan_repo(repo_path)
     # Include both warning (270-360 days) and stale (>360 days) components