axm-git 0.2.0__tar.gz → 0.4.0__tar.gz

{axm_git-0.2.0 → axm_git-0.4.0}/.gitignore

@@ -23,6 +23,7 @@ ENV/
 coverage.xml
 coverage.json
 htmlcov/
+coverage_html/
 .tox/
 
 # Type checking & Linting

{axm_git-0.2.0 → axm_git-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axm-git
-Version: 0.2.0
+Version: 0.4.0
 Summary: Git workflow automation for AXM agents
 Project-URL: Homepage, https://github.com/axm-protocols/axm-git
 Project-URL: Documentation, https://axm-protocols.github.io/axm-git/
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Requires-Dist: axm>=0.1.0
+Requires-Dist: pydantic>=2.0
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -28,8 +29,8 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml"><img src="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
+  <a href="https://forge.axm-protocols.io/audit/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
+  <a href="https://forge.axm-protocols.io/init/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/coverage.json" alt="Coverage"></a>
   <a href="https://pypi.org/project/axm-git/"><img src="https://img.shields.io/pypi/v/axm-git" alt="PyPI"></a>
   <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
@@ -42,13 +43,14 @@ Description-Content-Type: text/markdown
 
 - 🔍 **Preflight** — Structured working tree status with diff summary
 - 🌿 **Branch** — Create or checkout branches with one call
-- 📦 **Commit** — Batched atomic commits with auto-retry on pre-commit fixes
+- 📦 **Commit** — Batched atomic commits with auto-retry on pre-commit fixes and optional author identity injection
 - 🏷️ **Tag** — One-shot semver tagging from Conventional Commits
 - 🚀 **Push** — Push with dirty-check, auto-upstream detection, and force support
 - 🌲 **Worktree** — Add, remove, or list git worktrees
 - 🔀 **PR** — Create GitHub pull requests with optional auto-merge
 - 🧭 **Error Recovery** — When called on a non-git directory, tools suggest nearby git repos
 - 🪝 **Hooks** — Lifecycle hook actions (preflight, create-branch, branch-delete, commit-phase, merge-squash, worktree-add, worktree-remove, push, create-pr, await-merge, pull-main) with `enabled` guard, auto-discovered via entry-points
+- 🪪 **Identity** — Resolve git author from `git-profiles.toml` with schedule-based or explicit profile selection. Schedule rules apply only under user-configured `workspace_paths`; comparison is timezone-aware via the optional `timezone` field (default `Europe/Paris`)
 - 🔎 **Phase Lookup** — `get_phase_commit()` retrieves commit hashes for protocol phases
 
 ## Installation
@@ -62,7 +64,7 @@ uv add axm-git
 ```python
 # Check what changed
 git_preflight(path="/path/to/repo")
-# → {files: [{path: "foo.py", status: "M"}, ...], clean: false}
+# → {files: [{path: "foo.py", status: "M"}, ...], clean: false, text: "git_preflight | 1 files · dirty\n..."}
 
 # Create or switch branch
 git_branch(name="feat/new-feature", path="/path/to/repo")
@@ -95,7 +97,7 @@ Report working tree changes so the agent can plan commits.
 | `path` | `.` | Project root directory |
 | `diff_lines` | `200` | Max diff lines to include (0 to disable) |
 
-Returns: file list with status (`M`, `A`, `D`, `??`), diff stat, clean flag.
+Returns: file list with status (`M`, `A`, `D`, `??`), diff stat, clean flag, and a compact `text` summary for agent display.
 
 ### `git_branch`
 
@@ -118,6 +120,7 @@ Execute one or more atomic commits with pre-commit hook handling.
 |---|---|---|
 | `path` | `.` | Project root directory |
 | `commits` | *required* | List of commit specs (see below) |
+| `profile` | `None` | Identity profile name — overrides schedule-based resolution from `git-profiles.toml` |
 
 Each commit spec:
 
@@ -129,6 +132,8 @@ Each commit spec:
 
 When a pre-commit hook auto-fixes files (e.g. ruff `--fix`), the tool re-stages and retries once automatically.
 
+Identity is resolved once per call (not per commit). When resolved, each commit includes `--author="Name <email>"`. The result includes an `author` key (`{name, email}` or `null`).
+
 ### `git_tag`
 
 Compute the next semver version from Conventional Commits, create and push the tag.

{axm_git-0.2.0 → axm_git-0.4.0}/README.md

@@ -8,8 +8,8 @@
 
 <p align="center">
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml"><img src="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
+  <a href="https://forge.axm-protocols.io/audit/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
+  <a href="https://forge.axm-protocols.io/init/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/coverage.json" alt="Coverage"></a>
   <a href="https://pypi.org/project/axm-git/"><img src="https://img.shields.io/pypi/v/axm-git" alt="PyPI"></a>
   <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
@@ -22,13 +22,14 @@
 
 - 🔍 **Preflight** — Structured working tree status with diff summary
 - 🌿 **Branch** — Create or checkout branches with one call
-- 📦 **Commit** — Batched atomic commits with auto-retry on pre-commit fixes
+- 📦 **Commit** — Batched atomic commits with auto-retry on pre-commit fixes and optional author identity injection
 - 🏷️ **Tag** — One-shot semver tagging from Conventional Commits
 - 🚀 **Push** — Push with dirty-check, auto-upstream detection, and force support
 - 🌲 **Worktree** — Add, remove, or list git worktrees
 - 🔀 **PR** — Create GitHub pull requests with optional auto-merge
 - 🧭 **Error Recovery** — When called on a non-git directory, tools suggest nearby git repos
 - 🪝 **Hooks** — Lifecycle hook actions (preflight, create-branch, branch-delete, commit-phase, merge-squash, worktree-add, worktree-remove, push, create-pr, await-merge, pull-main) with `enabled` guard, auto-discovered via entry-points
+- 🪪 **Identity** — Resolve git author from `git-profiles.toml` with schedule-based or explicit profile selection. Schedule rules apply only under user-configured `workspace_paths`; comparison is timezone-aware via the optional `timezone` field (default `Europe/Paris`)
 - 🔎 **Phase Lookup** — `get_phase_commit()` retrieves commit hashes for protocol phases
 
 ## Installation
@@ -42,7 +43,7 @@ uv add axm-git
 ```python
 # Check what changed
 git_preflight(path="/path/to/repo")
-# → {files: [{path: "foo.py", status: "M"}, ...], clean: false}
+# → {files: [{path: "foo.py", status: "M"}, ...], clean: false, text: "git_preflight | 1 files · dirty\n..."}
 
 # Create or switch branch
 git_branch(name="feat/new-feature", path="/path/to/repo")
@@ -75,7 +76,7 @@ Report working tree changes so the agent can plan commits.
 | `path` | `.` | Project root directory |
 | `diff_lines` | `200` | Max diff lines to include (0 to disable) |
 
-Returns: file list with status (`M`, `A`, `D`, `??`), diff stat, clean flag.
+Returns: file list with status (`M`, `A`, `D`, `??`), diff stat, clean flag, and a compact `text` summary for agent display.
 
 ### `git_branch`
 
@@ -98,6 +99,7 @@ Execute one or more atomic commits with pre-commit hook handling.
 |---|---|---|
 | `path` | `.` | Project root directory |
 | `commits` | *required* | List of commit specs (see below) |
+| `profile` | `None` | Identity profile name — overrides schedule-based resolution from `git-profiles.toml` |
 
 Each commit spec:
 
@@ -109,6 +111,8 @@ Each commit spec:
 
 When a pre-commit hook auto-fixes files (e.g. ruff `--fix`), the tool re-stages and retries once automatically.
 
+Identity is resolved once per call (not per commit). When resolved, each commit includes `--author="Name <email>"`. The result includes an `author` key (`{name, email}` or `null`).
+
 ### `git_tag`
 
 Compute the next semver version from Conventional Commits, create and push the tag.

{axm_git-0.2.0 → axm_git-0.4.0}/docs/explanation/architecture.md

@@ -59,6 +59,7 @@ graph TD
     Branch --> Runner
     Push --> Runner
     PF --> Runner
+    PF -->|"_render_text()"| Preflight
     CB --> Runner
     CP --> Runner
     CP --> PhaseCommit
@@ -91,8 +92,8 @@ graph TD
 Each tool exposes an `execute(*, path, ..., **kwargs) → ToolResult` method with explicit typed parameters:
 
 - **`GitTagTool`** — Full tag workflow: check clean tree, check CI, compute semver bump, create tag, verify hatch-vcs, push.
-- **`GitCommitTool`** — Stage files, commit with pre-commit hooks, auto-retry on linter fixes. Supports batched commits.
-- **`GitPreflightTool`** — Parse `git status --porcelain` and `git diff --stat` into structured data.
+- **`GitCommitTool`** — Stage files, commit with pre-commit hooks, auto-retry on linter fixes. Supports batched commits. Each commit spec is processed by `_process_single_commit()` (validate → stage → commit → record).
+- **`GitPreflightTool`** — Parse `git status --porcelain` and `git diff --stat` into structured data. Uses `find_git_root()` to scope status and diff to the target subdirectory via pathspec, matching the behaviour of `PreflightHook`.
 - **`GitBranchTool`** — Create or checkout a branch. Supports `from_ref` (branch from tag/commit) and `checkout_only` (switch without creating).
 - **`GitPushTool`** — Push with dirty-check guard, auto-upstream detection, custom remote, and force-push support.
 
@@ -100,7 +101,7 @@ Each tool exposes an `execute(*, path, ..., **kwargs) → ToolResult` method wit
 
 Shared logic used by multiple tools:
 
-- **`runner.py`** — `run_git()` and `run_gh()` subprocess wrappers, `gh_available()` auth check, `detect_package_name()` from `pyproject.toml`. Also provides `suggest_git_repos()` (scans for child directories that are git repos) and `not_a_repo_error()` (enriches "not a git repository" errors with suggestions for nearby repos).
+- **`runner.py`** — `find_git_root()` locates the repository root via `rev-parse --show-toplevel`, `run_git()` and `run_gh()` subprocess wrappers, `gh_available()` auth check, `detect_package_name()` from `pyproject.toml`. Also provides `suggest_git_repos()` (scans for child directories that are git repos) and `not_a_repo_error()` (enriches "not a git repository" errors with suggestions for nearby repos). All subprocess call-sites pass an explicit `timeout=` kwarg (defaults: `DEFAULT_GIT_TIMEOUT=30s`, `DEFAULT_GH_TIMEOUT=120s`, `uv sync`=600s); `run_git`/`run_gh` log a warning and re-raise `subprocess.TimeoutExpired`, which tool entry points catch and convert to `ToolResult` via `timeout_error_result()`. This is an interim shim pending `axm-common.run_safe`.
 - **`semver.py`** — `parse_tag()` for version parsing, `compute_bump()` for Conventional Commits analysis (returns `VersionBump` with next version + reason).
 - **`phase_commit.py`** — `get_phase_commit()` looks up the commit hash for a given protocol phase name by searching git log.
 
@@ -110,7 +111,7 @@ Lifecycle hook actions conforming to the `HookAction` protocol from `axm.hooks.b
 
 All hooks accept an `enabled` param (default `True`). Pass `enabled=False` to skip git operations entirely (returns `HookResult.ok(skipped=True, reason="git disabled")`).
 
-- **`PreflightHook`** — Runs a structured working tree status check before a phase begins. Entry point: `git:preflight`.
+- **`PreflightHook`** — Runs a structured working tree status check before a phase begins. Returns a compact `text` render (via `_render_text` from `commit_preflight`) alongside structured metadata. Entry point: `git:preflight`.
 - **`CreateBranchHook`** — Creates a session branch. Accepts `branch`, `ticket_id`, `ticket_title`, and `ticket_labels` params; `_resolve_branch()` derives the final branch name from those inputs. Skips if not a git repo.
 - **`BranchDeleteHook`** — Deletes a branch via `git branch -D`. Branch name resolved from `branch` param then `branch` context key. Entry point: `git:branch-delete`.
 - **`CommitPhaseHook`** — Stages all changes, commits with `[axm] {phase_name}`. Pass `from_outputs=True` to derive staged files from protocol outputs instead of staging everything. Skips if nothing to commit.

{axm_git-0.2.0 → axm_git-0.4.0}/docs/index.md

@@ -7,8 +7,8 @@
 
 <p align="center">
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml"><img src="https://github.com/axm-protocols/axm-forge/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
-  <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
+  <a href="https://forge.axm-protocols.io/audit/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-audit.json" alt="axm-audit"></a>
+  <a href="https://forge.axm-protocols.io/init/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/axm-init.json" alt="axm-init"></a>
   <a href="https://github.com/axm-protocols/axm-forge/actions/workflows/axm-quality.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-forge/gh-pages/badges/axm-git/coverage.json" alt="Coverage"></a>
   <a href="https://pypi.org/project/axm-git/"><img src="https://img.shields.io/pypi/v/axm-git" alt="PyPI"></a>
   <img src="https://img.shields.io/badge/python-3.12+-blue.svg" alt="Python 3.12+" />

{axm_git-0.2.0 → axm_git-0.4.0}/docs/reference/cli.md

@@ -27,4 +27,4 @@ Hook actions auto-discovered via the `axm.hooks` entry-point group by `HookRegis
 
 ## Python API
 
-Auto-generated API reference is available under [Python API](api/).
+Auto-generated API reference is available under [Python API](../../reference/axm_git/index.md).

{axm_git-0.2.0 → axm_git-0.4.0}/docs/tutorials/getting-started.md

@@ -114,4 +114,4 @@ The tool verifies the tree is clean before pushing, and automatically sets the u
 ## Next Steps
 
 - [Architecture](../explanation/architecture.md) — How the project is structured
-- [API Reference](../reference/api/) — Full API documentation
+- [API Reference](../../reference/axm_git/index.md) — Full API documentation

axm_git-0.4.0/pyproject.toml

@@ -0,0 +1,382 @@
+[project]
+name = "axm-git"
+dynamic = ["version"]
+description = "Git workflow automation for AXM agents"
+readme = "README.md"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.12"
+authors = [{ name = "Gabriel", email = "gabriel@axm.dev" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+    "License :: OSI Approved :: Apache Software License",
+]
+
+dependencies = [
+    "axm>=0.1.0",
+    "pydantic>=2.0",
+]
+
+[project.entry-points."axm.tools"]
+git_tag       = "axm_git.tools.tag:GitTagTool"
+git_preflight = "axm_git.tools.commit_preflight:GitPreflightTool"
+git_commit    = "axm_git.tools.commit:GitCommitTool"
+git_branch    = "axm_git.tools.branch:GitBranchTool"
+git_push      = "axm_git.tools.push:GitPushTool"
+git_clone     = "axm_git.tools.clone:GitCloneTool"
+git_worktree  = "axm_git.tools.worktree:GitWorktreeTool"
+git_pr        = "axm_git.tools.pr:GitPRTool"
+
+[project.entry-points."axm.hooks"]
+"git:branch-delete"  = "axm_git.hooks.branch_delete:BranchDeleteHook"
+"git:create-branch"  = "axm_git.hooks.create_branch:CreateBranchHook"
+"git:commit-phase"   = "axm_git.hooks.commit_phase:CommitPhaseHook"
+"git:merge-squash"   = "axm_git.hooks.merge_squash:MergeSquashHook"
+"git:preflight"      = "axm_git.hooks.preflight:PreflightHook"
+"git:worktree-add"   = "axm_git.hooks.worktree_add:WorktreeAddHook"
+"git:worktree-remove" = "axm_git.hooks.worktree_remove:WorktreeRemoveHook"
+"git:push"            = "axm_git.hooks.push:PushHook"
+"git:create-pr"       = "axm_git.hooks.create_pr:CreatePRHook"
+"git:await-merge"     = "axm_git.hooks.await_merge:AwaitMergeHook"
+"git:pull-main"       = "axm_git.hooks.pull:PullHook"
+
+[project.urls]
+Homepage = "https://github.com/axm-protocols/axm-git"
+Documentation = "https://axm-protocols.github.io/axm-git/"
+Repository = "https://github.com/axm-protocols/axm-git.git"
+Issues = "https://github.com/axm-protocols/axm-git/issues"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+tag-pattern = "git/v(?P<version>.*)"
+raw-options = { root = "../..", git_describe_command = "git describe --dirty --tags --long --match git/v*" }
+fallback-version = "0.1.0.dev0"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/axm_git/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/axm_git"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"docs/index.md" = "axm_git/docs/index.md"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# UV Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.uv]
+managed = true
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-cov>=7.1.0",
+    "pytest-mock>=3.15.1",
+    "ruff==0.15.15",
+    "mypy>=1.20.0",
+    "pre-commit>=4.0",
+    "pip-audit>=2.0",
+]
+docs = [
+    "mkdocs-material>=9.0",
+    "mkdocstrings[python]>=1.0.3",
+    "mkdocs-gen-files>=0.5",
+    "mkdocs-literate-nav>=0.6.3",
+]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Ruff Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+src = ["src", "tests"]
+exclude = ["*/_version.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "UP", "B", "BLE", "C4", "C901", "S", "T20", "PLE", "PLR", "RUF"]
+ignore = ["S101", "S603", "S607"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101", "S105", "S106", "S108", "S603", "S607", "PLR2004", "PLR0913"]
+"src/axm_git/hooks/await_merge.py" = ["PLR0911"]
+"src/axm_git/tools/tag.py" = ["PLR0911"]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.lint.pylint]
+max-args = 5
+max-branches = 12
+max-returns = 6
+max-statements = 50
+max-locals = 15
+
+[tool.ruff.lint.isort]
+known-first-party = ["axm_git"]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# MyPy Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.mypy]
+python_version = "3.12"
+strict = true
+disallow_any_generics = true
+disallow_any_unimported = true
+disallow_any_explicit = true
+pretty = true
+warn_return_any = true
+warn_unused_ignores = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+disallow_untyped_defs = false
+disallow_any_explicit = false
+disable_error_code = [
+    "index",
+    "arg-type",
+    "attr-defined",
+    "operator",
+    "union-attr",
+    "call-overload",
+]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Pytest Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+python_files = "test_*.py"
+addopts = [
+    "-v",
+    "--strict-markers",
+    "--strict-config",
+    "--tb=short",
+    "--import-mode=importlib",
+    "--cov=src/axm_git",
+    "--cov-report=term-missing",
+    "--cov-report=html:coverage_html",
+    "--cov-report=xml",
+    "--cov-fail-under=0",
+]
+filterwarnings = ["error"]
+markers = [
+    "integration: tests that touch real I/O (git, filesystem, network)",
+    "e2e: end-to-end tests via subprocess/CLI",
+]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Coverage Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.coverage.run]
+source = ["src/axm_git"]
+branch = true
+relative_files = true
+omit = ["*/tests/*"]
+
+[tool.coverage.xml]
+output = "coverage.xml"
+
+[tool.coverage.report]
+exclude_lines = ["pragma: no cover", "if TYPE_CHECKING:", "raise NotImplementedError"]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Git-Cliff Changelog Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.git-cliff.changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+"""
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [Unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        - {{ commit.message | upper_first }}\
+    {% endfor %}
+{% endfor %}
+"""
+trim = true
+
+[tool.git-cliff.git]
+conventional_commits = true
+filter_unconventional = true
+commit_parsers = [
+    { message = "^chore", skip = true },
+    { message = "^ci", skip = true },
+    { message = "^feat", group = "🚀 Features" },
+    { message = "^fix", group = "🐛 Bug Fixes" },
+    { message = "^doc", group = "📚 Documentation" },
+    { message = "^perf", group = "⚡ Performance" },
+    { message = "^refactor", group = "🔧 Refactor" },
+    { message = "^test", group = "🧪 Tests" },
+]
+tag_pattern = "git/v[0-9].*"
+include_path = "packages/axm-git/**"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Deptry Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.deptry]
+known_first_party = ["axm_git"]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# axm-audit Configuration
+# ─────────────────────────────────────────────────────────────────────────────
+[tool.axm-audit.mirror]
+# I/O-heavy git hooks: fully covered by tests/integration/ scenarios that
+# exercise real subprocess calls. Unit-level mock-everything tests would
+# duplicate coverage with weaker assertions.
+exempt_paths = [
+    "hooks/branch_delete.py",
+    "hooks/create_branch.py",
+    "hooks/merge_squash.py",
+    "hooks/worktree_add.py",
+    "hooks/worktree_remove.py",
+    "core/phase_commit.py",
+]
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "99ce49e6bcd9"
+reason = "6 failure-path tests across 3 classes assert on distinct error messages (commit_spec presence, type, files key, missing-file diagnostics, retry exhaustion) and use different fixtures (mock-based vs real-repo) -- parametrization would erase the validation/diagnostic divergence"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "7e0906172112"
+reason = "tests cover two distinct repo layouts (flat git repo via tmp_git_repo vs nested workspace via tmp_workspace_repo with tuple unpacking) -- different fixtures and scenarios, no shared data to parametrize"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "5ef18a0e31ec"
+reason = "tests cover opposite branches of retry-on-autofix control flow (retry path with 4 mocked git calls and stage call_count==2 vs clean path with 3 mocked git calls and stage call_count==1) -- collapsing them would obscure the call-sequence verification that is the whole point"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "3a0c99a704de"
+reason = "three verify_hatch_vcs failure paths exercise structurally different subprocess mock setups (return_value with rc=1 for sync_fails, side_effect callback with call counter for version_check_fails, side_effect=FileNotFoundError for uv_not_found) -- collapsing into parametrize would erase the mock-setup divergence that documents each failure mode"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "e3d125f53c7c"
+reason = "test_dirty_tree and test_ci_red_blocks cover unrelated GitTagTool preconditions (dirty working tree vs red CI) and patch different collaborators (run_git status output vs check_ci return value) -- shared shape is just `execute fails` but the failure cause and the patched seam differ"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "8efb16a1f64a"
+reason = "test_deleted_tracked_file_stages_successfully stages a pure deletion (file removed from disk, staged as `D`), while test_deleted_then_recreated_file stages a deletion followed by recreation with different content (staged as content modification on a re-existing file) -- distinct git states despite identical assertions, parametrize would obscure the disk-state divergence"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "31cab244bf8d"
+reason = "11 tests span three classes (TestResolveIdentity, TestScheduleBoundaries, TestIsAxmWorkspace) and three concerns (schedule resolution by time/day, schedule boundary inclusivity, axm-workspace detection) with several inline-TOML setups (default VALID_TOML, minimal `[default]` only, multi-rule first-wins, symlink) -- collapsing into a single parametrize would conflate three independent behaviors and obscure the per-class documentation intent"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "53396655fe5b"
+reason = "parse_tag cluster mixes 3 success-path equality assertions (parse_tag(s) == tuple) with 1 pytest.raises ValueError invalid case -- success vs raises observation surfaces are heterogeneous, parametrize would force an awkward optional-expected/optional-raises matrix that erases the failure-mode documentation"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "b52a6d37c8d3"
+reason = "three resolve_identity scenarios document distinct workspace-paths topologies (single-path match, multi-path selection where target is in second root, symlink resolution of a real_root via link) -- shared `result.name == Work` assertion masks substantively different setup graphs that the test names are meant to surface"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "a75d19003c8d"
+reason = "outside-paths vs empty-paths exercise opposite branches of the workspace-paths fall-through (non-empty list with target outside, vs empty list short-circuit) -- both reach the default identity but via different code paths and different fixture topologies, parametrize would collapse the branch-coverage intent"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "8f4b32ba6350"
+reason = "closed-without-merge and network-error exercise distinct failure paths (PR state=CLOSED with rc=0 vs gh subprocess rc=1 stderr) with different mock setups and different error-message substrings (`closed without merging` vs `failed to query`) -- the failure-mode divergence is the whole point"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "edd3b4d908fd"
+reason = "test_git_failure patches only run_git and asserts the bare 'not a git repository' message, while test_not_git_repo_no_suggestions also patches suggest_git_repos and verifies the no-suggestions branch -- different patch topologies and different error-rendering branches, parametrize would require an awkward optional-second-patch matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "045fc214b278"
+reason = "7 load_config tests span 3 behavior groups -- silent_on_missing/empty assert result is None AND caplog.records == 0 (no warning), missing_file/invalid_toml/empty_file assert result is None ONLY (no caplog observation), warns_on_malformed_toml/invalid_schema assert result is None AND caplog.records >= 1 (warning emitted) -- the warning-emission observation surface differs across groups (zero vs none vs nonzero), and the file-content fixtures encode the silent-vs-noisy contract that parametrize would erase"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "754178fe7dfb"
+reason = "4 suggest_git_repos tests exercise 4 distinct directory topologies and 4 different return shapes -- finds_repos builds two child .git dirs (returns sorted [alpha, beta]), in_git_repo plants .git at the root itself (early-return []), no_children uses bare tmp_path (returns []), permission_error chmod 0o000 on a sibling with try/finally cleanup (returns [ok] despite the unreadable peer) -- shared assertion is `result == list[str]` but the values, setups, and the os-permission-recovery teardown differ substantively"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "f1c75d2de6f0"
+reason = "4 gh_available tests exercise structurally distinct mock topologies for the shutil.which + subprocess.run pair -- not_installed (which=None, subprocess never called), auth_ok (which=path + CompletedProcess rc=0), auth_fail (which=path + CompletedProcess rc=1), timeout (which=path + subprocess raises TimeoutExpired) -- each documents an independent failure/success seam, parametrize would force a 3-axis (which_value, return_value, side_effect) matrix that erases the per-failure-mode intent"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "8ceb7c3d4980"
+reason = "test_commit_with_identity (single commit) and test_batch_commits_same_identity (two commits) exercise different SUT shapes -- single asserts len(commit_calls)==1 with one _AUTHOR_FLAG check, batch asserts len(commit_calls)==2 with per-call _AUTHOR_FLAG iteration AND resolve_identity.assert_called_once verifying identity is cached across commits not re-resolved per commit -- batch documents a caching invariant single cannot, parametrize would erase the per-commit-iteration assertion"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "5d1c55c2cc51"
+reason = "test_not_found patches run_git to return empty stdout (exercises the git-ran-but-no-match branch), while test_not_git_repo skips mocking entirely and relies on the .git directory absence guard (exercises the early-return branch before any subprocess call) -- shared `result is None` assertion masks two structurally different mock topologies and two distinct control-flow exits"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "9298be6e5099"
+reason = "test_no_suggestions feeds the 'fatal: not a git repository' string with no child .git dirs (asserts no suggestions in result.data), while test_other_error_passthrough feeds an unrelated 'fatal: some other error' message with a child .git planted (asserts the scanner short-circuits on non-repo errors) -- different error inputs, different scanner branches, different substring assertions ('not a git repository' vs 'some other error')"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "e84d13905500"
+reason = "test_commit_legacy_with_identity drives the legacy `_commit_legacy` codepath with the `_run_git_success` fixture (status/add/commit/rev-parse mocks, no commit_spec in context), while test_commit_from_outputs_with_identity drives the newer `commit_from_outputs` codepath with `_commit_from_outputs_deps` fixture (ls-files/diff/add/commit mocks plus a commit_spec dict in context) -- two distinct SUT entry points, two distinct fixture topologies, parametrize would conflate the legacy/modern API boundary"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "1e9f84905d11"
+reason = "test_branch_delete_success uses the flat `tmp_git_repo: Path` fixture and runs the hook with working_dir == git root, while test_subdirectory_of_git_repo uses the nested `tmp_workspace_repo: tuple[Path, Path]` fixture (git_root, pkg_dir unpacking) and runs the hook with working_dir == pkg_dir to exercise sub-directory resolution -- different fixture shapes, different working-dir topologies, parametrize cannot bridge tuple-vs-Path fixtures cleanly"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "3cb3f5c55fe3"
+reason = "11 tests span 8 hook classes (CommitPhaseHook, CreateBranchHook, BranchDeleteHook, PullHook, PushHook, WorktreeAddHook, WorktreeRemoveHook, AwaitMergeHook) across 2 pyramid levels (10 integration + 1 unit) with 4+ distinct fixtures (tmp_path, tmp_git_repo, _make_context, monkeypatch-only) and 2 metadata observation surfaces (skipped is True vs pulled/pushed is True for pull_already_up_to_date and push_everything_up_to_date) -- worktree_remove::test_skip_missing_path even uses tmp_git_repo for a different skip reason (missing worktree path, not non-repo); the apparent shared shape `success + boolean metadata` hides 8 distinct hook contracts that cannot share a fixture or parametrize cleanly"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "0c17112c5c87"
+reason = "8 tests across 5 files exercise distinct SUTs and fixtures -- CommitPhaseHook::test_workspace_nothing_to_commit uses tmp_workspace_repo tuple-unpacking with run_git side-effects; PreflightHook::test_not_a_repo uses bare tmp_path while test_clean_repo uses tmp_git_repo (different repo setup, both via shared conftest); PullHook/PushHook ::test_*_not_git_repo use tmp_path with no monkeypatching; CreatePRHook trio (test_create_pr_skip_no_gh patches only gh_available=False, test_create_pr_already_exists patches gh_available+run_gh with conditional rc=1 stderr 'already exists' AND a gh view JSON response, test_create_pr_auto_merge_failure_non_fatal patches gh_available+run_gh with rc=0 for create + rc=1 for merge) -- each has a distinct mock topology and asserts on different metadata keys (skipped/reason vs pr_url/already_existed vs pr_url/auto_merge=False), parametrize would erase the per-failure-mode setup divergence"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "e7377c7b0e34"
+reason = "5 tests across 4 files target 4 distinct hook SUTs (BranchDeleteHook, CreateBranchHook, MergeSquashHook, PreflightHook) with different fixtures and context shapes -- branch_delete_from_context resolves branch from context dict on tmp_git_repo, create_branch::test_default_working_dir uses monkeypatch.chdir to test the '.' fallback while test_create_branch_session_fallback uses working_dir-in-context path (different setup mechanism for branch naming), merge_squash_branch_from_context requires tmp_git_repo_with_named_branch (pre-created branch fixture), preflight_dict_worktree_path tests dict-typed worktree_path unwrapping with a one-file dirty repo -- different hook contracts, different context-resolution paths, no shared parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "ba0764a49848"
+reason = "canonical 'every hook has a disabled test' pattern -- 4 tests across 4 files instantiate 4 distinct hook classes (CommitPhaseHook, CreateBranchHook, BranchDeleteHook, MergeSquashHook) with hook-specific context payloads (phase_name for commit_phase, session_id+protocol_name for merge_squash, session_id only for branch hooks); each test documents the per-hook 'enabled=False short-circuits to skipped reason=git disabled' contract for its own SUT and cannot be folded across hook classes without losing the per-hook coverage signal"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "e7e9aeba284a"
+reason = "ambiguous_distinct_sut -- 4 disabled-path tests instantiate 4 different hook classes (PreflightHook, WorktreeAddHook, PullHook, PushHook) split across pyramid levels (2 integration with real fixtures: tmp_git_repo + _make_context helper; 2 unit with no fixtures: working_dir='.' literal); the per-hook disabled-contract assertion cannot be parametrized across distinct hook constructors and distinct context shapes (worktree_add needs ticket_id, pull/push need only working_dir)"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "37d744e2512d"
+reason = "ambiguous_template_pair -- 4 `test_name` assertions across 4 distinct MCP tool classes (GitBranchTool, GitPRTool, GitPushTool, GitWorktreeTool) each verifying its own .name string literal ('git_branch', 'git_pr', 'git_push', 'git_worktree'); identical shape but heterogeneous SUTs with hard-coded per-tool string contracts, no parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "00c56eb1fb91"
+reason = "ambiguous_template_pair -- 3 `test_name` assertions across 3 distinct MCP tool classes (GitCommitTool, GitPreflightTool, GitTagTool) each verifying its own .name string literal ('git_commit', 'git_preflight', 'git_tag'); cookie-cutter shape but heterogeneous SUTs with hard-coded per-tool string contracts, no parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "b8af6ffac47d"
+reason = "ambiguous_distinct_literals -- 3 failure-path tests target 3 distinct hook SUTs (CreateBranchHook, PullHook, PushHook): branch_exists_fails uses tmp_git_repo and double-execute to trigger 'branch already exists' git error, pull_hook_failure uses monkeypatched run_git returning rc=1 stderr 'fatal: couldn't find remote ref', push_hook_fail_on_error uses monkeypatched run_git rc=1 stderr 'remote rejected' with branch in context -- distinct fixtures, distinct trigger mechanisms (real git collision vs mocked subprocess), distinct error strings, no parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "ff1f29f7b19a"
+reason = "ambiguous_distinct_literals -- 3 *_disabled tests instantiate 3 distinct hook SUTs (WorktreeRemoveHook, AwaitMergeHook, CreatePRHook) across 2 pyramid levels (1 integration with tmp_git_repo + repo_path/worktree_path context; 2 unit with no fixtures + working_dir='.' literal); each test documents the per-hook enabled=False short-circuit contract with hook-specific context payloads (worktree_remove needs worktree_path, await_merge needs only working_dir, create_pr needs only working_dir) -- the per-hook disabled-contract cannot be parametrized across distinct hook constructors and distinct minimal context shapes"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "bc21505a59bc"
+reason = "ambiguous_distinct_literals -- 3 dict-worktree-path tests target 3 distinct hook SUTs (PullHook, PushHook, CreatePRHook) across 2 pyramid levels (2 integration with tmp_git_repo + run_git mocks; 1 unit with run_gh mock and /tmp/wt literal) -- each patches a different subprocess seam (axm_git.hooks.pull.run_git vs axm_git.hooks.push.run_git with rev-parse branch vs axm_git.hooks.create_pr.run_gh with gh_available + create_pr.commit_spec context) and asserts captured_cwd against a different path source (tmp_git_repo Path vs /tmp/wt literal) -- the dict-unwrap contract is identical but the mock topology and context shape diverge per hook, no parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "393d37013529"
+reason = "ambiguous_distinct_literals -- 2 missing-input failure tests target distinct hook SUTs and distinct error contracts: BranchDeleteHook::test_branch_delete_missing_branch runs on tmp_git_repo with no branch in context/params, asserts error contains 'no branch specified' (input-validation branch in branch-delete); AwaitMergeHook::test_await_merge_no_pr_ref runs with monkeypatched gh_available=True and no pr_number/pr_url, asserts error contains 'no pr_number or pr_url' (pre-poll guard in await-merge) -- different SUTs, different setup (real-repo vs gh-mock), different error substrings, no parametrizable matrix"
+
+[[tool.axm-audit.duplicate_tests.acknowledged]]
+hash = "e714397697ca"
+reason = "signal1_call_assert -- 2 entry-point load tests target distinct hook SUTs and distinct entry-point names: test_commit_phase_hook_loads loads 'git:commit-phase' and asserts ep.load() is CommitPhaseHook; test_preflight_hook_loads loads 'git:preflight' and asserts ep.load() is PreflightHook -- the cookie-cutter shape (entry_points lookup + identity check) hides hard-coded per-hook string-and-class pairs that cannot be parametrized without losing the per-hook entry-point contract documentation"

{axm_git-0.2.0 → axm_git-0.4.0}/src/axm_git/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.0'
-__version_tuple__ = version_tuple = (0, 2, 0)
+__version__ = version = '0.4.0'
+__version_tuple__ = version_tuple = (0, 4, 0)
 
 __commit_id__ = commit_id = None

axm_git-0.4.0/src/axm_git/core/__init__.py

@@ -0,0 +1,17 @@
+"""Core logic — subprocess runners and semver computation."""
+
+from axm_git.core.identity import (
+    GitIdentity,
+    GitProfileConfig,
+    author_args,
+    load_config,
+    resolve_identity,
+)
+
+__all__ = [
+    "GitIdentity",
+    "GitProfileConfig",
+    "author_args",
+    "load_config",
+    "resolve_identity",
+]