Fix CI: auto-discover OpenAPI spec and download in CI workflow

- Schema generator now auto-discovers .codegen/openapi.json relative to
  the repo root, removing the need for the DATABRICKS_OPENAPI_SPEC env
  var in the Makefile.
- Add explicit "Download OpenAPI spec" step to CI workflow so the spec
  is available before schema validation.
- Use curl --fail with retries instead of wget for spec download.
- Sync annotations.yml with new PLACEHOLDER entries from latest SDK.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: shreyas-goenka

.github/workflows/push.yml

@@ -284,6 +284,9 @@ jobs:
             go.sum
             bundle/internal/schema/*.*
 
+      - name: Download OpenAPI spec
+        run: make .codegen/openapi.json
+
       - name: Verify that the schema is up to date
         run: |
           if ! ( make schema && git diff --exit-code ); then

Makefile

@@ -130,11 +130,11 @@ snapshot:
 snapshot-release:
 	goreleaser release --clean --skip docker --snapshot
 
-schema: .codegen/openapi.json
-	DATABRICKS_OPENAPI_SPEC=.codegen/openapi.json go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema.json
+schema:
+	go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema.json
 
-schema-for-docs: .codegen/openapi.json
-	DATABRICKS_OPENAPI_SPEC=.codegen/openapi.json go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema_for_docs.json --docs
+schema-for-docs:
+	go run ./bundle/internal/schema ./bundle/internal/schema ./bundle/schema/jsonschema_for_docs.json --docs
 
 INTEGRATION = go run -modfile=tools/go.mod ./tools/testrunner/main.go ${GO_TOOL} gotestsum --format github-actions --rerun-fails --jsonfile output.json --packages "./acceptance ./integration/..." -- -parallel 4 -timeout=2h
 
@@ -184,7 +184,7 @@ generate:
 	go test ./bundle/internal/schema
 
 .codegen/openapi.json: .codegen/_openapi_sha
-	wget -O $@.tmp "https://openapi.dev.databricks.com/$$(cat $<)/specs/all-internal.json" && mv $@.tmp $@ && touch $@
+	curl --fail --silent --show-error --retry 3 --retry-delay 5 -L -o $@.tmp "https://openapi.dev.databricks.com/$$(cat $<)/specs/all-internal.json" && mv $@.tmp $@ && touch $@
 
 generate-direct: generate-direct-apitypes generate-direct-resources
 generate-direct-apitypes: bundle/direct/dresources/apitypes.generated.yml