Démarrage rapide
Ce guide sert à démarrer le serveur opérateur, vérifier la readiness, puis lancer une review sur une PR ou MR précise. L’automatisation webhook est optionnelle ; le mode d’exploitation par défaut est manuel d’abord.
Avant de commencer
7review a besoin d’un provider SCM, d’un chemin modèle et des sidecars de production utilisés pour le contexte.
| Pré-requis | Rôle |
|---|---|
| Token GitHub ou GitLab | Lire les métadonnées PR/MR, le diff, les fichiers, puis publier la sortie de review |
| Configuration provider modèle | Exécuter le reasoner et les rôles de review configurés |
HEADROOM_URL | Réduire et ajuster le contexte source avant la review modèle |
MEMPALACE_URL | Rappeler et stocker la mémoire dépôt approuvée |
REVIEW_API_TOKEN | Protéger les outils opérateur comme request_review |
Génère d’abord la configuration pour obtenir un .env avec les clés attendues :
go run ./cmd/7review setup
Démarrer le serveur
- Local
- Docker
set -a
. ./.env
set +a
go run ./cmd/7review
Dans un autre terminal, vérifie que le serveur HTTP et la surface opérateur répondent :
go run ./cmd/7review status --server http://localhost:8080
make docker-up
make docker-status
Utilise la cible readiness brute quand tu veux seulement le résultat de
/ready :
make docker-ready
Lancer la première review
La review manuelle est le premier run le plus clair, parce qu’elle nomme un changement exact et utilise la même file de workers que les webhooks.
- GitHub
- GitLab
7review review github \
--repo owner/repo \
--pr 7 \
--server http://localhost:8080
L’ID de run est owner/repo!7.
7review review gitlab \
--project 25 \
--mr 19 \
--server http://localhost:8080
L’ID de run est 25!19.
Inspecter la progression
7review sessions --server http://localhost:8080
7review session owner/repo!7 --server http://localhost:8080
7review history owner/repo!7 --server http://localhost:8080
Utilise le chat si tu veux inspecter ou poursuivre depuis le contexte d’un run précis :
7review chat owner/repo!7 --server http://localhost:8080
À quoi ressemble un run réussi
Après le démarrage du run, 7review doit :
- enrichir la PR ou MR depuis GitHub ou GitLab
- collecter le diff structuré et le contexte source sélectionné
- appeler Headroom et MemPalace
- router la review vers les rôles modèle configurés
- valider les findings contre le diff courant
- préparer la sortie de review brouillon
- s’arrêter avant la publication finale tant que l’approbation humaine n’est pas enregistrée
Si la requête est rejetée, vérifie si le même ID de run est déjà en file ou en cours, si la file est pleine, ou si les identifiants provider sont incorrects.