yj*dZddlmZddlZddlZddlmZddlmZddlm Z m Z ddl m Z dd Zdd ZddZddZddZddZddZddZd dZdS)!a `hermes checkpoints` CLI subcommand. Gives users direct visibility and control over the filesystem checkpoint store at ``~/.hermes/checkpoints/``. Actions: hermes checkpoints # same as `status` hermes checkpoints status # total size, project count, breakdown hermes checkpoints list # per-project checkpoint counts + workdir hermes checkpoints prune [opts] # force a sweep (ignores the 24h marker) hermes checkpoints clear [-f] # nuke the entire base (asks first) hermes checkpoints clear-legacy # delete just the legacy-* archives Examples:: hermes checkpoints hermes checkpoints prune --retention-days 3 --max-size-mb 200 hermes checkpoints clear -f None of these require the agent to be running. Safe to call any time. ) annotationsN)datetime)Path)AnyOptional) format_bytestsrreturnstrc tjt|dS#tt f$rYdSwxYw)Nz%Y-%m-%d %H:%M—)r fromtimestampfloatstrftime TypeError ValueError)r s zcmd_status..Esquu\**/aT)keyreverse WORKDIRz<60COMMITSz>7z LAST TOUCHz>12z STATElimitworkdir (unknown)ru…iexistsliveorphancommitsr'legacy_archiveszLegacy archives (z):c.|ddS)Nmtimerr()as rr+zcmd_status..Ysw1B1Br,name<40 size_bytes>10z+Clear with: hermes checkpoints clear-legacy) tools.checkpoint_managerrprint _fmt_bytessortedhasattrr2r)lenr) rrinfor r%r*wdr6stater9lastlegacyarchs r cmd_statusrN8s555555 <>>D zcmd_prune..ts8   55??    r,r%c<g|]}|d|SrTr(rUs rrWzcmd_prune..xs8   55??    r,pre_v2_projectszThis will permanently delete zG orphan checkpoint project(s) whose workdir is not currently reachable:r4r5r/z (r9z commit(s))z (pre-v2 shadow repo)z=A workdir can be unreachable because the project was deleted,zzcmd_prune..s777!AfI777r,c3&K|] }|dV dS)pathNr^rUs r zcmd_prune..s&BBa& BBBBBBr,uPruning checkpoint store…z retention_days: z delete_orphans: z max_total_size_mb: )retention_daysdelete_orphansmax_total_size_mborphan_allowlistzScanned: scannedzDeleted orphan: deleted_orphanzDeleted stale: deleted_stalezErrors: errorszBytes reclaimed: bytes_freed) rBrRrrc max_size_mb keep_orphansforcer)rCrG_confirmupdaterD) rrRrrcrlrdrfrHorphanspre_v2_orphansr*rIresults r cmd_prunertes[HHHHHHHH(N"K**N '+#Cdj#C|~~  xx B//     xx 1266     n  [#g,,^ATAT2T[[[ \ \ \ GGG D DUU9%%4B2BB!%% 1"5"5BBBCCCC# 7 7UU9%%4525556666 GGG Q R R R P Q Q Q D E E E;<< j!!!q87w777BB>BBBBBB '((( 2. 2 2333 2. 2 2333 /+ / /000 GGG  %%%) F  1fY/ 1 1222 8f%56 8 8999 7f_5 7 7888 0fX. 0 0111 Aj )>?? A ABBB 1r,promptboolc t|d}n&#ttf$rt YdSwxYw|dvS)Nz [y/N]: F>yyes)inputstriplowerEOFErrorKeyboardInterruptrC)ruresps rrorosu((())//117799 ' ( uu < s69AAc ddlm}m}m}|}|ddkr2t |st ddSt d|dt dt|dt d|d t d t| d gt t d |j s td st ddS|}|dr(t dt|dddSt ddS)Nr)CHECKPOINT_BASE clear_allrr!u4Nothing to clear — checkpoint base does not exist.z/This will delete the ENTIRE checkpoint base at r z size: z projects: r$z legacy dirs: r:z?All /rollback history for every working directory will be lost.zProceed?rZr[deletedzCleared. Reclaimed rk.z+Could not clear checkpoint base (see logs).) rBrrrrr6rCrDrGr)rnro)rrrrrHrss r cmd_clearrsQQQQQQQQQQ <>>D 1$$T/-B-B-I-I-K-K$ DEEEq JDL J JKKK BJt,>'?@@ B BCCC 3D1 3 3444 BC):B ? ?@@ B BCCC GGG KLLL :hz22 jq Y[[F i HJvm/D$E$EHHHIIIq 7888 1r,c ddlm}m}|}|dg}|st ddSt d|D}t dt |dt|d|D]2}t d |d d d t|d d 3t t dt dt d|js tdst ddS|}t d|ddt|dddS)Nr) clear_legacyrr:zNo legacy archives to clear.c3BK|]}|ddVdS)r@rNr()rVr=s rrbz#cmd_clear_legacy..s0771lA&&777777r,zFound z legacy archive(s), total :r/r>r?r@rAzALegacy archives hold pre-v2 per-project shadow repos, moved asidez?during the single-store migration. Delete when you're confidentz)you don't need the old /rollback history.zDelete all legacy archives?rZr[zDeleted rz archive(s), reclaimed rkr) rBrrr)rCsumrGrDrnro)rrrrHrLtotalrMrss rcmd_clear_legacyrsCCCCCCCC <>>D XX' , ,F  ,---q 77777 7 7E N3v;; N N*U:K:K N N NOOOMM K4<KKKz$|2D'E'EKKKLLLL GGG MNNN KLLL 5666 :h'DEE jq \^^F cVI& c cz&Q^J_?`?` c c cddd 1r,parserargparse.ArgumentParserNonec|t|dd}|dd}|dt d d |t|d d }|dt d |t |dd}|dt dd |dt dd |ddd|dddd|t|dd}|dddd |t|d!d"}|dddd |td#S)$z8Wire subcommands onto the ``hermes checkpoints`` parser.)funccheckpoints_commandCOMMAND)destmetavarstatusz9Show total size, project count, and per-project breakdown)helpz--limitr3z!Max projects to list (default 20))typedefaultrlistzAlias for 'status')rrprunez0Delete orphan/stale checkpoints and GC the storez--retention-daysz?Drop projects whose last_touch is older than N days (default 7)z --max-size-mbiz`After orphan/stale prune, drop oldest commits per project until total size <= this (default 500)z--keep-orphans store_truez5Skip deleting projects whose workdir no longer exists)actionrz-fz--forcez,Skip the orphan-deletion confirmation promptclearz9Delete the entire checkpoint base (all /rollback history)zSkip confirmation promptz clear-legacyz7Delete only the legacy-/ archives from v1 migrationN) set_defaultsrNadd_subparsers add_parser add_argumentrrPrtrr)rsubsp_statusp_listp_prunep_clearp_legacys r register_clirs Z(((  &;Y O OD HH )#rBDDD z*** __ !F  R888 X&&&oo ?G +#q_aaa sCSTTT ),UWWW yLNNN i(((oo HG y8::: i((( FH $ ,9;;; /00000r,)r rr r )rrr r)rur r rv)rrr r)__doc__ __future__rargparserrpathlibrtypingrrhermes_cli.sizefmtrrDrrrNrPrtrorrrr^r,rrsG*#"""""  999999 & & & & % % % % P C C C C L        4    4111111111111r,