verify / repair / quality-check
Les commandes de maintenance gardent la mémoire en bonne santé.
verify
engram verify
engram verify --sources
engram verify --sources --json
Vérifie l’intégrité par les hachages. À exécuter après des modifications manuelles ou des imports.
--sources re-hache aussi les source_files des mémoires take-control et les compare à leurs source_hashes, puis consigne celles qui ont changé ou manquent dans .agents/.engram/stale.json, un fichier local ignoré par Git. Des sources obsolètes ne font jamais échouer verify : load classe plus bas les mémoires obsolètes et termine leurs cartes par (stale), et engram take-control --refresh propose des mises à jour pour elles. Les chemins de source doivent rester dans l’espace de travail ; les chemins absolus, .., les liens symboliques et physiques, les fichiers secrets, .git et les données Engram sont signalés comme non vérifiés et jamais lus. Dans --json, skipped liste des objets {key, reason}. Une mémoire take-control globale enregistre l’espace de travail dont elle provient et n’est vérifiée que là.
stats
engram stats
engram stats --usage
--usage lit le fichier local .agents/.engram/usage.json, ignoré par Git, et montre quelles mémoires les agents récupèrent réellement avec engram load --id et lesquelles ont été injectées sans jamais être récupérées en 30 jours.
repair
engram repair
engram rebuild-index
Utilisez repair après des modifications manuelles ou des imports pour trouver les fichiers de mémoire malformés ignorés par la reconstruction de l’index.
engram repair --move-backups
engram repair workspace --move-backups --confirm
--move-backups planifie le déplacement des sauvegardes de migration *.bak égarées dans rules, skills et knowledge vers le dossier backups/<kind>-<label>/, ignoré par Git (par exemple backups/schema-v3/rules/x.md.pre-v3.bak). Ajoutez --confirm pour les déplacer ; un fichier différent déjà présent à la destination est signalé comme conflit et laissé en place. engram doctor signale ces fichiers sous memory.stray_backups.
quality-check
engram quality-check
Signale de façon compacte les candidats à une contradiction. La détection des contradictions est heuristique et consultative.
graph
engram graph "package manager"
engram graph --rebuild
Inspectez le routage par graphe avant d’archiver. Exécutez engram graph --rebuild après des modifications manuelles.
archive
engram archive --reason "Repo migrated to npm." rules/use-pnpm.md
Archivez les mémoires erronées ou remplacées. Utilisez archive, et non la suppression, pour la traçabilité. Le fichier ne quitte le routage actif qu’après approbation et reste conservé sous archive/.
resolve-conflicts
engram resolve-conflicts --dry-run --metacognize
engram resolve-conflicts --metacognize
Prévisualise ou résout uniquement les conflits de mémoire de l’espace de travail appartenant à Engram. Ajoutez --metacognize lorsqu’un agent doit relire le dossier de mémoire après le traitement des conflits. La commande limite le traitement déterministe des conflits à .agents/.engram/, puis ajoute le lot de sources metacognize de l’espace de travail pour obtenir des candidats TYPE/TEXT concis.
benchmark
engram benchmark
Contrôles de régression de la récupération.