[Do not Merge] CLI-1793: Consume Cloud API v3 OpenAPI spec in ACLI (#2011)

[deepakmishra2]

This pull request introduces initial support for Acquia Cloud API v3 (MEO) command generation, including infrastructure for handling OpenAPI 3.1+ specs, new service wiring, and improved handling of command stability and filtering. It also adds automation for updating the v3 spec and includes related tests and minor bugfixes.

Acquia Cloud API v3 support:

• Added new V3ClientService, ApiV3CommandFactory, and ApiV3CommandHelper classes to support v3 commands, which use the v3 OpenAPI spec and resolve their base URI via the new getV3BaseUri() method in CloudCredentials. These helpers override extension-field lookups and operation filtering to match v3 spec conventions. [1] [2] [3] [4]
• Registered new v3 services in config/prod/services.yml for dependency injection, ensuring v3 commands use the correct credentials and endpoints.

API command generation and stability handling:

• Refactored command generation to delegate CLI command name, stability, and filtering logic to overridable helper methods, enabling v3 and v2 to coexist and diverge as needed. Command stability is now surfaced in descriptions and as a runtime warning for non-production commands. [1] [2] [3] [4] [5]
• Improved namespace detection and filtering for command and list generation, making the logic more robust for future API versions. [1] [2] [3]

Automation and testing:

• Added a GitHub Actions workflow to automatically download, convert, and commit updates to the v3 OpenAPI spec. [1] [2]
• Added unit tests for new v3 service construction and environment variable handling. [1] [2] [3]

Bugfixes and minor improvements:

• Fixed IDE create command to return failure if the IDE is not created, and improved comments for test coverage.
• Improved namespace handling in the self-update list command for better compatibility.

[codecov]

Codecov Report

❌ Patch coverage is 98.57143% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 92.53%. Comparing base (b3ac77e) to head (a8afcf8).

Files with missing lines	Patch %	Lines
src/Command/Ide/IdeCreateCommand.php	66.66%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #2018      +/-   ##
============================================
+ Coverage     92.49%   92.53%   +0.03%     
- Complexity     1995     2018      +23     
============================================
  Files           123      126       +3     
  Lines          7238     7296      +58     
============================================
+ Hits           6695     6751      +56     
- Misses          543      545       +2     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Try the dev build for this PR: https://acquia-cli.s3.amazonaws.com/build/pr/2018/acli.phar

curl -OL https://acquia-cli.s3.amazonaws.com/build/pr/2018/acli.phar
chmod +x acli.phar

[deepakmishra2]

@copilot can you resolve the conflict?

[Copilot]

@copilot can you resolve the conflict?

Resolved. The two conflicts were:

1. src/Command/Api/ApiBaseCommand.php — took the CLI-1779 fix from main: the empty-body JSON fallback is now restricted to POST only (not PUT/PATCH), since Guzzle creates a non-seekable stream for an empty stdClass on PUT/PATCH requests.

2. tests/phpunit/src/Commands/Api/ApiCommandTest.php — kept both test methods: testPostWithBodyDoesNotSendEmptyFallback (from the feature branch) and testBodylessPutDoesNotSendEmptyJsonBody (from main), as they test complementary scenarios.