docs(cmd/git): Improve Manager/Command terminology

why: Better describe how Managers enable intuitive traversal of git
entities while Commands target specific entities for operations
what:
- Update Manager docstrings: "Traverse and manage with ORM-like filtering"
- Update Cmd docstrings: "Run git commands targeting a specific [entity]"
- Revise README Command Abstraction section
- Update docs/topics/traversing_git.md overview
- Update docs/cmd/git/index.md and docs/cmd/index.md descriptions

Author: tony

README.md

@@ -76,7 +76,7 @@ print(f"Current revision: {repo.get_revision()}")
 ```
 
 ### 2. Command Abstraction
-Access the full power of the underlying CLI tools without parsing string output manually.
+Traverse repository entities intuitively with ORM-like filtering, then run targeted commands against them.
 
 [**Learn more about Command Abstraction**](https://libvcs.git-pull.com/cmd/)
 
@@ -87,18 +87,16 @@ from libvcs.cmd.git import Git
 # Initialize the wrapper
 git = Git(path=pathlib.Path.cwd() / 'libvcs')
 
-# Run commands intuitively
+# Run commands directly
 git.clone(url='https://github.com/vcs-python/libvcs.git')
 git.checkout(ref='master')
 
-# Branch management
+# Traverse branches with ORM-like filtering
 git.branches.create('feature/new-gui')
-print(git.branches.ls())  # List all branches
+print(git.branches.ls())  # Returns QueryList for filtering
 
-# Remote management
+# Target specific entities with contextual commands
 git.remotes.set_url(name='origin', url='git@github.com:vcs-python/libvcs.git')
-
-# Tag management
 git.tags.create(name='v1.0.0', message='Release version 1.0.0')
 ```
 

docs/cmd/git/index.md

