Pull Request Guide

How to submit changes to Nexus OS.

PR Workflow

  1. Fork the repository on GitHub
  2. Create a branch from master
  3. Make changes with clear, focused commits
  4. Run tests locally (cargo test)
  5. Submit PR with a clear description

Commit Messages

Follow conventional commits:

feat: add broker routing engine
fix: correct saga compensation order
docs: update CLI reference
test: add supervisor restart tests
refactor: simplify store migration

PR Template

## What
[Brief description of the change]

## Why
[Motivation and context]

## How
[Implementation approach]

## Testing
- [ ] Unit tests added/updated
- [ ] Integration tests pass
- [ ] Manual testing completed

## Checklist
- [ ] cargo fmt
- [ ] cargo clippy (no warnings)
- [ ] cargo test (all pass)
- [ ] Documentation updated

Review Process

  • PRs require at least one approval
  • CI must pass (build + tests + clippy)
  • Squash merge into master
  • Delete branch after merge