Schema/CLI Mismatch: Default Values & Descriptions (Group 2)

[souvikghosh04]

Group 2: Schema/CLI Mismatch — Default Values & Descriptions

This parent issue tracks 14 bugs where CLI --help text showed incorrect defaults, wrong descriptions, or enum mismatches compared to the JSON schema.

RCA: Default values and descriptions were maintained independently in three places: JSON schema, C# object model constants, and CLI HelpText with no automated check to keep them in sync.

Additionally, 5 Group 4 issues are resolved as overlaps.

Child Issues

• [Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.read-records #3347 — runtime.mcp.dml-tools.read-records default mismatch
• [Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.create-record #3348 — runtime.mcp.dml-tools.create-record default mismatch
• [Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.describe-entities #3349 — runtime.mcp.dml-tools.describe-entities default mismatch
• [Bug]: Schema/Cli mismatch runtime.graphql.multiple-mutations.create.enabled #3350 — runtime.graphql.multiple-mutations.create.enabled default mismatch
• [Bug]: Schema/Cli mismatch runtime.host.mode #3351 — runtime.host.mode default mismatch
• [Bug]: Schema/Cli mismatch data-source.options.set-session-context #3352 — data-source.options.set-session-context misleading default
• [Bug]: Schema/Cli mismatch runtime.rest.request-body-strict #3353 — runtime.rest.request-body-strict default mismatch (init)
• [Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.aggregate-records #3354 — runtime.mcp.dml-tools.aggregate-records schema internal conflict
• [Bug]: Schema/Cli mismatch otel-service-name #3355 — --otel-service-name wrong description
• [Bug]: Schema/Cli mismatch dab add-telemetry #3356 — dab add-telemetry defaults shown twice
• [Bug]: Schema/Cli mismatch runtime.graphql.depth-limit #3357 — runtime.graphql.depth-limit description mismatch
• [Bug]: Schema/Cli mismatch ENUM --database-type #3358 — --database-type lists dwsql not in schema
• [Bug]: Schema/Cli mismatch ENUM dab configure --data-source.database-type #3359 — --database-type missing cosmosdb_postgresql (already fixed in PR Add missing CLI options for dab configure, add, and update #3409)
• [Bug]: CLI/Schema ENUM mismatch #3360 — --database-type uppercase casing mismatch

Group 4 Overlaps (also fixed)

• [Bug]: Invalid defaults rest.request-body-strict #3378 — rest.request-body-strict (same as [Bug]: Schema/Cli mismatch runtime.rest.request-body-strict #3353)
• [Bug]: invalid default host.mode #3379 — host.mode (same as [Bug]: Schema/Cli mismatch runtime.host.mode #3351)
• [Bug]: Invalid default set-session-context #3380 — set-session-context (same as [Bug]: Schema/Cli mismatch data-source.options.set-session-context #3352)
• [Bug]: invalid default graphql.multiple-create/mutations.create.enabled #3381 — graphql.multiple-mutations.create.enabled (same as [Bug]: Schema/Cli mismatch runtime.graphql.multiple-mutations.create.enabled #3350)
• [Bug]: inconsistent dml defaults #3382 — DML tool defaults (same as [Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.read-records #3347-[Bug]: Schema/Cli mismatch runtime.mcp.dml-tools.describe-entities #3349)

PR

• fix: align CLI HelpText defaults and descriptions with JSON schema (Group 2) #3417