From f07f919d34a28a25fcc24fc433f00ff586c62f2b Mon Sep 17 00:00:00 2001
From: Yuriy Andamasov <yuriy@vyos.io>
Date: Fri, 14 Aug 2026 15:59:52 +0300
Subject: T9208: add scutum to docs CI branch enumerations (#2199)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* T9208: add scutum to docs CI branch enumerations

The scutum docs branch (VyOS 1.6 train) was cut from circinus on
2026-08-13. Register it in the branch enumerations that gate CI on the
default branch:

- context7-refresh.yml: add scutum to the push-trigger branch list, the
  workflow_dispatch choice options and the defence-in-depth variant
  allow-list, so a docs push on scutum refreshes its own Context7
  variant instead of being dropped.
- context7.json: add a `scutum` entry to `previousVersions`. Context7
  registers branch variants from this file on the default branch; a
  refresh with `branch: "scutum"` 404s until that registration exists.

Enumerations only — no behaviour change for the existing rolling,
circinus and sagitta variants.

🤖 Generated by [robots](https://vyos.io)

* T9208: add scutum to the context7 branch-to-version mapping rule

The previousVersions entry registers the scutum variant, but the
branch-to-version mapping rule Context7 feeds to the model still jumped
straight from rolling to circinus and claimed rolling covers "1.6+" —
the version scutum now serves. Add the scutum row and drop the stale
version claim from rolling so the rule matches the variant list.

Caught by adversarial review on 2b10f78.
---
 .github/workflows/context7-refresh.yml | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

(limited to '.github/workflows')

diff --git a/.github/workflows/context7-refresh.yml b/.github/workflows/context7-refresh.yml
index c4c33635..2999865f 100644
--- a/.github/workflows/context7-refresh.yml
+++ b/.github/workflows/context7-refresh.yml
@@ -1,12 +1,13 @@
 name: Context7 refresh
 
 # Refreshes the Context7 variant for the pushed branch. Context7 indexes
-# three variants of this library, all tracking a branch HEAD directly:
+# four variants of this library, all tracking a branch HEAD directly:
 #   - rolling  → default variant       (omit both `branch` and `tag`)
+#   - scutum   → branch variant        `branch: "scutum"`   (VyOS 1.6)
 #   - circinus → branch variant        `branch: "circinus"` (VyOS 1.5)
 #   - sagitta  → branch variant        `branch: "sagitta"`  (VyOS 1.4)
 #
-# The circinus/sagitta variants are declared as branch entries in
+# The scutum/circinus/sagitta variants are declared as branch entries in
 # context7.json `previousVersions`. There is no longer any git-tag
 # indirection — Context7 re-crawls the branch HEAD on refresh, so the
 # variant always reflects current branch content.
@@ -16,7 +17,7 @@ name: Context7 refresh
 # README, etc.) never trigger a refresh — Context7 only ingests `docs/**`
 # (per context7.json `folders`) plus the config file itself.
 #
-# NOTE: circinus/sagitta must be registered as BRANCH variants in the
+# NOTE: scutum/circinus/sagitta must be registered as BRANCH variants in the
 # Context7 dashboard (driven by the context7.json `previousVersions`
 # branch entries on the default branch). A refresh with `branch: "<name>"`
 # returns 404 until Context7 has crawled the config and registered the
@@ -26,6 +27,7 @@ on:
   push:
     branches:
       - rolling
+      - scutum
       - circinus
       - sagitta
     paths:
@@ -34,9 +36,9 @@ on:
   workflow_dispatch:
     inputs:
       variant:
-        description: "Context7 variant to refresh (rolling = default; circinus = 1.5; sagitta = 1.4)"
+        description: "Context7 variant to refresh (rolling = default; scutum = 1.6; circinus = 1.5; sagitta = 1.4)"
         type: choice
-        options: [rolling, circinus, sagitta]
+        options: [rolling, scutum, circinus, sagitta]
         default: rolling
 
 permissions: {}
@@ -75,11 +77,11 @@ jobs:
           # Defense-in-depth: the type:choice UI constraint is bypassable when
           # workflow_dispatch is invoked via API (`gh workflow run -f variant=…`).
           case "$VARIANT" in
-            rolling|circinus|sagitta) ;;
-            *) echo "Invalid variant: '${VARIANT}'. Expected one of: rolling, circinus, sagitta." >&2; exit 1 ;;
+            rolling|scutum|circinus|sagitta) ;;
+            *) echo "Invalid variant: '${VARIANT}'. Expected one of: rolling, scutum, circinus, sagitta." >&2; exit 1 ;;
           esac
           echo "Refreshing Context7 variant: $VARIANT"
-          # rolling = default variant (no field). circinus/sagitta = branch-backed.
+          # rolling = default variant (no field). scutum/circinus/sagitta = branch-backed.
           if [[ "$VARIANT" == "rolling" ]]; then
             PAYLOAD="$(jq -nc --arg lib "/$REPO" \
               '{libraryName: $lib}')"
-- 
cgit v1.2.3