persistent openapi specification

[kliushnichenko]

Sometimes it is useful to have your OpenAPI spec persisted in the repository (in addition to what we have in the jar). Especially nowadays, within an agentic engineering approach.

So, introducing an optional property, copyOpenApiSpecTo to the Maven plugin generating the spec.
Works only if the property is present; it copies the same output to the specified path.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.15%. Comparing base (afd4742) to head (3cb392d).
⚠️ Report is 5 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #3977      +/-   ##
============================================
- Coverage     94.17%   94.15%   -0.02%     
  Complexity     6652     6652              
============================================
  Files           432      432              
  Lines         20893    20893              
  Branches       2096     2096              
============================================
- Hits          19675    19672       -3     
- Misses          760      765       +5     
+ Partials        458      456       -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.

[jknack]

look good, we need to add the new option to gradle openapi task too.