README
¶
SubmitQueue
SubmitQueue is a high-performance speculative merge queue that keeps your trunk consistently green at scale. Rather than validating changes one at a time, SubmitQueue speculatively rebases and validates multiple changes in parallel against predicted future states of HEAD. When validations pass, changes land automatically. When they fail, SubmitQueue isolates the offending change and retries the rest — all without human intervention.
Designed for large monorepos and fast-moving teams where concurrent changes can introduce subtle conflicts and destabilize builds.
Quick Start
Requires Docker and Docker Compose. See Development Setup for full prerequisites.
# Build everything
make build
# Run unit tests
make test
# Start full stack locally (Gateway + Orchestrator + MySQL via Docker Compose)
make local-start
# Test with grpcurl
grpcurl -plaintext -d '{"message": "hello"}' localhost:8081 uber.submitqueue.gateway.SubmitQueueGateway/Ping
# Stop services
make local-stop
See example/README.md for more examples including running individual services and clients.
Documentation
| Document | Description |
|---|---|
| Development Setup | Prerequisites, build, environment, IDE setup |
| Contributing | How to contribute, workflow, guidelines |
| Testing Guide | Unit, integration, and E2E testing patterns |
| Architecture Guide | Project layout, patterns, conventions |
| Examples | Running services, clients, API reference |
| RFCs | Design documents and proposals |
Project Status
SubmitQueue is under active development. We welcome contributions and feedback.
Contributing
See CONTRIBUTING.md for how to get started.
License
Licensed under the Apache License 2.0.
Directories
¶
| Path | Synopsis |
|---|---|
|
core
|
|
|
consumer/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
example
|
|
|
client/gateway
command
|
|
|
client/orchestrator
command
|
|
|
client/stovepipe
command
|
|
|
server/gateway
command
|
|
|
server/orchestrator
command
|
|
|
server/stovepipe
command
|
|
|
extension
|
|
|
changestore/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
conflict/all
Package all provides a conflict.Analyzer that pessimistically reports a conflict against every in-flight batch.
|
Package all provides a conflict.Analyzer that pessimistically reports a conflict against every in-flight batch. |
|
conflict/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
conflict/none
Package none provides a conflict.Analyzer that never reports a conflict.
|
Package none provides a conflict.Analyzer that never reports a conflict. |
|
counter/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
mergechecker/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
pusher/git
Package git is a simple Pusher implementation backed by a local git checkout.
|
Package git is a simple Pusher implementation backed by a local git checkout. |
|
pusher/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
queue/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
queue/mysql
Package mysql is a generated GoMock package.
|
Package mysql is a generated GoMock package. |
|
queue/mysql/ctl
command
|
|
|
scorer/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
storage/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
gateway
|
|
|
orchestrator
|
|
|
stovepipe
|
|
|
test
|
|
|
tool
|
|
|
linter/licenseheader
command
|