rhdh-plugin-catalog-index-status-and-update-flow

Plugin catalog index status and update

Bring one release's downstream plugin catalog index current, and say what is still blocked. Supported plugins only. The index this skill publishes is quay.io/rhdh/plugin-catalog-index.

Run scripts/catalog_index_status.py by path. It prints JSON and does not prompt, commit, or push.

Gate

Run check-login before resolving a version, fetching status, or touching git. A refused login stops the skill. Load references/konflux-wait.md and wait until the user has an oc session.

Resolve

Ask for x.y.z or a branch (main, release-2.1) when the user named neither. Then:

python3 scripts/catalog_index_status.py resolve --branch <branch> --version <x.y.z> --catalog-root <worktree>

Pass whichever half the user gave. The script reads version from redhat-developer/rhdh package.json on that branch, and uses release-X.Y when that catalog branch exists, otherwise main.

Use a git worktree of gitlab.cee.redhat.com:rhidp/rhdh-plugin-catalog on the resolved branch. Clone the repo when it is not on disk. Leave the user's current checkout where it is.

Report

python3 scripts/catalog_index_status.py report \
  --catalog-root <worktree> \
  --downstream <worktree>/docs/catalog-status.md \
  --branch <branch> \
  --version <x.y.z>

Load references/status-pages.md to act on the JSON.

Respin rows: run each command from the worktree. That commits .tekton/ PipelineRuns and does not push.
Sync rows: show syncCommand and stop. Running sync-midstream.sh is a later session.
Report-only rows: include them in the summary. They do not start a Konflux build.

Push

Invoke /mutation-gate before git push of the catalog branch. Name the branch, show git status and git diff --cached, and say that a pushed PipelineRun commit cannot be undone because Konflux starts the build. The user's request to inspect status does not approve the push.

After an authorized push, open konfluxUrl and run wait-runs from references/konflux-wait.md. Then confirm the requested tags with skopeo inspect docker://<ref>. Still missing, failed, or timed out: report the Konflux link, the Quay links, and syncCommand when workspaces are behind.

When respin and sync are both empty, ask before ./build/ci/update-index.sh with the indexFlags from resolve and --nopush. Ask separately, default no, for --allow-fallback-tag and --allow-version-regression. Push that commit only through another /mutation-gate approval. /mutation-gate returns the approved operation list; run only that list.

Completion

The user has a JSON report for the branch, any local commits are unpushed unless a gate approval pushed them, PipelineRun reasons are Succeeded or an explicit failure with log paths, and the downstream index command was either skipped or run with --nopush until a second approval.