0xMiden / 0xMiden/node

Breaking change detection

Abierto
#1,924 1 comentario 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
Rust
Estrellas
104
Forks
138
Merge medio
1 d 13 h
PR fusionados (30 d)
56

Descripción

I'd like to have the latest release and the dev branch be the same for longer. That is, not immediately branching off at the moment of release, but rather only on a breaking change.

To facilitate this, I think we can add a rudimentary but effective change detection gh workflow.

This is slightly different to other miden repos since the node is essentially a binary executable and not a library.

imo we have the following api surface:
1. gRPC API external (RPC)
2. node CLI
3. protocol version
4. breaking semantics
5. Docker compose API for local node

Optionally, we could also include internal grpc API in case operators want to mix and match internal component versions. I will argue this is not necessary at this point.

### Workflow outline

- Workflow runs on every PR to next/dev
- Detects possible breaking change
- Adds a warning comment on the PR describing breaks found
- Fails PR unless PR includes opt-out label (same as current changelog workflow)

### Change detection

We can use the following

1. `buf` cli has this built in
2. Git diff on relevant files, or a unit snapshot test which checks the help output of the cli for changes
3. Git diff of lockfile and toml
4. This will have to be manual
5. Git diff

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.