feat(ci): add --format={text,shell,json} to ci git-refs

[sileht]

Lets users consume detected refs in scripts without awk-parsing. Shell
format emits MERGIFY_GIT_REFS_{BASE,HEAD,SOURCE}=... lines suitable for
eval, with shlex-quoted values; json emits a single-line object.

Co-Authored-By: Claude Opus 4.7 (1M context) 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,})

[Copilot]

Pull request overview

Adds machine-consumable output formats to mergify ci git-refs so scripts can consume detected refs without parsing human-readable text.

Changes:

• Add --format={text,shell,json} to mergify ci git-refs
• Extend CLI tests to cover shell and json output modes
• Update skills/mergify-ci documentation with usage examples for new formats

Reviewed changes

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

File	Description
mergify_cli/ci/cli.py	Implements --format option and emits refs in text/shell/JSON formats.
mergify_cli/tests/ci/test_cli.py	Adds assertions and new tests for the additional output formats.
skills/mergify-ci/SKILL.md	Documents the new output formats and shows scripting examples.

---

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

[sileht]

This pull request is part of a Mergify stack:

#	Pull Request	Link
1	feat(ci): add --format={text,shell,json} to ci git-refs	#1223	👈
2	fix(ci): write empty string to GITHUB_OUTPUT when base is undetected	#1225

[sileht]

Revision history

#	Type	Changes	Date
1	initial	fcaa1a8	2026-04-18 22:37 UTC
2	content	fcaa1a8 → ee7e9b0	2026-04-18 22:37 UTC

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-04-20 10:06 UTC · Rule: default
• ✅ Checks passed · on draft merge queue: embarking main (45b7a13) and #1223 together #1244
• ✅ Merged — 2026-04-20 10:12 UTC · at ee7e9b0b4cdd0ab1a8888ecfe79d4de328f080fd · squash

This pull request spent 5 minutes 36 seconds in the queue, including 5 minutes 22 seconds 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(ci): add --format={text,shell,json} to ci git-refs #1223
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by>=2
      • feat(ci): add --format={text,shell,json} to ci git-refs #1223
    • author = dependabot[bot]
      • feat(ci): add --format={text,shell,json} to ci git-refs #1223
    • author = mergify-ci-bot
      • feat(ci): add --format={text,shell,json} to ci git-refs #1223
    • author = renovate[bot]
      • feat(ci): add --format={text,shell,json} to ci git-refs #1223
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • feat(ci): add --format={text,shell,json} to ci git-refs #1223
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • feat(ci): add --format={text,shell,json} to ci git-refs #1223
  • #review-requested = 0
    • feat(ci): add --format={text,shell,json} to ci git-refs #1223
  • #review-threads-unresolved = 0
    • feat(ci): add --format={text,shell,json} to ci git-refs #1223
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success=ci-gate