Architecture decision records
These short records capture decisions that later VcsManager issues depend on. An accepted ADR is not rewritten; a changed decision gets a new ADR that supersedes it.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Repository addressing with RepositoryRef | Accepted |
| 0002 | PAT authentication for v1 | Accepted |
| 0003 | GitHub uses Octokit 14.0.0 behind an internal client | Accepted |
| 0004 | GitLab uses REST API v4 with HttpClient | Accepted |
| 0005 | Azure DevOps uses the official SDK with REST 7.1 fallback | Accepted |
| 0006 | Repository listing scope | Accepted |
| 0007 | Merge method mapping | Accepted |
| 0008 | Close semantics and idempotency | Accepted |
| 0009 | Pagination and error mapping | Accepted |
| 0010 | Exception contract and HTTP status mapping | Accepted |
| 0011 | Gitea uses REST API v1 with HttpClient | Accepted |
| 0012 | Provider listing and merge scope for v1 | Accepted |
| 0013 | Repository seeding from a template | Accepted |
See the provider capability matrix for the supported, conditional, and unsupported operations per provider.