fix: improve schema descriptions (Group 5)

[souvikghosh04]

Why make this change?

Closes #3470

Fixes #3365, #3368, #3369, #3370, #3371

Schema descriptions were missing, placeholder, or misleading — affecting VS Code IntelliSense and tooling that reads JSON Schema metadata.

What is this change?

Updates \schemas/dab.draft.schema.json\ descriptions:

Issue	Property	Fix
#3365	\data-source.health.enabled\	Updated description
#3368	\permissions[].role\	Added missing description (3 locations)
#3369	\permissions[].actions\	Added missing description (3 locations)
#3370	\data-source.options\	Clarified vague description (2 locations)
#3371	\
untime.graphql.depth-limit\	Documented null (no limit) and -1 (CLI remove limit) semantics

How was this tested?

Schema-only metadata change — no runtime behavior affected. JSON validated.

[Copilot]

Pull request overview

This PR improves the metadata quality of DAB’s JSON Schema (schemas/dab.draft.schema.json) so VS Code IntelliSense and other schema-driven tooling show accurate, non-placeholder descriptions for common configuration properties.

Changes:

• Clarifies data-source.options description to better reflect database-specific configuration.
• Fixes placeholder/misleading descriptions for data-source.health.enabled and runtime.graphql.depth-limit.
• Adds missing descriptions for permissions[].role and permissions[].actions across the repeated schema locations.

Comments suppressed due to low confidence (3)

schemas/dab.draft.schema.json:1351

• The wildcard branch uses pattern: "[*]", which matches any string containing * (e.g., "abc*") rather than only the literal "" described here. To align schema validation with the description/intended values, consider switching to an anchored regex (e.g., ^\\*$) or an explicit enum of "".

                      "description": "The operations permitted for this role. Use \"*\" to allow all, or specify an array of actions.",
                      "oneOf": [
                        {
                          "type": "string",
                          "pattern": "[*]"
                        },

schemas/dab.draft.schema.json:1427

• The wildcard branch uses pattern: "[*]", which matches any string containing * (e.g., "abc*") rather than only the literal "" described here. To align schema validation with the description/intended values, consider switching to an anchored regex (e.g., ^\\*$) or an explicit enum of "".

                      "description": "The operations permitted for this role. Use \"*\" to allow all, or specify an array of actions.",
                      "oneOf": [
                        {
                          "type": "string",
                          "pattern": "[*]"
                        },

schemas/dab.draft.schema.json:956

• The wildcard branch uses pattern: "[*]", which matches any string containing * (e.g., "abc*") rather than only the literal "" described here. To align schema validation with the description/intended values, consider switching to an anchored regex (e.g., ^\\*$) or an explicit enum of "".

                    "description": "The operations permitted for this role. Use \"*\" to allow all, or specify an array of actions.",
                    "oneOf": [
                      {
                        "type": "string",
                        "pattern": "[*]"
                      },