cmd(git): More commands

[tony]

Changes

Commands (git)

This PR introduces the Manager/Cmd pattern for git subcommands, providing typed Python objects instead of raw strings.

Pattern Overview

Manager (collection-level)              Cmd (per-entity)
├── ls() -> QueryList[Cmd]              ├── run()
├── get(**kwargs) -> Cmd                ├── show()
├── filter(**kwargs) -> list[Cmd]       ├── remove()/delete()
├── add() / create()                    └── entity-specific operations
└── run()

---

Add GitBranchManager (git.branches) - collection-level branch operations

• ls() - List branches, returns QueryList[GitBranchCmd]
  • _all - List all branches (local + remote)
  • remotes - List remote branches only
  • merged / no_merged - Filter by merge status
  • contains - Branches containing commit
  • verbose - Show tracking info
• get(**kwargs) - Get single branch by filter
• filter(**kwargs) - Filter branches
• checkout(branch) - Checkout a branch
• create(branch) - Create new branch via checkout -b

Add GitBranchCmd (git.branches.get(...)) - instance-based mutations of a branch

• checkout() - git checkout <branchname>
• create() - git checkout -b <branchname>
• delete(force) - git branch -d / -D
• rename(new_name, force) - git branch -m / -M
• copy(new_name, force) - git branch -c / -C
• set_upstream(upstream) - git branch --set-upstream-to
• unset_upstream() - git branch --unset-upstream
• track(remote_branch) - git branch -t

---

Add GitRemoteManager (git.remotes) - collection-level remote operations

• ls() - List remotes, returns QueryList[GitRemoteCmd]
• get(**kwargs) - Get single remote by filter
• filter(**kwargs) - Filter remotes
• add(name, url, ...) - Add new remote
• show(name, verbose) - Show remotes

Enhance GitRemoteCmd (git.remotes.get(...)) - instance-based remote operations

• rename(new_name, progress) - Rename remote
• remove() - Delete remote
• show(verbose, no_query_remotes) - Show remote details
• prune(dry_run) - Prune stale branches
• get_url(push, _all) - Get remote URL
• set_url(url, push, add, delete) - Set remote URL
• set_branches(*branches, add) - Set tracked branches
• set_head(branch, auto, delete) - Set HEAD reference
• update(prune) - Update remote

---

Add GitStashManager (git.stashes) - collection-level stash operations

• ls() - List stashes, returns QueryList[GitStashEntryCmd]
• get(**kwargs) - Get single stash by filter
• filter(**kwargs) - Filter stashes
• push(message, path, patch, staged, ...) - Push to stash
• clear() - Clear all stashes

Add GitStashEntryCmd (git.stashes.get(...)) - instance-based stash operations

• show(stat, patch) - Show stash diff
• apply(index) - Apply without removing
• pop(index) - Apply and remove
• drop() - Delete this stash
• branch(branch_name) - Create branch from stash

---

Add GitTagManager (git.tags) - collection-level tag operations

• ls(pattern, sort, contains, merged, ...) - List tags, returns QueryList[GitTagCmd]
• get(**kwargs) - Get single tag by filter
• filter(**kwargs) - Filter tags
• create(name, ref, message, annotate, sign, force) - Create tag

Add GitTagCmd (git.tags.get(...)) - instance-based tag operations

• show() - Show tag details
• delete() - Delete tag
• verify() - Verify signed tag

---

Add GitWorktreeManager (git.worktrees) - collection-level worktree operations

• ls() - List worktrees, returns QueryList[GitWorktreeCmd]
• get(**kwargs) - Get single worktree by filter
• filter(**kwargs) - Filter worktrees
• add(path, branch, detach, checkout, lock, force) - Add worktree
• prune(dry_run, verbose, expire) - Prune worktrees

Add GitWorktreeCmd (git.worktrees.get(...)) - instance-based worktree operations

• remove(force) - Remove worktree
• lock(reason) - Lock worktree
• unlock() - Unlock worktree
• move(new_path) - Move worktree
• repair() - Repair worktree

---

Add GitNotesManager (git.notes) - collection-level notes operations

• ls(ref) - List notes, returns QueryList[GitNoteCmd]
• get(**kwargs) - Get single note by filter
• filter(**kwargs) - Filter notes
• add(object, message, file, force, allow_empty) - Add note
• prune(dry_run, verbose) - Prune notes
• merge(notes_ref, strategy, commit, abort, quiet) - Merge notes
• get_ref() - Get notes ref

Add GitNoteCmd (git.notes.get(...)) - instance-based note operations

• show() - Show note
• append(message) - Append to note
• copy(from_object) - Copy note
• remove() - Remove note

---

Add GitSubmoduleManager (git.submodules) - collection-level submodule operations

• ls() - List submodules, returns QueryList[GitSubmoduleEntryCmd]
• get(**kwargs) - Get single submodule by filter
• filter(**kwargs) - Filter submodules
• add(url, path, branch, name, force) - Add submodule
• foreach(command, recursive) - Execute in each submodule
• sync(recursive) - Sync submodule URLs
• summary(commit, files, cached) - Summarize changes

Add GitSubmoduleEntryCmd (git.submodules.get(...)) - instance-based submodule operations

• init() - Initialize this submodule
• update(init, force, checkout, rebase, merge, recursive) - Update
• deinit(force) - Unregister submodule
• set_branch(branch) - Set branch
• set_url(url) - Set URL
• status() - Show status
• absorbgitdirs() - Absorb gitdir

---

Add GitReflogManager (git.reflog) - collection-level reflog operations

• ls(ref) - List reflog entries, returns QueryList[GitReflogEntryCmd]
• get(**kwargs) - Get single entry by filter
• filter(**kwargs) - Filter entries
• expire(ref, _all, dry_run, rewrite, ...) - Expire entries
• exists(ref) - Check if reflog exists

Add GitReflogEntryCmd (git.reflog.get(...)) - instance-based reflog operations

• show() - Show entry details
• delete(rewrite, updateref) - Delete entry

---

Enhance Git.init() - additional parameters and validation

• ref_format - --ref-format (files/reftable)
• make_parents - Auto-create parent directories (default: True)
• shared - Extended to support octal permissions (e.g., "0660")
• Improved parameter validation with clear error messages

[codecov]

Codecov Report

❌ Patch coverage is 99.49367% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 51.77%. Comparing base (4e29246) to head (4e3ca5f).

Files with missing lines	Patch %	Lines
tests/cmd/test_git.py	99.48%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #465      +/-   ##
==========================================
+ Coverage   42.90%   51.77%   +8.86%     
==========================================
  Files          38       38              
  Lines        3627     5451    +1824     
  Branches      794     1037     +243     
==========================================
+ Hits         1556     2822    +1266     
- Misses       1718     2104     +386     
- Partials      353      525     +172     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.