chore(CI): add pipeline to check sidecar version against OpenAPI spec and client code versions

[shouples]

Some cleanup to go along with confluentinc/ide-sidecar#332 to make sure our .versions/ide-sidecar.txt and OpenAPI spec version match, along with the code in the openapi-generator client code comments:

vscode/src/clients/sidecar/runtime.ts

Line 7 in f1e0bf4

* The version of the OpenAPI document: 1.0.1

Failure cases:

	.versions/ide-sidecar.txt doesn't match with the OpenAPI spec	client code doesn't match the OpenAPI spec (and we need to run gulp apigen)
Terminal output
PR comment

[semaphore-agent-production]

Sidecar Version Check Failed (ca54eea)

OpenAPI spec version mismatch:

• ide-sidecar.txt: 0.161.0 ✅
• sidecar.openapi.yaml: 1.0.1 ❌

Make sure to copy https://github.com/confluentinc/ide-sidecar/blob/v0.161.0/src/generated/resources/openapi.yaml to sidecar.openapi.yaml

[semaphore-agent-production]

Sidecar Version Check Failed (8fd6f48)

Client code version mismatch:

• ide-sidecar.txt: 0.161.0 ✅
• sidecar.openapi.yaml: 0.161.0 ✅
• runtime.ts: 1.0.1 ❌

Make sure to run gulp apigen to regenerate sidecar client code

[Copilot]

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

[Copilot]

The auto_promote condition references 'src/clients/sidecar-openapi-specs/sidecar.openapi.yaml' for the OpenAPI spec version check, but the PR description mentions validating the client code version in 'src/clients/sidecar/runtime.ts'. Please verify that the correct file is monitored for changes.

Suggested change

	when: "result = 'passed' and change_in(['.versions/ide-sidecar.txt', 'src/clients/sidecar-openapi-specs/sidecar.openapi.yaml'])"
	when: "result = 'passed' and change_in(['.versions/ide-sidecar.txt', 'src/clients/sidecar/runtime.ts'])"

[shouples]

We care more about changes to sidecar.openapi.yaml, which should be followed up by gulp apigen (which then changes clients/**/runtime.ts files). No need to explicitly check for any changes to runtime.ts here.

[rohitsanj]

Good bot, try again next time.

[rohitsanj]

This is great!! LGTM.