Delete schema elements that don't match target OpenSearch version.

[dblock]

Description

This change allows us to generates a merged spec that targets a specific version without all the unnecessary parts. It accomplishes a number of goals.

1. It removes fields from the spec in integration testing that have been x-version-removed before the target server version or x-version-added after, effectively testing that the values of these fields are correct.
2. It enables generating specs for a given version of OpenSearch without branching. We could publish a separate 1.x spec and a 2.x spec instead of 1 combined spec, removing the burden of having to check x-version fields from consumers of the spec. This would allow us to maintain stable releases of clients that are only compatible with OpenSearch 1.x for example with only fixes, without adding any 2.x methods to them.

npm run merge -- --opensearch-version=1.3 --output build/v1.3.yaml
npm run merge -- --opensearch-version=2.0 --output build/v2.0.yaml
diff build/v1.3.yaml build/v2.0.yaml

This removes non-matching parameters.

132a134
>         - $ref: '#/components/parameters/indices.put_alias::query.cluster_manager_timeout'

and entire operations

>     cat.templates::query.cluster_manager_timeout:
>       name: cluster_manager_timeout
>       in: query
>       description: Operation timeout for connection to cluster-manager node.
>       schema:
>         $ref: '#/components/schemas/_common:Duration'
>       x-version-added: '2.0'

Issues Resolved

Closes #425.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Changes Analysis

Commit SHA: 7cf2517
Comparing To SHA: 6fd9afe

API Changes

Summary

NO CHANGES

Report

The full API changes report is available at: https://github.com/opensearch-project/opensearch-api-specification/actions/runs/10104069658/artifacts/1742071927

API Coverage

	Before	After	Δ
Covered (%)	500 (48.97 %)	500 (48.97 %)	0 (0 %)
Uncovered (%)	521 (51.03 %)	521 (51.03 %)	0 (0 %)
Unknown	24	24	0

[github-actions]

Spec Test Coverage Analysis

Total	Tested
524	118 (22.52 %)

[dblock]

@nhtruong I think I addressed all the feedback. The updated implementation will delete all refs that don't match semver, then purge all unused refs and finally purge all objects that reference all refs that were removed for the entire resulting spec.