"""``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)