feat(config): add mergify config validate command (#1010)

[jd]

Add a new config validate subcommand that validates Mergify
configuration files against the official JSON schema. Supports
auto-detection of config file location and explicit path via --config.

Closes #1010

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 🤖 Continuous Integration

Wonderful, this rule succeeded.

• all of:
  • check-success=ci-gate

🟢 👀 Review Requirements

Wonderful, this rule succeeded.

• any of:
  • #approved-reviews-by>=2
  • author = dependabot[bot]
  • author = mergify-ci-bot
  • author = renovate[bot]

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:

🟢 🔎 Reviews

Wonderful, this rule succeeded.

• #changes-requested-reviews-by = 0
• #review-requested = 0
• #review-threads-unresolved = 0

🟢 📕 PR description

Wonderful, this rule succeeded.

• body ~= (?ms:.{48,})

[notion-workspace]

Merge Queue Failure Rate Statistics

[Copilot]

Pull request overview

Adds a new top-level mergify config command group with a validate subcommand to locally validate .mergify.yml files against Mergify’s published JSON schema, including auto-detection of config location and an explicit --config path.

Changes:

• Introduce mergify config validate command (new Click command group + subcommand).
• Implement YAML loading, remote schema fetching, and JSON Schema validation logic.
• Add test coverage for valid/invalid configs, YAML errors, auto-detection, and schema fetch failures; add jsonschema (+ typing stubs) dependency.

Reviewed changes

Copilot reviewed 5 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
pyproject.toml	Adds jsonschema and types-jsonschema dependencies to support validation + typing.
uv.lock	Locks new dependency tree for jsonschema and related packages.
mergify_cli/config/validate.py	Implements YAML loading, schema fetching, and config validation helpers.
mergify_cli/config/cli.py	Adds the config command group and validate subcommand wiring + output formatting.
mergify_cli/cli.py	Registers the new config command group in the root CLI.
mergify_cli/tests/config/test_validate.py	Adds CLI-level tests covering common success/failure scenarios.

---

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

[mergify]

🧪 CI Insights

Here's what we observed from your CI run for be4ceb9.

🟢 All jobs passed!

But CI Insights is watching 👀

[jd]

This pull request is part of a stack:

1. feat(config): add mergify config validate command (add .mergify.yml "lint" option #1010) (#1016) 👈
2. feat(config): add mergify config simulate command (#1019)

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-03-10 16:15 UTC · Rule: default
• ✅ Checks passed · in-place
• ✅ Merged — 2026-03-10 16:16 UTC · at be4ceb9f9b0c275acd0ff9924f231fd2a7653239

This pull request spent 14 seconds in the queue, including 1 second running CI.

Required conditions to merge

• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:
    • feat(config): add mergify config validate command (#1010) #1016
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by>=2
      • feat(config): add mergify config validate command (#1010) #1016
    • author = dependabot[bot]
      • feat(config): add mergify config validate command (#1010) #1016
    • author = mergify-ci-bot
      • feat(config): add mergify config validate command (#1010) #1016
    • author = renovate[bot]
      • feat(config): add mergify config validate command (#1010) #1016
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • feat(config): add mergify config validate command (#1010) #1016
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • feat(config): add mergify config validate command (#1010) #1016
  • #review-requested = 0
    • feat(config): add mergify config validate command (#1010) #1016
  • #review-threads-unresolved = 0
    • feat(config): add mergify config validate command (#1010) #1016
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success=ci-gate