fix(release): let description-only CRD changes into the backport batch, keep new API fields out - #5251

sed -n '1,280p' internal/apigate/schemadiff.go; rg -n 'allOf|anyOf|oneOf|openAPISchema' internal/apigate pkg/apiserver docs/release/backports.md docs/release/backport-mechanics.md | head -100

git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- cmd/backport-batch/apisurface.go cmd/backport-batch/rules.go docs/release/backports.md docs/release/backport-mechanics.md
nl -ba cmd/backport-batch/apisurface.go | sed -n '1,270p'
nl -ba cmd/backport-batch/rules.go | sed -n '130,460p'
rg -n -F -e 'touchesRule' -e 'ruleTouches' -e 'addedAPIField' -e 'sizeableAPIChange' -- cmd/backport-batch
rg -n -F -e 'func Classify' -e 'SourceApplication' -e 'OpenAPISchema' -- internal/apigate pkg/registry pkg/apiserver pkg/apis/apps

nl -ba internal/apigate/classify.go
nl -ba internal/apigate/parse.go | sed -n '1,200p'
nl -ba internal/apigate/schemadiff.go | sed -n '75,205p'
nl -ba cmd/backport-batch/main.go | sed -n '310,410p'
nl -ba cmd/backport-batch/README.md | sed -n '45,85p'
rg -n -F -e 'buildSpecSchema' -e 'specSchema' -e 'NewStructural' -e 'ValidateStructural' -- pkg/registry/apps pkg/apis
rg -n -F -e 'openAPISchema' -e 'ApplicationDefinition' -- pkg/apis/apps/validation pkg/registry/apps/application | sed -n '1,160p'

