Remove SwaggerClientProvider

[sergey-tihon]

• Remove SwaggerClientProvider
• Update doc
• Remove v2 compiler/definition compiler
• Remove tests cases specific to v2
• Update Readme
• Simplify folder structure (v2/v3 sub-folders are no longer needed)

[sergey-tihon]

/repo-assist help with this

[github-actions]

✓ Repo Assist completed successfully, see workflow run.

[github-actions]

Pull request created: #377

Generated by 🌈 Repo Assist, see workflow run. Learn more.

[github-actions]

🤖 This is an automated response from Repo Assist.

I've put together a draft PR for this issue: the PR removes SwaggerClientProvider, all v2 compiler code, and flattens the folder structure as requested.

What's included:

• Removed SwaggerClientProvider and the custom Swagger 2.0 parser/compiler (~1,700 lines)
• Removed v2-specific provider tests (11 files) and unit tests (4 files)
• Moved v3 compiler files (DefinitionCompiler.fs, OperationCompiler.fs) to the project root
• Renamed namespace SwaggerProvider.Internal.v3.Compilers → SwaggerProvider.Internal.Compilers
• Flattened Schemas/v2/ and Schemas/v3/ into a single Schemas/ directory
• Removed docs/SwaggerClientProvider.md and updated docs/index.html

All 257 unit tests pass. OpenApiClientProvider handles both v2 and v3 schemas via Microsoft.OpenApi so no functionality is lost.

One note: gettyimages.com.json was moved to unsupported/ because it triggers a pre-existing type-name collision in the DefinitionCompiler — unrelated to this PR.

Generated by 🌈 Repo Assist, see workflow run. Learn more.

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@97143ac59cb3a13ef2a77581f929f06719c7402a