| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960 |
- """``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/<tree> 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)
|