What problem does it solve?
It standardizes how to merge main into dev every night without accidentally dropping dev-only features, breaking APIs, or leaving CI in an undebuggable state.
Core Features & Use Cases
- Safe merge strategy: Preserves dev-only additions by resolving conflicts surgically instead of using broad “take main” strategies.
- Squash-merge conflict detection: Detects when main and dev histories diverged via squash chains so fixes don’t silently discard newer dev improvements.
- Post-merge API mismatch auditing: Checks caller/implementation compatibility for files where main’s version was taken to prevent runtime “Frankenstein” failures.
- CI iteration and gating workflow: Provides a deterministic loop for triggering functional tests, diagnosing failures, and only marking the PR ready when required checks pass.
- Special-case handling: Includes explicit rules for problematic paths (e.g., data_schedule.py) and strict prohibitions (e.g., never modify CODEOWNERS).
Quick Start
Use the nightly-sync skill to guide the automated sync bot when resolving conflicts, validating APIs, and iterating CI for a nightly main-to-dev PR.