Données & sauvegarde
Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab
Tout l'état vit dans data/ (gitignored) : reviewer.db (SQLite), clones/, reviews/ (un dossier par MR, avec une version de rapport par passe : review-v1.md, review-v2.md…), tickets/, tasks/ (diffs par projet et réponses d'exploration).
Sauvegarder
Réglages → Général → « Sauvegarder les données » produit une archive .zip datée contenant :
reviewer.db, copiée par l'API de sauvegarde de SQLite et non par uncp— une copie de fichier faite pendant une écriture donne une base corrompue, ce qui ne se découvre que le jour où l'on essaie de la restaurer ;reviews/,tasks/ettickets/: les rapports, les retours d'agent et les captures que la base référence par leur chemin. Sauvegarder la base seule laisserait des références mortes ;- un
LISEZ-MOI.txtavec la marche à suivre pour restaurer — une sauvegarde qu'on ne sait plus restaurer ne vaut rien, et c'est six mois plus tard qu'on l'ouvre.
Les clones et les worktrees en sont exclus : ils se retrouvent avec un git clone, et les inclure multiplierait la taille de l'archive pour ne rien sauver d'irremplaçable. L'archive est assemblée en mémoire ; au-delà de 256 Mo elle est refusée avec le nom du fichier qui a fait déborder, plutôt que de faire tomber le serveur.
Restaurer — Mergerie arrêtée (la base ne doit pas être écrite pendant la copie) : mettre l'ancien data/ de côté, décompresser l'archive à sa place, relancer. Les clones manquants sont refaits à la demande.
Conserver l'historique
Réglages → Général → « Conserver l'historique » (défaut 90 jours, 0 = sans limite) supprime au-delà du délai : les journaux de jobs, les jobs terminés et le fil d'activité. Le ménage a lieu au démarrage puis une fois par jour. Minimum 7 jours — un délai plus court effacerait le journal du job qu'on est en train de lire ; et un job en cours n'est jamais purgé, si ancien soit-il.
Deux choses ne sont jamais purgées, à dessein : le coût en tokens (usage), parce qu'il porte un total cumulé qui ne doit pas baisser tout seul, et les itérations d'agent (agent_pass), qui disparaissent déjà avec leur session et dont les cartes proposent la relecture.
Les merge requests fermées s'allègent. « Alléger les merge requests fermées après » (défaut 180 jours, 0 = jamais, minimum 30) : une merge request mergée, close ou rangée « traitée » depuis plus longtemps garde son dernier rapport — c'est ce qu'on relit pour comprendre ce qui est parti en production — et perd les versions précédentes, le diff stocké, les questions posées sur le rapport et son dossier de travail. La ligne de la MR reste : le brief et les statistiques comptent toujours ce qui a été traité. Les clones inactifs se compactent : un dépôt que personne n'a fetché depuis trente jours passe au git gc, une fois par mois au plus. Cloner sans les blobs (Réglages → Git, ce poste) applique --filter=blob:none aux prochains clones : tout l'historique, le contenu des fichiers à la demande — décoché par défaut, parce qu'un agent qui lit beaucoup de fichiers paie chaque contenu d'un aller-retour. Et la jauge : Réglages → Général → « Mesurer l'occupation disque » dit ce que pèsent la base, les clones, les rapports, les sessions, les worktrees de vérification, les tickets, les notes, le dépôt de données et le temporaire ; « Nettoyer maintenant » demande confirmation — journaux, versions de rapport, diffs, clones compactés : rien ne se restaure — puis lance la passe quotidienne tout de suite et dit ce qui est parti.
Pour lancer des tests sans toucher ta base : MERGERIE_DATA_DIR=/tmp/mon-test npm start.