Enforce documented GraphQL armor depth floor

[dkijania]

Context

#183 documents that GRAPHQL_MAX_DEPTH must not be set below 8, because known downstream clients send depth-7 queries and a depth rejection replaces the validation error text they use for schema-tier fallback.

The default is now safe (12), but the documented floor is not enforced: the parser accepts any integer >= 1, so GRAPHQL_MAX_DEPTH=6 is silently honored.

Follow-up work

• Decide whether the floor should be enforced or only warned. The safer behavior is to warn loudly or clamp/reject values below the known-safe floor.
• Add an explicit unit test that the default depth remains above the downstream floor, instead of relying indirectly on the real-query armor test.
• Add a code comment near maxCost: 5000 explaining that the current safety margin depends on this schema using limit: rather than first: / last:. If future schema work adds first or last pagination arguments, the cost budget must be revisited.
• Mention the transitive graphql version bump in the PR/release notes because downstream consumers treat graphql-js validation error text as a contract.

Acceptance criteria

• GRAPHQL_MAX_DEPTH < 8 produces a warning, clamp, or startup validation error with a clear message.
• Unit coverage explicitly pins the default depth above the documented downstream floor.
• Cost-limit comments or docs flag the first / last pagination multiplier hazard.
• Release notes call out the graphql-js version involved in the armor dependency tree.

Related

• P0: Add GraphQL query-cost controls via graphql-armor (#164) #183
• P2: Declare 1.0.0 + versioning & schema stability policy (#178) #198