refactor: replace cross-skill symlinks with gog CLI and local copies

Remove all 3 symlinks (gcloud_token.py, check_gsheets.py, formatters.py)
that depended on rhdh-test-plan-review and rhdh skills being co-installed.
Replace Google SDK/gcloud auth with gog CLI for Sheets and Docs access.
Replace stale release-process.md copy with live `gog docs cat` reference.
Add _find_parse_issues() discovery for rhdh-jira skill at runtime.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: durandom

.gitignore

@@ -27,6 +27,9 @@ htmlcov/
 .DS_Store
 Thumbs.db
 
+# OAuth credentials
+client_secret*.json
+
 # uv
 .python-version
 

skills/rhdh-release/SKILL.md

@@ -6,7 +6,7 @@ description: |
   "release dates", "release status", "feature freeze", "code freeze",
   "blocker bugs", "CVEs", "release notes", "team breakdown", or any
   RHDH release management question.
-compatibility: "acli on PATH. Python 3 + gcloud CLI for Google Sheets."
+compatibility: "acli on PATH. Python 3 + gog CLI for Google Sheets/Docs."
 ---
 
 <essential_principles>
@@ -109,8 +109,8 @@ What would you like to do?
 |-----------|---------|-----------|
 | `references/jql-release.md` | 12 release-specific JQL templates | Any Jira query for release data |
 | `references/slack-templates.md` | 4 Slack announcement templates | Generating freeze announcements |
-| `references/config.md` | GDrive IDs, project keys, dashboards | Looking up config values or links |
-| `references/release-process.md` | Y-stream/Z-stream lifecycle, checklists | Release process questions, onboarding |
+| `references/config.md` | GDrive IDs, project keys, dashboards, gog setup | Looking up config values or links |
+| `gog docs cat 13OkypJ3u_7Jq6kEhKhjEFwHQ12oPFDKXVzFjYW4XLdk` | Release process (live Google Doc) | Release process questions, onboarding |
 | `../../rhdh-jira/references/auth.md` | Jira auth setup | Jira prerequisite fails |
 | `../../rhdh-jira/references/acli-commands.md` | acli command reference | Building acli commands |
 
@@ -123,6 +123,6 @@ What would you like to do?
 | Requirement | Check | Fix |
 |-------------|-------|-----|
 | **Jira CLI** | `acli jira workitem search --jql "project=RHIDP" --count` succeeds | Load `../../rhdh-jira/SKILL.md` Prerequisites |
-| **Google Sheets** (for team/schedule data) | `python scripts/check_gsheets.py` → exit 0 | Run `gcloud auth login --enable-gdrive-access` |
+| **gog CLI** (for Google Sheets/Docs) | `gog sheets metadata 1vQXfvID72qwqvLb17eyGOvnZXrZG7NBzTGv6RP9wvyM --json` succeeds | Install gog and run `gog auth add <email>` |
 
 </prerequisites>

skills/rhdh-release/references/config.md

@@ -1,6 +1,6 @@
 # Release Manager Configuration
 
-Static configuration values for the RHDH Release Manager skill. For dashboards, key documents, and Jira project descriptions, see `release-process.md`.
+Static configuration values for the RHDH Release Manager skill.
 
 ## JQL Scope
 
@@ -14,3 +14,14 @@ Static configuration values for the RHDH Release Manager skill. For dashboards,
 |-----|-------|-------------|
 | `team_mapping_gdrive_id` | `1vQXfvID72qwqvLb17eyGOvnZXrZG7NBzTGv6RP9wvyM` | RHDH Team Mapping spreadsheet (sheet: "Team") |
 | `release_schedule_gdrive_id` | `1knVzlMW0l0X4c7gkoiuaGql1zuFgEGwHHBsj-ygUTnc` | RHDH Release Schedule spreadsheet |