@@ -6,12 +6,13 @@ _Compare to: [`fabtools.git`](https://fabtools.readthedocs.io/en/0.19.0/api/git.
 [`salt.modules.git`](https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.git.html),
 [`ansible.builtin.git`](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/git_module.html)_
 
-## Manager/Cmd Pattern
+## Managers and Commands
 
-libvcs provides a **Manager/Cmd pattern** for git subcommands:
+libvcs provides **Managers** and **Commands** for git subcommands:
 
-- **Manager** classes (`git.branches`, `git.tags`, etc.) handle collection-level operations
-- **Cmd** classes represent individual entities with mutation methods
+- **Managers** (`git.branches`, `git.tags`, etc.) let you traverse repository
+  entities intuitively with ORM-like filtering via QueryList
+- **Commands** are contextual ways to run git commands against a specific target entity
 
 ```
 Git instance

docs/cmd/index.md

@@ -17,7 +17,7 @@ versions.
 
 The `libvcs.cmd` module provides Python wrappers for VCS command-line tools:
 
-- {mod}`libvcs.cmd.git` - Git commands with Manager/Cmd pattern for branches, tags, remotes, etc.
+- {mod}`libvcs.cmd.git` - Git commands with Managers for intuitive entity traversal and Commands for targeted execution
 - {mod}`libvcs.cmd.hg` - Mercurial commands
 - {mod}`libvcs.cmd.svn` - Subversion commands
 

docs/topics/traversing_git.md

@@ -2,19 +2,19 @@
 
 # Traversing Git Repos
 
-libvcs provides **Manager** and **Cmd** classes for navigating the "object graph"
-of your git repository. These aren't just convenient abstractions—they're also
-simulacra of the git commands themselves, giving you typed Python objects instead
-of raw strings.
+libvcs provides **Managers** and **Commands** for intuitively traversing and
+navigating entities in a git repository—branches, tags, remotes, stashes, and
+more—with ORM-like convenience via {class}`~libvcs._internal.query_list.QueryList`.
 
 ## Overview
 
 The pattern consists of two types of classes:
 
-- **Manager** classes handle collection-level operations (`ls()`, `get()`,
-  `filter()`, `add()`/`create()`)
-- **Cmd** classes handle per-entity operations (`show()`, `remove()`,
-  `rename()`)
+- **Managers** (`git.branches`, `git.tags`, etc.) let you traverse repository
+  entities intuitively, listing, filtering, and retrieving them with ORM-like
+  convenience
+- **Commands** are contextual ways to run git commands against a specific target
+  entity (e.g., delete a branch, rename a tag, set a remote's URL)
 
 ```
 Git instance
@@ -103,7 +103,7 @@ Cmd objects have methods for mutating or inspecting that entity:
 
 ### Before: Parsing Strings
 
-Without the Manager/Cmd pattern, you'd parse raw output:
+Without Managers and Commands, you'd parse raw output:
 
 ```python
 >>> from libvcs.cmd.git import Git
@@ -115,7 +115,7 @@ Without the Manager/Cmd pattern, you'd parse raw output:
 
 ### After: Typed Objects
 
-With the Manager/Cmd pattern, you get typed objects:
+With Managers and Commands, you get typed objects:
 
 ```python
 >>> from libvcs.cmd.git import Git

src/libvcs/cmd/git.py

@@ -2384,7 +2384,7 @@ def show_ref(
 
 
 class GitSubmoduleCmd:
-    """Run submodule commands in a git repository."""
+    """Run git submodule commands (low-level, use GitSubmoduleManager for traversal)."""
 
     def __init__(self, *, path: StrPath, cmd: Git | None = None) -> None:
         """Lite, typed, pythonic wrapper for git-submodule(1).
@@ -2591,7 +2591,7 @@ def initialized(self) -> bool:
 
 
 class GitSubmoduleEntryCmd:
-    """Run commands directly on a specific git submodule."""
+    """Run git commands targeting a specific submodule."""
 
     def __init__(
         self,
@@ -2945,7 +2945,7 @@ def absorbgitdirs(
 
 
 class GitSubmoduleManager:
-    """Run commands directly related to git submodules of a git repo."""
+    """Traverse and manage git submodules with ORM-like filtering via QueryList."""
 
     def __init__(
         self,
@@ -3633,7 +3633,7 @@ def filter(
 
 
 class GitRemoteCmd:
-    """Run commands directly for a git remote on a git repository."""
+    """Run git commands targeting a specific remote."""
 
     remote_name: str
     fetch_url: str | None
@@ -4178,7 +4178,7 @@ def update(
 
 
 class GitRemoteManager:
-    """Run commands directly related to git remotes of a git repo."""
+    """Traverse and manage git remotes with ORM-like filtering via QueryList."""
 
     remote_name: str
 
@@ -4474,7 +4474,7 @@ def filter(self, *args: t.Any, **kwargs: t.Any) -> list[GitRemoteCmd]:
 
 
 class GitStashEntryCmd:
-    """Run commands directly for a git stash entry on a git repository."""
+    """Run git commands targeting a specific stash entry."""
 
     index: int
     branch: str | None
@@ -4769,7 +4769,7 @@ def create_branch(
 
 
 class GitStashCmd:
-    """Run commands directly against a git stash storage for a git repo."""
+    """Run git stash commands (low-level, use GitStashManager for traversal)."""
 
     def __init__(self, *, path: StrPath, cmd: Git | None = None) -> None:
         """Lite, typed, pythonic wrapper for git-stash(1).
@@ -5007,7 +5007,7 @@ def save(
 
 
 class GitStashManager:
-    """Run commands directly related to git stashes of a git repo."""
+    """Traverse and manage git stashes with ORM-like filtering via QueryList."""
 
     def __init__(
         self,
@@ -5290,7 +5290,7 @@ def filter(self, *args: t.Any, **kwargs: t.Any) -> list[GitStashEntryCmd]:
 
 
 class GitBranchCmd:
-    """Run commands directly against a git branch for a git repo."""
+    """Run git commands targeting a specific branch."""
 
     branch_name: str
 
@@ -5610,7 +5610,7 @@ def track(
 
 
 class GitBranchManager:
-    """Run commands directly related to git branches of a git repo."""
+    """Traverse and manage git branches with ORM-like filtering via QueryList."""
 
     branch_name: str
 
@@ -5869,7 +5869,7 @@ def filter(self, *args: t.Any, **kwargs: t.Any) -> list[GitBranchCmd]:
 
 
 class GitTagCmd:
-    """Run commands directly for a git tag on a git repository."""
+    """Run git commands targeting a specific tag."""
 
     tag_name: str
 
@@ -6055,7 +6055,7 @@ def show(
 
 
 class GitTagManager:
-    """Run commands directly related to git tags of a git repo."""
+    """Traverse and manage git tags with ORM-like filtering via QueryList."""
 
     def __init__(
         self,
@@ -6386,7 +6386,7 @@ def filter(self, *args: t.Any, **kwargs: t.Any) -> list[GitTagCmd]:
 
 
 class GitWorktreeCmd:
-    """Run commands directly against a git worktree entry for a git repo."""
+    """Run git commands targeting a specific worktree."""
 
     def __init__(
         self,
@@ -6637,7 +6637,7 @@ def repair(
 
 
 class GitWorktreeManager:
-    """Run commands directly related to git worktrees of a git repo."""
+    """Traverse and manage git worktrees with ORM-like filtering via QueryList."""
 
     def __init__(
         self,
@@ -6975,7 +6975,7 @@ def filter(self, *args: t.Any, **kwargs: t.Any) -> list[GitWorktreeCmd]:
 
 
 class GitNoteCmd:
-    """Run commands directly against a git note for a git repo."""
+    """Run git commands targeting a specific note."""
 
     def __init__(
         self,
@@ -7253,7 +7253,7 @@ def copy(
 
 
 class GitNotesManager:
-    """Run commands directly related to git notes of a git repo."""
+    """Traverse and manage git notes with ORM-like filtering via QueryList."""
 
     def __init__(
         self,
@@ -7639,7 +7639,7 @@ def cmd(self) -> GitReflogEntryCmd:
 
 
 class GitReflogEntryCmd:
-    """Run commands directly on a specific git reflog entry."""
+    """Run git commands targeting a specific reflog entry."""
 
     def __init__(
         self,
@@ -7803,7 +7803,7 @@ def delete(
 
 
 class GitReflogManager:
-    """Run commands directly related to git reflog of a git repo."""
+    """Traverse and manage git reflog entries with ORM-like filtering via QueryList."""
 
     def __init__(
         self,