hermes checkpoints în Hermes Agent CLI

hermes checkpoints [status | list | prune | clear | clear-legacy] [opțiuni]

Ce face hermes checkpoints

hermes checkpoints lucrează cu depozitul git „umbră” din ~/.hermes/checkpoints/, stratul de stocare din spatele comenzii /rollback. Fără argument afișează dimensiunea totală, numărul de proiecte și defalcarea pe proiect. Comanda poate rula oricând; agentul nu trebuie să fie pornit.

prune forțează o curățare: șterge proiectele orfane și vechi, rulează GC și aplică limita de dimensiune. Curățarea automată (checkpoints.auto_prune, implicit activă) nu șterge niciodată proiectele orfane, deoarece un director lipsă poate fi doar un volum nemontat. clear șterge tot depozitul și este ireversibilă.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
status (implicit) / list	Dimensiune, proiecte, defalcare; --limit N (implicit 20).
prune	Curățare forțată; --retention-days N (implicit 7), --max-size-mb N (implicit 500), --keep-orphans.
clear	Șterge tot depozitul; cere confirmare fără -f.
clear-legacy	Șterge doar arhivele legacy-* din migrarea v1→v2.
-f, --force	Cu clear / clear-legacy: fără confirmare.

Exemple practice

Exemplul 1: Starea depozitului

hermes checkpoints

Exemplul 2: Curățare mai agresivă

hermes checkpoints prune --retention-days 3
hermes checkpoints prune --max-size-mb 200

Greșeli frecvente și bune practici

• Scrii hermes checkpoints --clear. Subcomanda este clear, fără liniuțe.
• Rulezi clear -f ca să eliberezi spațiu. prune păstrează istoricul recent; clear șterge tot.

Comenzi înrudite

• hermes-rollback
• hermes-backup