Allow spreadsheet id be configured via arguments.

Author: psrna

skills/rhdh-test-plan-review/SKILL.md

@@ -46,6 +46,8 @@ If the version cannot be determined from either field, ask: "I couldn't determin
 python scripts/fetch_schedule.py --version "1.6"
 ```
 
+Use `--sheet-id <id>` only when the schedule lives in a different spreadsheet than the default (e.g. a fork or replacement sheet).
+
 Expected output:
 ```json
 {
@@ -57,6 +59,16 @@ Expected output:
 }
 ```
 
+If the script returns `{"error": "spreadsheet_not_found"}`, ask:
+
+> "I couldn't access the RHDH Release Schedule sheet (ID: `<spreadsheet_id>`). Please share the sheet URL or ID."
+
+Extract the spreadsheet ID from the URL — it is the long alphanumeric string between `/d/` and `/edit` (e.g., `https://docs.google.com/spreadsheets/d/<ID>/edit`). Then retry:
+
+```bash
+python scripts/fetch_schedule.py --version "1.6" --sheet-id <id>
+```
+
 If the script returns `{"error": "version_not_found"}`, ask: "I couldn't find RHDH [version] milestones in the schedule sheet. Could you confirm the exact version string as it appears in the sheet?"
 
 Use `code_freeze` and `ga_date` throughout the rest of the workflow.
@@ -341,6 +353,6 @@ After all child task decisions are collected, print a final summary of what was
 - **fixVersions format varies**: May be "1.6", "RHDH 1.6", "rhdh-1.6". Strip prefixes before passing to `fetch_schedule.py`.
 - **RHBK and Quay use doc version dropdowns**, not traditional lifecycle pages — see `references/sources.md` for extraction approach.
 - **PostgreSQL has three distinct hosting variants** (Amazon RDS, Azure DB, CloudSQL) — check each separately; EOL dates differ between providers.
-- **Schedule tab is year-based**: `fetch_schedule.py` tries current year first, then adjacent years. If the target RHDH version is in a future year, the script will still find it.
+- **Schedule tab is year-based**: `fetch_schedule.py` tries current year first, then adjacent years. If the target RHDH version is in a future year, the script will still find it. If the schedule lives in a different spreadsheet than the default, pass `--sheet-id` (error payloads include `spreadsheet_id` when lookup fails).
 - **Child task project key**: Use the same project key as the parent ticket (e.g., `RHIDP`). Extract it from the ticket ID.
 - **Child task issuetype**: Use `"Task"` — subtask creation requires `"Subtask"` on some Jira configurations. If `"Task"` with a `parent` field fails with 400, retry with `"issuetype": {"name": "Subtask"}`.

skills/rhdh-test-plan-review/scripts/fetch_schedule.py

@@ -15,9 +15,6 @@
 import re
 import sys
 from datetime import datetime
-from pathlib import Path
-
-SPREADSHEET_ID = "1knVzlMW0l0X4c7gkoiuaGql1zuFgEGwHHBsj-ygUTnc"
 
 _no_color = os.environ.get("NO_COLOR") is not None
 _is_tty = sys.stderr.isatty() and not _no_color
@@ -70,8 +67,21 @@ def get_sheets_service():
     return build("sheets", "v4", credentials=creds)
 
 
-def get_sheet_tabs(service):
-    meta = service.spreadsheets().get(spreadsheetId=SPREADSHEET_ID).execute()
+def get_sheet_tabs(service, spreadsheet_id):
+    from googleapiclient.errors import HttpError
+
+    try:
+        meta = service.spreadsheets().get(spreadsheetId=spreadsheet_id).execute()
+    except HttpError as e:
+        if e.resp.status == 404:
+            error_exit(
+                "spreadsheet_not_found",
+                {
+                    "spreadsheet_id": spreadsheet_id,
+                    "hint": "The spreadsheet was not found. Pass the correct ID with --sheet-id or share the sheet URL.",
+                },
+            )
+        raise
     return [s["properties"]["title"] for s in meta.get("sheets", [])]
 
 
@@ -195,21 +205,27 @@ def main():
         required=True,
         help="RHDH version to look up (e.g. '1.6', 'RHDH 1.6', 'rhdh-1.6')",
     )
+    parser.add_argument(
+        "--sheet-id",
+        default="1knVzlMW0l0X4c7gkoiuaGql1zuFgEGwHHBsj-ygUTnc",
+        help="RHDH Release Schedule spreadsheet ID",
+    )
     args = parser.parse_args()
 
     version = normalize_version(args.version)
+    sheet_id = args.sheet_id
     log(f"Looking up milestones for RHDH {version}...")
 
     service = get_sheets_service()
-    tabs = get_sheet_tabs(service)
+    tabs = get_sheet_tabs(service, sheet_id)
     log(f"Found tabs: {tabs}")
 
     tab = find_schedule_tab(tabs)
     if not tab:
-        error_exit("no_schedule_tab_found", {"tabs": tabs})
+        error_exit("no_schedule_tab_found", {"tabs": tabs, "spreadsheet_id": sheet_id})
 
     log(f"Reading tab: {tab}")
-    result = service.spreadsheets().values().get(spreadsheetId=SPREADSHEET_ID, range=tab).execute()
+    result = service.spreadsheets().values().get(spreadsheetId=sheet_id, range=tab).execute()
     rows = result.get("values", [])
 
     milestones = find_milestones(rows, version)
@@ -220,6 +236,7 @@ def main():
             {
                 "version": version,
                 "tab": tab,
+                "spreadsheet_id": sheet_id,
                 "hint": "Check that the version string matches the sheet exactly",
             },
         )