"""``hermes worktree`` subcommand parser.""" from __future__ import annotations def build_worktree_parser(subparsers) -> None: """Attach the ``worktree`` subcommand to ``subparsers``.""" worktree_parser = subparsers.add_parser( "worktree", help="Audit and reclaim accumulated git worktrees and merged branches", description="Audit, reclaim and restore the .worktrees/ trees Hermes sessions " "accumulate. Idle trees with uncommitted changes or unpushed commits are " "archived to refs/hermes/archive/ before removal " "(worktrees.archive_dirty); `restore` brings one back. In-use trees are " "never touched. See: " "https://hermes-agent.nousresearch.com/docs/user-guide/git-worktrees") worktree_subparsers = worktree_parser.add_subparsers(dest="worktree_action") worktree_list = worktree_subparsers.add_parser( "list", aliases=["ls", "audit"], help="Classify every tree: age, size, verdict, reason (default action)") worktree_list.add_argument("--repo", help="Repo root (default: current repo)") worktree_list.add_argument( "--json", action="store_true", help="Machine-readable audit output (trees, external trees, branches)") worktree_list.add_argument( "--older-than", type=float, metavar="DAYS", dest="older_than", help="Treat reapable trees younger than DAYS as keep") worktree_prune = worktree_subparsers.add_parser( "prune", help="Remove safe trees and delete fully-merged local branches") worktree_prune.add_argument("--repo", help="Repo root (default: current repo)") worktree_prune.add_argument( "--json", action="store_true", help="Machine-readable result (actions taken/planned, preserved trees)") worktree_prune.add_argument( "--older-than", type=float, metavar="DAYS", dest="older_than", help="Only reap trees idle for at least DAYS days (safety gates still apply)") worktree_prune.add_argument( "--dry-run", action="store_true", help="Show the plan without changing anything") worktree_prune.add_argument( "--trees-only", action="store_true", help="Only remove worktrees; leave local branches alone") worktree_prune.add_argument( "--branches-only", action="store_true", help="Only delete merged local branches; leave worktrees alone") worktree_restore = worktree_subparsers.add_parser( "restore", help="Recreate an archived worktree (tracked, staged and untracked files)") worktree_restore.add_argument("name", help="Archive name or tree name (see `hermes worktree list`)") worktree_restore.add_argument("--path", help="Restore here instead of the original path") worktree_restore.add_argument("--repo", help="Repo root (default: current repo)") def _dispatch_worktree(_args): from hermes_cli.worktree_cmd import cmd_worktree # argparse aliases set dest to the literal typed string ("ls"/"audit"). action = getattr(_args, "worktree_action", None) if action in ("ls", "audit"): _args.worktree_action = "list" return cmd_worktree(_args) worktree_parser.set_defaults(func=_dispatch_worktree)