audit(mergify): Deep analysis and improvement plan for merge automation

[ashleyshaw]

Overview

Deep audit of Mergify configuration, workflow integration, and auto-merge rules. Current implementation has known issues and unclear behavior.

Known Issues

1. Dependabot Auto-Merge Not Working

• Symptom: Dependabot PRs don't merge automatically into develop
• Config: Rules exist in .github/mergify.yml (lines 19-31)
• Requirements:
  • Author: dependabot[bot] or app/dependabot
  • Base: develop
  • Label: area:dependencies
  • Check: check-success=All Checks Passed
  • State: Not draft, no conflicts
• Likely Issues:
  • Check name mismatch ("All Checks Passed" vs actual CI check names)
  • Label not being applied by Dependabot
  • Queue not actually executing merge
  • Mergify token missing or misconfigured

2. ImgBot Auto-Merge Effectiveness Unknown

• Last Verified: Never (no ImgBot PRs recently)
• Config: Supports two identities (imgbot[bot] and app/imgbot)
• Implementation: Direct merge, not queued
• Risk: Rule may be outdated or ineffective

3. Meta-Agent Sync Auto-Merge Double-Attempt

• Issue: Workflow ALSO calls gh pr merge --auto --squash (meta.yml)
• Config: Mergify rule configured for auto-merge (mergify.yml lines 59-70)
• Race Condition: Both workflow + Mergify trying to merge same PR
• Behavior: PR gets created, workflow auto-merges, Mergify rule may also trigger
• Title Requirement: Exact match on ^chore(meta): automated meta-agent sync$
• Label Requirement: meta:no-changelog

4. Merge Protection Settings Unclear

• Setting: auto_merge_conditions: true
• Reporting: check-runs
• Unknown: What these actually do, whether they're optimal

Deliverables

Documentation file: docs/MERGIFY_STRATEGY.md

• Architecture and strategy
• Rule-by-rule documentation
• Troubleshooting guide
• Improvement recommendations

[linear-code]

LS-1764

[github-actions]

⚠️ This issue does not follow a required issue template.

Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)

The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:

• https://github.com/lightspeedwp/.github/issues/new/choose

If this was opened by automation, update the automation to preserve the template sections before creating the issue.

[github-actions]

⏱️ Aging and SLA annotation

• Age: 5 day(s)
• SLA state: Within SLA
• Thresholds: warn at 7 days, breach at 14 days
• Last updated: 2026-07-29T17:29:54.157Z

Maintained by project-meta-sync workflow.