nl -ba pkg/registry/apps/application/rest.go | sed -n '85,175p'
nl -ba pkg/registry/apps/application/rest_defaulting.go | sed -n '1,140p'
rg -n -F -e 'OpenAPISchema' -e 'openAPISchema' -- pkg internal api | sed -n '1,220p'
rg -n -F -e 'k8s.io/apiextensions-apiserver ' -e 'k8s.io/apiserver ' -e 'k8s.io/kube-openapi ' -- go.mod
rg -n -F -e 'allOf' -e 'anyOf' -e 'oneOf' -- packages/system/*-rd/cozyrds | sed -n '1,100p'

ast-grep outline pkg/cmd/server/openapi.go --view expanded
nl -ba pkg/cmd/server/openapi.go | sed -n '1,230p'
nl -ba pkg/cmd/server/openapi.go | sed -n '230,450p'
nl -ba pkg/cmd/server/start.go | sed -n '370,430p'
nl -ba api/v1alpha1/applicationdefinitions_types.go | sed -n '40,80p'
rg -n -F -e 'KindSchemasFromConfig' -e 'BuildOpenAPI' -e 'openapi' -- pkg/cmd/server/start.go pkg/cmd/server/openapi.go

nl -ba pkg/cmd/server/start.go | sed -n '440,465p'
nl -ba pkg/cmd/server/openapi.go | sed -n '437,458p'
nl -ba docs/release/backports.md | sed -n '11,25p'
nl -ba internal/apigate/schemadiff_test.go | sed -n '245,275p'
ls "$(go env GOPATH 2>/dev/null)/pkg/mod/k8s.io/" 2>/dev/null || :

openapi="$(go env GOPATH)/pkg/mod/k8s.io/[email protected]/pkg/validation/spec/schema.go"
convert="$(go env GOPATH)/pkg/mod/k8s.io/[email protected]/pkg/apiserver/schema/convert.go"
rg -n -F -e 'type SchemaProps struct' -e 'func (s *Schema) UnmarshalJSON' -e 'func (s Schema) MarshalJSON' "$openapi"
nl -ba "$openapi" | sed -n '155,285p'
rg -n -F -e 'func newValueValidation' -e 'func newNestedValueValidation' -e 'func validateUnsupportedFields' "$convert"
nl -ba "$convert" | sed -n '20,140p'
nl -ba "$convert" | sed -n '160,330p'

f="$(go env GOPATH)/pkg/mod/k8s.io/[email protected]/pkg/validation/spec/schema.go"
nl -ba "$f" | sed -n '475,650p'

rg -n 'tpl|Files.Get|files/crds' packages/system/vertical-pod-autoscaler packages 2>/dev/null | head -120

git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- cmd/backport-batch/rules.go cmd/backport-batch/apisurface.go cmd/backport-batch/README.md docs/release/backports.md
printf '\n--- rules source ---\n'
nl -ba cmd/backport-batch/rules.go | sed -n '1,470p'
printf '\n--- api surface source ---\n'
nl -ba cmd/backport-batch/apisurface.go | sed -n '1,280p'
printf '\n--- chart installation ---\n'
nl -ba packages/system/vertical-pod-autoscaler/charts/vertical-pod-autoscaler/templates/crds/configmap.yaml
nl -ba packages/system/vertical-pod-autoscaler/charts/vertical-pod-autoscaler/templates/crds/job.yaml
printf '\n--- chart CRD header ---\n'
nl -ba packages/system/vertical-pod-autoscaler/charts/vertical-pod-autoscaler/files/crds/verticalpodautoscalers.yaml | sed -n '1,90p'

printf '%s\n' '--- rule and comparison ---'
nl -ba cmd/backport-batch/rules.go | sed -n '45,275p'
nl -ba cmd/backport-batch/rules.go | sed -n '290,446p'
printf '%s\n' '--- selection references ---'
rg -n -F -e 'touchesRule(' -e 'ruleTouches' -- cmd/backport-batch
printf '%s\n' '--- API loader candidates ---'
rg -n -F -e 'LoadSnapshot' -e 'cozystack.io' -e 'CustomResourceDefinition' -- internal/apigate
printf '%s\n' '--- relevant tests ---'
rg -n -F -e 'template' -e 'description' -e 'CRD' -- cmd/backport-batch/rules_test.go | sed -n '1,160p'
printf '%s\n' '--- VPA defaults ---'
rg -n -F -e 'crds:' -e 'enabled:' -- packages/system/vertical-pod-autoscaler/charts/vertical-pod-autoscaler/values.yaml | sed -n '1,80p'
printf '%s\n' '--- documentation ---'
nl -ba cmd/backport-batch/README.md | sed -n '60,78p'
nl -ba docs/release/backports.md | sed -n '1,35p'

printf '%s\n' '--- API parse and discovery ---'
nl -ba internal/apigate/parse.go | sed -n '75,162p'
rg -n -F -e 'ParseCRDs(' -e 'isCozystack' -e 'cozystack.io' -- internal/apigate/snapshot.go internal/apigate/parse.go
nl -ba internal/apigate/snapshot.go | sed -n '1,250p'
printf '%s\n' '--- selection ---'
nl -ba cmd/backport-batch/main.go | sed -n '310,405p'
printf '%s\n' '--- Helm declaration ---'
rg -n -i -e 'helmVersion|helm-version|helm.sh/helm|helm/v3|helm version' -- go.mod go.sum .github/workflows packages/system/vertical-pod-autoscaler/Makefile | sed -n '1,80p'
printf '%s\n' '--- default VPA install ---'
nl -ba packages/system/vertical-pod-autoscaler/charts/vertical-pod-autoscaler/values.yaml | sed -n '902,925p'
printf '%s\n' '--- standalone Go text/template action probe ---'
if command -v go >/dev/null; then
 tmp=$(mktemp -d)
 cat > "$tmp/main.go" <<'EOF'
package main
import ("os"; "text/template")
func main() {
 s := "type: object\nproperties:\n  labels:\n    type: object\n    description: |-\n      {{ printf \"Labels.\\n    maxProperties: %d\" 2 }}\n    additionalProperties:\n      type: string\n"
 t := template.Must(template.New("probe").Parse(s))
 if err := t.Execute(os.Stdout,nil); err != nil { panic(err) }
}
EOF
 (cd "$tmp" && GOWORK=off GO111MODULE=off go run main.go)
 rm -rf "$tmp"
else echo 'go unavailable'; fi
printf '%s\n' '--- standalone YAML parser availability ---'
python3 - <<'PY'
try:
 import yaml
 print("PyYAML", yaml.__version__)
 s='''type: object
properties:
  labels:
    type: object
    description: |-
      {{ printf "Labels.\\n    maxProperties: %d" 2 }}
    additionalProperties:
      type: string
'''
 r='''type: object
properties:
  labels:
    type: object
    description: |-
      Labels.
    maxProperties: 2
    additionalProperties:
      type: string
'''
 print('source:', yaml.safe_load(s))
 print('rendered:', yaml.safe_load(r))
except ImportError:
 print('PyYAML unavailable')
PY

git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- cmd/backport-batch/rules.go
nl -ba cmd/backport-batch/rules.go | sed -n '120,455p'
rg -n -F -e 'withoutDescriptions' -e 'crdContent' -e 'anyOf' -e 'description' -- cmd/backport-batch/rules_test.go cmd/backport-batch/README.md docs/release/backport-mechanics.md docs/release/backports.md

rg -n -F -e 'touchesRule(' -e 'rule 4' -e 'Rule 4' -- cmd/backport-batch
nl -ba cmd/backport-batch/rules_test.go | sed -n '115,320p'
nl -ba cmd/backport-batch/rules_test.go | sed -n '600,705p'
nl -ba cmd/backport-batch/README.md | sed -n '45,74p'

nl -ba cmd/backport-batch/main.go | sed -n '315,405p'
nl -ba cmd/backport-batch/rules_test.go | sed -n '75,115p;307,330p'
nl -ba docs/release/backports.md | sed -n '10,26p'

git show d61db784a644ae13e96f08d6b3c0b7df9418c1a0:docs/release/backports.md | nl -ba | sed -n '11,23p'
git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- docs/release/backports.md

git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- docs/release/backport-mechanics.md docs/release/backports.md cmd/backport-batch/rules.go cmd/backport-batch/apisurface.go
printf '\n--- policy ---\n'
nl -ba docs/release/backports.md | sed -n '1,180p'
printf '\n--- mechanics ---\n'
nl -ba docs/release/backport-mechanics.md | sed -n '1,110p'
printf '\n--- candidate filters ---\n'
rg -n -F -e 'testdata' -e 'tests/' -e 'Rule 4' -e 'rule 4' -- cmd/backport-batch docs/release

nl -ba cmd/backport-batch/rules.go | sed -n '80,275p'
nl -ba cmd/backport-batch/apisurface.go | sed -n '35,175p'
nl -ba cmd/backport-batch/rules_test.go | sed -n '75,195p'
nl -ba cmd/backport-batch/README.md | sed -n '60,74p'
git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- cmd/backport-batch/rules_test.go | sed -n '1,120p'

nl -ba cmd/backport-batch/rules.go | sed -n '270,310p'
nl -ba cmd/backport-batch/rules_test.go | sed -n '290,345p'

git diff d61db784a644ae13e96f08d6b3c0b7df9418c1a0 aea61f7f967e7e299304e7b81ac640c40d9da627 -- docs/release/backport-mechanics.md docs/release/backports.md cmd/backport-batch/apisurface.go cmd/backport-batch/rules.go cmd/backport-batch/README.md
printf '\n--- docs ---\n'
nl -ba docs/release/backport-mechanics.md | sed -n '1,90p'
nl -ba docs/release/backports.md | sed -n '1,130p'
printf '\n--- relevant code references ---\n'
rg -n -i -e 'description' -e 'template action' -e 'crd' cmd/backport-batch/{apisurface.go,rules.go,rules_test.go,README.md}

nl -ba docs/release/backport-mechanics.md | sed -n '1,35p'
nl -ba docs/release/backports.md | sed -n '1,100p'
nl -ba cmd/backport-batch/rules.go | sed -n '140,245p'
nl -ba cmd/backport-batch/rules.go | sed -n '250,270p;300,400p;415,450p'
nl -ba cmd/backport-batch/rules_test.go | sed -n '110,155p;280,315p;690,716p'
rg -n -F -e 'touchesRule(' -e 'rule 4' cmd/backport-batch --glob '*.go'