Use config parameter descriptions in GraphQL stored procedure args

[Anusha Kolan (anushakolan)]

Why make this change?

• Closes [Bug]: Param descriptions not surfaced in GraphQL #3500.
  • GraphQL stored-procedure argument descriptions were not honoring runtime config parameter descriptions and could show generic or database-only text. This made schema docs less useful for API consumers.
  • Additional discussion threads: [Fix]: Ensure MCP handles parameters properly #3506

What is this change?

• Updated stored-procedure GraphQL argument description resolution to use this precedence:
  • source.parameters[].description from runtime config (when present)
  • database parameter description (when present)
  • fallback text (parameters for <stored-procedure> stored-procedure)
• Added regression tests to verify config-description precedence and fallback behavior.
  • GraphQL spec reference (Descriptions): https://spec.graphql.org/October2021/#sec-Descriptions

How was this tested?

• Integration Tests
• Unit Tests

Focused unit test run:

dotnet test .\src\Service.Tests\Azure.DataApiBuilder.Service.Tests.csproj --filter "StoredProcedure_ParameterDescription_UsesConfigDescription|StoredProcedure_ParameterDescription_FallsBackToDatabaseDescription|StoredProcedure_RequiredWithDefault_KeepsDefaultValue|StoredProcedure_RequiredFlag_ProducesNonNullType"

Sample Request(s)

• Example GraphQL introspection request:

query {
  __type(name: "Mutation") {
    fields {
      name
      args {
        name
        description
      }
    }
  }
}

• Example CLI usage:

dotnet "src/out/engine/net10.0/Azure.DataApiBuilder.Service.dll" --ConfigFileName "dab-config.verify-3500.json"

[Copilot]

Pull request overview

Updates GraphQL stored-procedure argument description generation so schema docs prefer runtime config parameter descriptions, improving introspection/docs quality for API consumers (per #3500).

Changes:

• Updated GraphQLStoredProcedureBuilder to resolve argument descriptions with precedence: config description → DB/definition description → default fallback text.
• Added unit tests validating config-description precedence and DB-description fallback for stored-procedure args.

Reviewed changes

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

File	Description
src/Service.GraphQLBuilder/GraphQLStoredProcedureBuilder.cs	Applies new description precedence logic when building stored-procedure GraphQL argument definitions.
src/Service.Tests/GraphQLBuilder/Sql/StoredProcedureBuilderTests.cs	Adds regression tests for config-vs-DB description precedence on stored-procedure arguments.

[Aniruddh Munde (Aniruddh25)]

Approved, but left some questions.

[aaronburtle]

Looks good, just a couple final comments.