diff options
| -rw-r--r-- | .github/workflows/context7-refresh.yml | 54 |
1 files changed, 35 insertions, 19 deletions
diff --git a/.github/workflows/context7-refresh.yml b/.github/workflows/context7-refresh.yml index 86d92735..b21124d8 100644 --- a/.github/workflows/context7-refresh.yml +++ b/.github/workflows/context7-refresh.yml @@ -5,9 +5,12 @@ name: Context7 refresh # workflow is matched by name — DO NOT rename `Update version tags` without # updating the `workflows:` field below. # -# Context7 API addresses variants by their underlying Git branch name -# (rolling/circinus/sagitta), not by their display name (rolling/1.5/1.4). -# For the default variant (rolling) the `branch` field is OMITTED. +# Context7 API addresses variants by their TYPE: +# - default variant (rolling) → omit both `branch` and `tag` +# - tag-backed variants (1.5/1.4) → `tag: "1.5"` / `tag: "1.4"` +# - branch-backed non-default → `branch: "<name>"` (none used here) +# `branch: "1.5"` returns 404 branch_not_found; `branch: "rolling"` returns +# 400 branch-not-found. Empirically verified 2026-05-10 against the live API. # # OPERATOR NOTE: do NOT use GitHub's "Re-run jobs" on `Update version tags`. # Re-runs replay the original SHA, which would move the version tag @@ -21,16 +24,23 @@ on: types: [completed] workflow_dispatch: inputs: - branch: - description: "Source branch whose Context7 variant to refresh" + variant: + description: "Context7 variant to refresh (rolling = default; 1.5 = circinus; 1.4 = sagitta)" type: choice - options: [rolling, circinus, sagitta] + options: [rolling, "1.5", "1.4"] default: rolling permissions: {} concurrency: - group: context7-refresh-${{ inputs.branch || github.event.workflow_run.head_branch }} + group: >- + context7-refresh-${{ + (contains(fromJSON('["rolling","1.5","1.4"]'), inputs.variant) && inputs.variant) + || (github.event.workflow_run.head_branch == 'circinus' && '1.5') + || (github.event.workflow_run.head_branch == 'sagitta' && '1.4') + || (github.event.workflow_run.head_branch == 'rolling' && 'rolling') + || 'invalid' + }} cancel-in-progress: true jobs: @@ -46,7 +56,7 @@ jobs: env: CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY }} HEAD_BRANCH: ${{ github.event.workflow_run.head_branch }} - DISPATCH_BRANCH: ${{ inputs.branch }} + DISPATCH_VARIANT: ${{ inputs.variant }} run: | set -euo pipefail if [[ -z "${CONTEXT7_API_KEY:-}" ]]; then @@ -54,23 +64,29 @@ jobs: exit 1 fi if [[ "${GITHUB_EVENT_NAME}" == "workflow_dispatch" ]]; then - BRANCH="$DISPATCH_BRANCH" + VARIANT="$DISPATCH_VARIANT" else - BRANCH="$HEAD_BRANCH" + case "$HEAD_BRANCH" in + rolling) VARIANT=rolling ;; + circinus) VARIANT=1.5 ;; + sagitta) VARIANT=1.4 ;; + *) echo "Unexpected head_branch: $HEAD_BRANCH" >&2; exit 1 ;; + esac fi - case "$BRANCH" in - rolling|circinus|sagitta) ;; - *) echo "Unexpected branch: $BRANCH" >&2; exit 1 ;; + # Defense-in-depth: type:choice UI constraint is bypassable when + # workflow_dispatch is invoked via API (`gh workflow run -f variant=…`). + case "$VARIANT" in + rolling|1.5|1.4) ;; + *) echo "Invalid variant: '${VARIANT}'. Expected one of: rolling, 1.5, 1.4." >&2; exit 1 ;; esac - echo "Refreshing Context7 variant for branch: $BRANCH" - # Default variant (rolling) refreshes when `branch` is omitted; - # non-default variants address by their Git branch name. - if [[ "$BRANCH" == "rolling" ]]; then + echo "Refreshing Context7 variant: $VARIANT" + # rolling = default variant (no field). 1.5/1.4 = tag-backed. + if [[ "$VARIANT" == "rolling" ]]; then PAYLOAD="$(jq -nc --arg lib "/${{ github.repository }}" \ '{libraryName: $lib}')" else - PAYLOAD="$(jq -nc --arg lib "/${{ github.repository }}" --arg br "$BRANCH" \ - '{libraryName: $lib, branch: $br}')" + PAYLOAD="$(jq -nc --arg lib "/${{ github.repository }}" --arg tg "$VARIANT" \ + '{libraryName: $lib, tag: $tg}')" fi curl -fsSL \ --connect-timeout 10 \ |