[Repo Assist] improve: surface schema description as XmlDoc on generated object and enum types (+5 tests, 348→353)

[github-actions]

🤖 This PR was created by Repo Assist, an automated AI assistant.

Summary

Properties and operation methods already carry TypeProviderXmlDocAttribute from their schema description fields, giving IDE tooltips for individual members. However, the generated types themselves (object types and CLI enum types) did not receive any XmlDoc — even when the component schema had a top-level description.

This PR adds that missing step:

• Object types: after creating the ProvidedTypeDefinition, call AddXmlDoc when schemaObj.Description is non-null/non-whitespace.
• Named enum types: same treatment, applied immediately after SetEnumUnderlyingType.

Example

components:
  schemas:
    Status:
      type: string
      description: "The lifecycle status of an item"
      enum: [active, inactive, pending]
    Pet:
      type: object
      description: "A pet registered in the system"
      properties:
        name:
          type: string
```

After this change, hovering over `Status` or `Pet` in F# code will show the description in IDE tooltips, consistent with the existing behaviour for their properties/members.

## Changes

| File | Change |
|------|--------|
| `src/SwaggerProvider.DesignTime/DefinitionCompiler.fs` | Add `AddXmlDoc` call after object type creation and enum type creation |
| `tests/SwaggerProvider.Tests/Schema.XmlDocTests.fs` | +5 `[<Fact>]` tests covering object types and enum types with/without descriptions |

## Test Status

Build succeeded; all **353 tests pass** (up from 348 before this change, +5 new tests).

```
=== TEST EXECUTION SUMMARY ===
   SwaggerProvider.Tests  Total: 353, Errors: 0, Failed: 0, Skipped: 1, Not Run: 0, Time: 1.065s

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

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@3de4e604a36b5190a1c7dc4719c7341500ba8a95

[Copilot]

Pull request overview

Adds missing type-level XmlDoc generation so top-level OpenAPI schema description fields surface in IDE tooltips for generated object and named enum types, aligning type tooltips with existing member-level XmlDoc behavior.

Changes:

• Add AddXmlDoc for generated object types when schemaObj.Description is present.
• Add AddXmlDoc for generated top-level named enum types (string/int) when schemaObj.Description is present.
• Add 5 tests validating XmlDoc presence/absence on generated types.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
src/SwaggerProvider.DesignTime/DefinitionCompiler.fs	Attaches schema description as XmlDoc on generated object and named enum types.
tests/SwaggerProvider.Tests/Schema.XmlDocTests.fs	Adds coverage ensuring type-level XmlDoc is emitted only when descriptions exist.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sergey-tihon]

@copilot fix formatting and build

[Copilot]

@copilot fix formatting and build

Fixed in 5e1941e — applied Fantomas formatting to DefinitionCompiler.fs. All 353 tests pass.