Add contract-derived OpenAPI operation metadata

[Copilot]

Generated mediator endpoints lacked stable OpenAPI tags and operation IDs, producing flat API documentation and unreliable generated client method names. gRPC grouping also did not share HTTP taxonomy.

• Contract metadata
  • Added transport-neutral [ApiTag("...")].
  • Defaults tags to the contract namespace’s final segment.
• Minimal API generator
  • Emits .WithTags(...) and .WithName(...) for all endpoint shapes.
  • Adds version suffixes for expanded endpoints.
  • Reports ARKMF016 for duplicate operation names.
• gRPC generator
  • Uses [ApiTag] as the service-group fallback; [ServiceGroup] remains authoritative.
• Coverage
  • Updated sample contracts, generator tests, design documentation, and progress tracking.

[ApiTag("Greetings")]
[HttpEndpoint("GET", "/api/v{version}/greetings/{id}")]
public sealed record GetGreetingQuery : IQuery<GreetingResponse>;

[Copilot]

Pull request overview

Adds transport-neutral, contract-derived API taxonomy so generated HTTP + gRPC surfaces share stable grouping and operation naming, improving OpenAPI output and downstream client generation stability.

Changes:

• Introduces [ApiTag("...")] with namespace-last-segment defaulting.
• Minimal API generator now emits .WithTags(...) + .WithName(...) for all endpoints and reports ARKMF016 on duplicate operation names.
• gRPC generator uses [ApiTag] as the fallback service grouping when [ServiceGroup] is absent; docs/tests updated accordingly.

Reviewed changes

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

Show a summary per file

File	Description
tests/Ark.Tools.MediatorFramework.Tests/GeneratorSnapshotTests.cs	Extends generator snapshot coverage for tags, operation names, duplicate detection, and gRPC fallback grouping.
src/mediator-framework/Ark.Tools.MediatorFramework/ApiTagAttribute.cs	Adds new public attribute to override default API tag/group derivation.
src/mediator-framework/Ark.Tools.MediatorFramework.MinimalApi.Generators/MinimalApiEndpointGenerator.cs	Emits OpenAPI metadata (tags/name) and adds ARKMF016 duplicate operation name diagnostic.
src/mediator-framework/Ark.Tools.MediatorFramework.Grpc.Generators/GrpcEndpointGenerator.cs	Uses [ApiTag] as grouping fallback when [ServiceGroup] is not present.
samples/Ark.MediatorFramework.Sample/src/Ark.MediatorFramework.Sample.Application/GreetingContracts.cs	Updates sample contract to demonstrate tagging.
docs/mediator-framework/progress/tasks/README.md	Marks NET-06 as completed in progress tracking.
docs/mediator-framework/progress/tasks/aspnetcore/NET-06-openapi-tags-operation-names.md	Checks off acceptance criteria for NET-06 task.
docs/mediator-framework/progress/tasks.md	Marks T12.1 as completed.
docs/mediator-framework/design.md	Documents [ApiTag] behavior and new diagnostic ARKMF016.

---

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