How kashifahmed/downstream-merge works
Downstream PR is a GitHub Actions workflow that propagates merged changes along a branch chain by opening downstream pull requests, checking for conflicts, and notifying a team. The README documents validation, user mapping, branch resolution, diff and duplicate checks, PR creation, conflict detection, and Slack alerts; the only workflow source is present in the tree but was not excerpted, so the graph reflects documented behavior rather than inspected implementation.
Main entry points: downstream-pr.yml Downstream workflow · slack-users.json Slack user mapping
Components 15
Workflow orchestration
- Downstream workflow
.github/workflows/downstream-pr.yml - Validate environment
.github/workflows/downstream-pr.yml - Load user mapping
.github/workflows/downstream-pr.yml
Branch promotion
- Resolve target branch
.github/workflows/downstream-pr.yml - Check branch diff
.github/workflows/downstream-pr.yml - Check existing PR
.github/workflows/downstream-pr.yml - Create downstream PR
.github/workflows/downstream-pr.yml - Check conflicts
.github/workflows/downstream-pr.yml
Notifications
- Slack user mapping
.github/slack-users.json - Send Slack alert
.github/workflows/downstream-pr.yml
Other components
- Developer
- Upstream merge
- GitHub Actions
- GitHub repository
- Slack
Connections 17
- Developer → Upstream merge: merges changes
README.md - Upstream merge → Downstream workflow: triggers on push
README.md - GitHub Actions → Downstream workflow: runs
README.md - Downstream workflow → Validate environment: validates
README.md - Downstream workflow → Load user mapping: loads mapping
README.md - Load user mapping → Slack user mapping: reads
README.md - Downstream workflow → Resolve target branch: resolves target
README.md - Downstream workflow → Check branch diff: checks commits
README.md - Downstream workflow → Check existing PR: checks open PRs
README.md - Downstream workflow → Create downstream PR: creates PR
README.md - Downstream workflow → Check conflicts: checks conflicts
README.md - Check branch diff → GitHub repository: reads branch state
README.md - Check existing PR → GitHub repository: queries PRs
README.md - Create downstream PR → GitHub repository: opens PR
README.md - Check conflicts → GitHub repository: checks PR conflicts
README.md - Downstream workflow → Send Slack alert: notifies events
README.md - Send Slack alert → Slack: posts webhook
README.md