+| `release_process_doc_id` | `13OkypJ3u_7Jq6kEhKhjEFwHQ12oPFDKXVzFjYW4XLdk` | Release process Google Doc |
+
+## gog CLI Setup
+
+Google Sheets and Docs access uses the [gog CLI](https://gogcli.sh).
+
+1. Install: `brew install gogcli` (requires Homebrew; `brew trust openclaw/tap` if prompted)
+2. Get OAuth credentials: request `client_secret.json` from <mhild@redhat.com>
+3. Import credentials: `gog auth credentials client_secret.json`
+4. Authenticate: `gog auth add <your-email> --services sheets,docs,drive`
+5. Verify: `gog sheets metadata 1vQXfvID72qwqvLb17eyGOvnZXrZG7NBzTGv6RP9wvyM --json`

skills/rhdh-release/references/release-process.md

@@ -1,27 +1,12 @@
-#!/usr/bin/env -S uv run --script
-# /// script
-# requires-python = ">=3.10"
-# dependencies = [
-#   "google-api-python-client>=2.0",
-#   "google-auth>=2.0",
-#   "google-auth-httplib2>=0.2",
-# ]
-# ///
-# Note: uses uv run --script for Google API deps (see ADR-0002 for stdlib-only rationale;
-# Google Sheets SDK is an intentional exception)
-"""Fetch RHDH team mapping from the Team spreadsheet."""
+#!/usr/bin/env python3
+"""Fetch RHDH team mapping from the Team spreadsheet via gog CLI."""
 
 import argparse
 import json
 import os
+import shutil
+import subprocess
 import sys
-from pathlib import Path
-
-_scripts_dir = Path(__file__).resolve().parent
-if str(_scripts_dir) not in sys.path:
-    sys.path.insert(0, str(_scripts_dir))
-
-from gcloud_token import get_gcloud_token  # noqa: E402
 
 _no_color = os.environ.get("NO_COLOR") is not None
 _is_tty = sys.stderr.isatty() and not _no_color
@@ -44,24 +29,35 @@ def error_exit(error_key, extra=None):
     sys.exit(1)
 
 
-def get_sheets_service():
-    from google.oauth2.credentials import Credentials
-    from googleapiclient.discovery import build
+def fetch_sheet_values(sheet_id, sheet_name):
+    """Fetch sheet values via gog sheets get --json --results-only."""
+    gog = shutil.which("gog")
+    if not gog:
+        error_exit("gog_not_found", {"hint": "Install gog CLI: https://github.com/thediveo/gog"})
 
-    token, gcloud_err = get_gcloud_token()
-    if not token:
-        if gcloud_err and "PATH" in gcloud_err:
+    result = subprocess.run(
+        ["gog", "sheets", "get", sheet_id, sheet_name, "--json", "--results-only"],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        stderr = result.stderr.strip()
+        if "accessNotConfigured" in stderr:
             error_exit(
-                "gcloud_not_found",
-                {"hint": "Install the Google Cloud CLI and ensure gcloud is on your PATH"},
+                "sheets_api_disabled",
+                {"hint": "Enable Google Sheets API in your gog OAuth project"},
             )
-        error_exit(
-            "credentials_not_found",
-            {"hint": "Run 'gcloud auth login --enable-gdrive-access' to authenticate"},
-        )
+        if "404" in stderr or "not found" in stderr.lower():
+            error_exit(
+                "spreadsheet_not_found",
+                {
+                    "spreadsheet_id": sheet_id,
+                    "hint": "The spreadsheet was not found. Pass the correct ID with --sheet-id.",
+                },
+            )
+        error_exit("gog_error", {"stderr": stderr})
 
-    creds = Credentials(token=token)
-    return build("sheets", "v4", credentials=creds)
+    return json.loads(result.stdout)
 
 
 def parse_teams(rows, category_filter=None, include_all=False):
@@ -163,29 +159,7 @@ def main():
 
     log("Fetching team mapping...")
 
-    service = get_sheets_service()
-
-    from googleapiclient.errors import HttpError
-
-    try:
-        result = (
-            service.spreadsheets()
-            .values()
-            .get(spreadsheetId=args.sheet_id, range=args.sheet_name)
-            .execute()
-        )
-    except HttpError as e:
-        if e.resp.status == 404:
-            error_exit(
-                "spreadsheet_not_found",
-                {
-                    "spreadsheet_id": args.sheet_id,
-                    "hint": "The spreadsheet was not found. Pass the correct ID with --sheet-id.",
-                },
-            )
-        raise
-
-    rows = result.get("values", [])
+    rows = fetch_sheet_values(args.sheet_id, args.sheet_name)
     if not rows:
         error_exit("empty_sheet", {"sheet_name": args.sheet_name})