Reviews manuelles

La review manuelle est le chemin de contrôle principal. Elle crée une review.Request normale et l’envoie dans la même file bornée que le travail webhook. Le reste du pipeline est identique : enrichissement SCM, sélection de contexte, review modèle, validation des findings, sortie brouillon et approbation humaine avant publication finale.

Entrées

Provider	Identifiants requis	Exemple d’ID de run
GitHub	repository au format owner/repo, pr_number	owner/repo!7
GitLab	project_id, mr_iid	25!19

Utilise les identifiants du provider SCM, pas les noms de branches locales.

Déclencher une review

CLI

7review review github --repo owner/repo --pr 7 --server http://localhost:8080
7review review gitlab --project 25 --mr 19 --server http://localhost:8080

API outil

curl -fsS \
  -H "Authorization: Bearer $REVIEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"request_review","input":{"provider":"gitlab","project_id":"25","mr_iid":19}}' \
  http://localhost:8080/tools/execute

Payload GitHub :

{
  "name": "request_review",
  "input": {
    "provider": "github",
    "repository": "owner/repo",
    "pr_number": 7
  }
}

Docker Make

make docker-review-gitlab PROJECT_ID=25 MR=19
make docker-review-github REPO=owner/repo PR=7

Sens des réponses

Une requête acceptée renvoie l’ID de run et un statut indiquant que le job est en file. Une requête rejetée doit renvoyer une raison.

Résultat	Signification	Correction habituelle
enqueued	Le job est entré dans la file de workers bornée	Inspecter avec sessions ou session
already running ou conflit	Le même ID de run est déjà en file ou en cours	Attendre le run courant ou l’inspecter
file pleine	La requête est valide mais le serveur n’a plus de capacité de file	Augmenter WEBHOOK_QUEUE_SIZE ou réessayer plus tard
erreur de validation	Provider, dépôt, projet, PR ou MR manquant ou invalide	Corriger les identifiants

Un déclenchement manuel peut créer un nouveau rerun après un run terminé ou en échec. Il ne double pas un run déjà en cours.

Inspecter le résultat

7review sessions --server http://localhost:8080
7review session owner/repo!7 --server http://localhost:8080
7review history owner/repo!7 --server http://localhost:8080

Pour GitLab, remplace l’ID de run par project_id!mr_iid :

7review session 25!19 --server http://localhost:8080

Notes opérationnelles

• La review manuelle utilise aussi WEBHOOK_WORKERS, WEBHOOK_QUEUE_SIZE et WEBHOOK_JOB_TIMEOUT_MS.
• La review manuelle ne contourne pas l’authentification provider ni l’enrichissement SCM.
• La politique webhook ne bloque pas les requêtes manuelles ; l’opérateur est la décision de politique en mode manuel.
• La publication finale reste une action humaine explicite après préparation de la sortie brouillon.