conventional-git 2.1.1__tar.gz → 2.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.claude-plugin/plugin.json +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.github/workflows/ci.yml +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.github/workflows/publish.yml +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.github/workflows/python.yml +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.gitignore +1 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.pre-commit-config.yaml +3 -3
- {conventional_git-2.1.1 → conventional_git-2.2.0}/AGENTS.md +5 -3
- {conventional_git-2.1.1 → conventional_git-2.2.0}/Makefile +3 -5
- {conventional_git-2.1.1 → conventional_git-2.2.0}/PKG-INFO +7 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/README.md +6 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/dictionary.txt +1 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/agent-skills-format.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-install-scopes.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-marketplace-install.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-plugin-updates.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-shell-install.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-skill-invocation.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/install-channels.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/npx-skills-install.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/npx-skills-manage.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/opencode-mcp-config.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/opencode-skill-discovery.md +1 -1
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/opencode-skill-permissions.md +1 -1
- conventional_git-2.2.0/docs/enforcement/attribution-trailers.md +31 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/log.md +21 -0
- conventional_git-2.2.0/docs/toolchain/layering-rule.md +28 -0
- conventional_git-2.2.0/hooks/hooks.json +31 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/mk/python.mk +5 -5
- {conventional_git-2.1.1 → conventional_git-2.2.0}/package.json +2 -2
- {conventional_git-2.1.1 → conventional_git-2.2.0}/pnpm-lock.yaml +284 -278
- conventional_git-2.2.0/pnpm-workspace.yaml +3 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/pyproject.toml +19 -4
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/check.py +20 -0
- conventional_git-2.2.0/src/conventional_git/cli/pr_command.py +94 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/commit/rules.py +23 -7
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_cli_smoke.py +70 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_commit_rules.py +19 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_plugin_version.py +19 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/uv.lock +207 -211
- conventional_git-2.1.1/docs/enforcement/attribution-trailers.md +0 -18
- conventional_git-2.1.1/docs/toolchain/layering-rule.md +0 -28
- conventional_git-2.1.1/pnpm-workspace.yaml +0 -2
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.claude-plugin/marketplace.json +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.editorconfig +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.github/dependabot.yml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.markdownlint-cli2.jsonc +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.markdownlint.yaml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.mcp.json +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/.pre-commit-hooks.yaml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/CONTRIBUTING.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/LICENSE +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/checkmake.ini +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/cspell.config.yaml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/opencode-mcp-server.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/plugin-identity.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/optional-extras.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/three-layers.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/validation-vs-generation.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/violation-contract.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/architecture/vocabulary-as-data.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/claude-md-check.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/commits-and-branches.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/commits-check.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/help-check.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/tag-vocabulary.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/conventions/versioning.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/branch-name-gap.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/ci-recipe.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/commitizen-adapter.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/git-hooks.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/hook-install-path.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/house-rules.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/pre-commit-framework.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/pre-commit-local-hooks.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/enforcement/skill-vocabulary-copies.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/behavior-vs-cli.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/extra-path.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/install.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/recommended-config.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/when-to-use.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/gitlint/wiring.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/describe-convention.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/no-auth-tools.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/out-of-band-auth.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/plugin-bundled-server.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/self-correction-loop.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/server-install.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/suggest-commit-message.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/mcp/validate-tools.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/python/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/python/interpreter-source.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/python/pyproject-defaults.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/release/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/release/pypi-trusted-publishing.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/apply-does-not-commit.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/data-egress.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/keyring-scope.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/llm-extra-install.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/provider-fallback.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/suggestions/providers-and-credentials.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/toolchain/extras-self-reference.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/toolchain/index.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/toolchain/rejected-install-backends.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/toolchain/retag-notes.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/docs/toolchain/sh-uid-unused.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/mise.toml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/mk/.gitkeep +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/mk/conventional-git.mk +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/okf-base.yaml +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-auth/SKILL.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-branch/SKILL.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-branch/references/branch-types.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-commit/SKILL.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-commit/references/commit-types.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/skills/conventional-suggest/SKILL.md +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/adapters/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/adapters/commitizen_config.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/adapters/gitlint_rules.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/branch/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/branch/grammar.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/branch/rules.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/branch/vocabulary.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/app.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/auth.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/capabilities.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/create.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/hook.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/cli/mcp.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/commit/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/commit/compose.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/commit/grammar.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/commit/vocabulary.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/config.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/csv_columns.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/branch-exempt-prefixes.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/branch-trunks.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/branch-types.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/commit-attribution.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/data/commit-types.csv +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/credentials.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/diff.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/heuristic.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/protocol.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/generation/typesafe.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/helpers.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/mcp/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/mcp/server.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/py.typed +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/src/conventional_git/violations.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/__init__.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_branch_rules.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_branch_vocabulary.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_cli_auth.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_cli_capabilities.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_cli_hook.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_commit_compose.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_commit_vocabulary.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_config.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_credentials.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_diff.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_generation_suggest.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_gitlint_rules.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_helpers.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_heuristic.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_mcp_server.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_sh_uid_unused.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_skill_vocabularies.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_typesafe_client_factory.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_typesafe_provider.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tests/test_violation_code_coverage.py +0 -0
- {conventional_git-2.1.1 → conventional_git-2.2.0}/tools/docs-retag.py +0 -0
|
@@ -78,9 +78,9 @@ repos:
|
|
|
78
78
|
types: [python]
|
|
79
79
|
pass_filenames: false
|
|
80
80
|
|
|
81
|
-
- id:
|
|
82
|
-
name:
|
|
83
|
-
entry: make
|
|
81
|
+
- id: ferrolint
|
|
82
|
+
name: ferrolint (pylint-gajaguar)
|
|
83
|
+
entry: make ferrolint
|
|
84
84
|
language: system
|
|
85
85
|
types: [python]
|
|
86
86
|
pass_filenames: false
|
|
@@ -101,9 +101,11 @@ feature.
|
|
|
101
101
|
- Write no docstrings on functions, methods or classes; add a comment only
|
|
102
102
|
where the *why* is not obvious from the code. `pylint-gajaguar`'s
|
|
103
103
|
`gajaguar-no-docstrings` fails `make check` on any docstring.
|
|
104
|
-
- Enable the plugin
|
|
105
|
-
`[tool.pylint."messages control"]`,
|
|
106
|
-
|
|
104
|
+
- Enable the plugin's rules by symbol in `pyproject.toml`'s
|
|
105
|
+
`[tool.pylint."messages control"]`, after `disable = ["all"]`: ferrolint
|
|
106
|
+
does not read the `gajaguar` checker name, and without `disable` its own
|
|
107
|
+
ported pylint rules run too. Add a rule that a `pylint-gajaguar` upgrade
|
|
108
|
+
ships to the list; ruff covers everything else.
|
|
107
109
|
- Keep `pyproject.toml` to settings that differ from the tool's default, and
|
|
108
110
|
keep a `lint.per-file-ignores` entry only while it matches a current
|
|
109
111
|
violation; see
|
|
@@ -13,10 +13,8 @@ FILES ?=
|
|
|
13
13
|
# docs/conventions/commits-check.md.
|
|
14
14
|
BASE ?= origin/main
|
|
15
15
|
CONVENTIONAL_GIT ?= uvx conventional-git@latest
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
OKFLINT ?= uvx okflint@0.4.1
|
|
19
|
-
TYPESAFE ?= uvx --from typesafe-unofficial-cli@1.1.0 typesafe
|
|
16
|
+
OKFLINT ?= uvx okflint@latest
|
|
17
|
+
TYPESAFE ?= uvx --from typesafe-unofficial-cli@latest typesafe
|
|
20
18
|
DOCS_RETAG := uv run --script tools/docs-retag.py
|
|
21
19
|
BRANCH ?= $(or $(GITHUB_HEAD_REF),$(shell git branch --show-current))
|
|
22
20
|
|
|
@@ -73,7 +71,7 @@ spell: ## Spell-check files with cspell — accepts FILES="..."
|
|
|
73
71
|
|
|
74
72
|
commits-check: ## Validate the commit range and branch name against Conventional Commits/Branch — see docs/conventions/commits-check.md
|
|
75
73
|
@git log --no-merges --format='%B%x00' $(BASE)..HEAD | while IFS= read -r -d '' message; do \
|
|
76
|
-
message="$${message#$$'\n'}";
|
|
74
|
+
message="$${message#$$'\n'}"; \
|
|
77
75
|
echo "$$message" | $(CONVENTIONAL_GIT) check commit || exit 1; \
|
|
78
76
|
done
|
|
79
77
|
@$(CONVENTIONAL_GIT) check branch --name "$(BRANCH)"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: conventional-git
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.2.0
|
|
4
4
|
Summary: Conventional Commits and Conventional Branch enforcement, validation, and generation
|
|
5
5
|
Project-URL: Repository, https://github.com/gajaguar/conventional-git
|
|
6
6
|
Project-URL: Issues, https://github.com/gajaguar/conventional-git/issues
|
|
@@ -129,6 +129,11 @@ conventional-git check branch -n feat/add-login
|
|
|
129
129
|
conventional-git check branch
|
|
130
130
|
```
|
|
131
131
|
|
|
132
|
+
`conventional-git check command` applies the same attribution rule to pull
|
|
133
|
+
request descriptions (`gh pr create|edit`, `bitbucket pr create|update`): it
|
|
134
|
+
reads the command from stdin and exits `2` on a violation. The plugin's hook
|
|
135
|
+
runs it before those commands.
|
|
136
|
+
|
|
132
137
|
The branch command uses the same exit codes. Trunk branches listed in
|
|
133
138
|
`data/branch-trunks.csv` (`main`, `master`, `develop`) are always valid and
|
|
134
139
|
skip the `<type>/` requirement. So are branches that start with a prefix in
|
|
@@ -269,6 +274,7 @@ return `1`.
|
|
|
269
274
|
| :------------- | ---------------------------------------------------------------------------------------- | ------------: |
|
|
270
275
|
| check commit | `-m, --message`; `-f, --file`; `--types-csv` | 0 or 1 |
|
|
271
276
|
| check branch | `-n, --name`; `--types-csv` | 0 or 1 |
|
|
277
|
+
| check command | No options; reads a shell command or hook JSON from stdin | 0 or 2 |
|
|
272
278
|
| create commit | `--type`; `--description`; `--scope`; `--body`; `--breaking`; `--types-csv` | 0 or 1 |
|
|
273
279
|
| create branch | `--type`; `--description`; `--types-csv` | 0 or 1 |
|
|
274
280
|
| create suggest | `--diff-file`; `--provider`; `--apply` | 0 or 1 |
|
|
@@ -108,6 +108,11 @@ conventional-git check branch -n feat/add-login
|
|
|
108
108
|
conventional-git check branch
|
|
109
109
|
```
|
|
110
110
|
|
|
111
|
+
`conventional-git check command` applies the same attribution rule to pull
|
|
112
|
+
request descriptions (`gh pr create|edit`, `bitbucket pr create|update`): it
|
|
113
|
+
reads the command from stdin and exits `2` on a violation. The plugin's hook
|
|
114
|
+
runs it before those commands.
|
|
115
|
+
|
|
111
116
|
The branch command uses the same exit codes. Trunk branches listed in
|
|
112
117
|
`data/branch-trunks.csv` (`main`, `master`, `develop`) are always valid and
|
|
113
118
|
skip the `<type>/` requirement. So are branches that start with a prefix in
|
|
@@ -248,6 +253,7 @@ return `1`.
|
|
|
248
253
|
| :------------- | ---------------------------------------------------------------------------------------- | ------------: |
|
|
249
254
|
| check commit | `-m, --message`; `-f, --file`; `--types-csv` | 0 or 1 |
|
|
250
255
|
| check branch | `-n, --name`; `--types-csv` | 0 or 1 |
|
|
256
|
+
| check command | No options; reads a shell command or hook JSON from stdin | 0 or 2 |
|
|
251
257
|
| create commit | `--type`; `--description`; `--scope`; `--body`; `--breaking`; `--types-csv` | 0 or 1 |
|
|
252
258
|
| create branch | `--type`; `--description`; `--types-csv` | 0 or 1 |
|
|
253
259
|
| create suggest | `--diff-file`; `--provider`; `--apply` | 0 or 1 |
|
|
@@ -4,7 +4,7 @@ title: Agent Skills format
|
|
|
4
4
|
description: SKILL.md frontmatter fields and their constraints, progressive disclosure, and the optional references/ subdirectory.
|
|
5
5
|
tags: [agents, skills, documentation]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: agentskills-spec
|
|
10
10
|
resource: https://agentskills.io/specification
|
|
@@ -4,7 +4,7 @@ title: Claude Code install scopes
|
|
|
4
4
|
description: user, project, and local scopes — which settings file each writes to, the precedence order, and when each is the right choice.
|
|
5
5
|
tags: [agents, claude-code]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-discover-plugins
|
|
10
10
|
resource: https://code.claude.com/docs/en/discover-plugins
|
{conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-marketplace-install.md
RENAMED
|
@@ -4,7 +4,7 @@ title: Installing through the Claude Code marketplace
|
|
|
4
4
|
description: Add a marketplace and install a plugin from it inside a Claude Code session, including the one-step form and the reload.
|
|
5
5
|
tags: [agents, claude-code]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-discover-plugins
|
|
10
10
|
resource: https://code.claude.com/docs/en/discover-plugins
|
|
@@ -4,7 +4,7 @@ title: Updating and uninstalling Claude Code plugins
|
|
|
4
4
|
description: Auto-update is off by default for third-party marketplaces, so update by hand and reload; uninstall the plugin and remove the marketplace when you are done.
|
|
5
5
|
tags: [agents, claude-code]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-discover-plugins
|
|
10
10
|
resource: https://code.claude.com/docs/en/discover-plugins
|
|
@@ -4,7 +4,7 @@ title: Installing from a script or CI
|
|
|
4
4
|
description: The claude plugin CLI installs and manages plugins from your shell, with user scope by default and a --yes flag for command-source prompts.
|
|
5
5
|
tags: [agents, claude-code, ci]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-discover-plugins
|
|
10
10
|
resource: https://code.claude.com/docs/en/discover-plugins
|
{conventional_git-2.1.1 → conventional_git-2.2.0}/docs/agents/claude-code-skill-invocation.md
RENAMED
|
@@ -4,7 +4,7 @@ title: Invoking a Claude Code skill
|
|
|
4
4
|
description: The /<plugin>:<skill> slash form, automatic triggering by description, and three ways to verify a plugin skill is installed.
|
|
5
5
|
tags: [agents, claude-code, skills]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-skills
|
|
10
10
|
resource: https://code.claude.com/docs/en/skills
|
|
@@ -4,7 +4,7 @@ title: Install channels
|
|
|
4
4
|
description: Three ways to install agent skills today (the Claude Code marketplace, the npx skills CLI, and opencode's native skill tool) and what each delivers.
|
|
5
5
|
tags: [agents, install, toolchain]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: claude-discover-plugins
|
|
10
10
|
resource: https://code.claude.com/docs/en/discover-plugins
|
|
@@ -4,7 +4,7 @@ title: Installing skills with `npx skills`
|
|
|
4
4
|
description: npx skills add installs a repository's skills into one or more agent paths, symlinked by default, with flags for agent, scope, skill selection, and list-only.
|
|
5
5
|
tags: [agents, npx-skills]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: vercel-skills
|
|
10
10
|
resource: https://github.com/vercel-labs/skills
|
|
@@ -4,7 +4,7 @@ title: Managing installed skills
|
|
|
4
4
|
description: npx skills list, update, and remove, plus find, use, and init, as shown by the CLI help.
|
|
5
5
|
tags: [agents, npx-skills]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: vercel-skills
|
|
10
10
|
resource: https://github.com/vercel-labs/skills
|
|
@@ -4,7 +4,7 @@ title: opencode MCP configuration
|
|
|
4
4
|
description: The mcp key for local and remote servers, the config file precedence list, and the opencode mcp commands.
|
|
5
5
|
tags: [agents, opencode, mcp]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: opencode-mcp
|
|
10
10
|
resource: https://opencode.ai/docs/mcp-servers/
|
|
@@ -4,7 +4,7 @@ title: opencode skill discovery
|
|
|
4
4
|
description: The project and global paths opencode reads skills from, the walk-up to the git worktree, and the name and description rules.
|
|
5
5
|
tags: [agents, opencode]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: opencode-skills
|
|
10
10
|
resource: https://opencode.ai/docs/skills/
|
|
@@ -4,7 +4,7 @@ title: opencode skill permissions
|
|
|
4
4
|
description: permission.skill maps name patterns to allow, deny, or ask, and tools.skill false disables skills per agent.
|
|
5
5
|
tags: [agents, opencode]
|
|
6
6
|
status: stable
|
|
7
|
-
stale_after: 2027-03-
|
|
7
|
+
stale_after: 2027-03-29T00:00:00Z
|
|
8
8
|
sources:
|
|
9
9
|
- id: opencode-skills
|
|
10
10
|
resource: https://opencode.ai/docs/skills/
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: rule
|
|
3
|
+
title: Attribution trailers are rejected
|
|
4
|
+
description: The core rejects Co-Authored-By, Generated with, and robot-emoji trailers as commit.attribution errors, extensible via config.
|
|
5
|
+
tags: [enforcement, commits]
|
|
6
|
+
status: stable
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Attribution trailers are rejected
|
|
10
|
+
|
|
11
|
+
The core rejects `Co-Authored-By:` trailers (human or AI), `Generated
|
|
12
|
+
with …` lines, and 🤖 markers as `commit.attribution` errors.
|
|
13
|
+
`[commit] attribution_patterns` in `.conventional-git.toml` extends the
|
|
14
|
+
defaults with case-insensitive regular expressions matched against each body
|
|
15
|
+
line. Every front-end that calls `validate_message` enforces this by
|
|
16
|
+
default. A repository that allows or requires such trailers sets
|
|
17
|
+
`[commit] disable_default_attribution_patterns = true` to skip the built-in
|
|
18
|
+
list; `attribution_patterns` still applies.
|
|
19
|
+
|
|
20
|
+
The same rules apply to pull request descriptions, which no Git hook sees.
|
|
21
|
+
`conventional-git check command` reads a shell command (or a hook JSON payload
|
|
22
|
+
with `tool_input.command`) from standard input. For `gh pr create|edit` and
|
|
23
|
+
`bitbucket pr create|update` it validates the `--title`, the `--body`, the
|
|
24
|
+
`--body-file` content, and any heredoc body, line by line including the first.
|
|
25
|
+
It exits `2` with `pr:line[N]` errors when a line matches, `0` otherwise and
|
|
26
|
+
for any other command; anything it cannot parse passes. Exit `2` is what a
|
|
27
|
+
tool-call hook needs to block the call. The plugin's `hooks/hooks.json`
|
|
28
|
+
registers it as a `PreToolUse` hook on `Bash`, filtered per command family so
|
|
29
|
+
it does not start on every call. A line that is specific to one tool, such as a
|
|
30
|
+
session URL, is matched per repository by adding a regular expression to
|
|
31
|
+
`[commit] attribution_patterns`.
|
|
@@ -1,5 +1,26 @@
|
|
|
1
1
|
# Directory Update Log
|
|
2
2
|
|
|
3
|
+
## 2026-11-22
|
|
4
|
+
|
|
5
|
+
* **Change**: `enforcement/attribution-trailers.md` documents
|
|
6
|
+
`conventional-git check command` and the plugin hook that reject attribution
|
|
7
|
+
lines in pull request descriptions.
|
|
8
|
+
|
|
9
|
+
## 2026-11-04
|
|
10
|
+
|
|
11
|
+
* **Change**: `pylint` is replaced by `ferrolint` and `pylint-gajaguar` moves
|
|
12
|
+
to 3.0, a ferrolint plugin that no longer loads in pylint, as in
|
|
13
|
+
project-template. `make pylint` becomes `make ferrolint`, and `enable` lists
|
|
14
|
+
the `gajaguar-*` symbols because ferrolint does not read the `gajaguar`
|
|
15
|
+
checker name.
|
|
16
|
+
|
|
17
|
+
## 2026-10-28
|
|
18
|
+
|
|
19
|
+
* **Change**: the `Makefile` runs `okflint` and `typesafe` at `@latest`, as it
|
|
20
|
+
already ran `conventional-git`, and `toolchain/layering-rule.md` matches.
|
|
21
|
+
* **Fix**: the `agents/` notes write `stale_after` as an ISO 8601 date-time with
|
|
22
|
+
offset, because okflint 0.5 rejects a bare date.
|
|
23
|
+
|
|
3
24
|
## 2026-10-05
|
|
4
25
|
|
|
5
26
|
* **Change**: `enforcement/attribution-trailers.md` documents
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: decision
|
|
3
|
+
title: Toolchain layering rule
|
|
4
|
+
description: mise installs what bootstraps an ecosystem or belongs to none; the ecosystem's own package manager installs everything else.
|
|
5
|
+
tags: [toolchain]
|
|
6
|
+
status: stable
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Toolchain layering rule
|
|
10
|
+
|
|
11
|
+
> **mise installs what bootstraps an ecosystem or belongs to none. The
|
|
12
|
+
> ecosystem's package manager installs everything else.**
|
|
13
|
+
|
|
14
|
+
A tool declared in two layers can drift between them — `make check` and the
|
|
15
|
+
git hook could then reach different verdicts on the same file, the exact
|
|
16
|
+
class of drift this rule exists to prevent.
|
|
17
|
+
|
|
18
|
+
| Tool | Where | Why |
|
|
19
|
+
| :------------------------------------- | :----------------------------------------- | :------------------------------------------------- |
|
|
20
|
+
| node, pnpm, python, uv | `mise.toml` | bootstrap: nothing else can install them |
|
|
21
|
+
| checkmake | `mise.toml` | Go binary, no ecosystem in this repo |
|
|
22
|
+
| pre-commit | `mise.toml` | meta-tool; must run before any ecosystem is set up |
|
|
23
|
+
| cspell, markdownlint-cli2 | `package.json` | Node dev deps, lockfile-managed |
|
|
24
|
+
| ruff, mypy, pyright, pytest, ferrolint | `pyproject.toml` `[dependency-groups].dev` | Python dev deps, `uv.lock`-managed |
|
|
25
|
+
| okflint, typesafe | `uvx` in the `Makefile` | Python tools, run on demand, at `@latest` |
|
|
26
|
+
|
|
27
|
+
See [`rejected-install-backends.md`](rejected-install-backends.md) for the
|
|
28
|
+
alternatives this decision ruled out.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"PreToolUse": [
|
|
4
|
+
{
|
|
5
|
+
"matcher": "Bash",
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "uvx --from conventional-git@latest conventional-git check command",
|
|
10
|
+
"if": "Bash(gh pr create*)"
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"type": "command",
|
|
14
|
+
"command": "uvx --from conventional-git@latest conventional-git check command",
|
|
15
|
+
"if": "Bash(gh pr edit*)"
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"type": "command",
|
|
19
|
+
"command": "uvx --from conventional-git@latest conventional-git check command",
|
|
20
|
+
"if": "Bash(bitbucket pr create*)"
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"type": "command",
|
|
24
|
+
"command": "uvx --from conventional-git@latest conventional-git check command",
|
|
25
|
+
"if": "Bash(bitbucket pr update*)"
|
|
26
|
+
}
|
|
27
|
+
]
|
|
28
|
+
}
|
|
29
|
+
]
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
UV := uv
|
|
2
2
|
# Not conventional-git: this project is it, and uv refuses to upgrade a
|
|
3
3
|
# package the project itself provides.
|
|
4
|
-
PYPI_DEPS := pylint-gajaguar
|
|
4
|
+
PYPI_DEPS := ferrolint pylint-gajaguar
|
|
5
5
|
|
|
6
6
|
# Use the project's own pinned, dev-dependency copy in make commits-check
|
|
7
7
|
# (defined in the base Makefile) instead of an ephemeral uvx fetch.
|
|
8
8
|
CONVENTIONAL_GIT := $(UV) run conventional-git
|
|
9
9
|
|
|
10
10
|
LANG_INSTALL_TARGETS += install-python
|
|
11
|
-
LANG_CHECK_TARGETS += lint format-check typecheck
|
|
11
|
+
LANG_CHECK_TARGETS += lint format-check typecheck ferrolint conventional-git-latest
|
|
12
12
|
LANG_FIX_TARGETS += format lint-fix
|
|
13
13
|
LANG_FIX_UNSAFE_TARGETS += format lint-fix-unsafe
|
|
14
14
|
LANG_TEST_TARGETS += pytest
|
|
@@ -33,8 +33,8 @@ pyright: ## Type-check with Pyright — accepts FILES="..." to limit scope
|
|
|
33
33
|
|
|
34
34
|
typecheck: mypy pyright ## Run both type checkers
|
|
35
35
|
|
|
36
|
-
|
|
37
|
-
$(UV) run
|
|
36
|
+
ferrolint: ## Self-lint with this repo's own rules (see github.com/gajaguar/pylint-gajaguar) — accepts FILES="..."
|
|
37
|
+
$(UV) run ferrolint $(or $(FILES),src tests)
|
|
38
38
|
|
|
39
39
|
conventional-git-latest: ## Fail if the installed conventional-git is behind PyPI (skips when PyPI is unreachable)
|
|
40
40
|
@out=$$($(UV) pip list --outdated --format json 2>/dev/null) || { echo 'conventional-git-latest: PyPI unreachable, skipped'; exit 0; }; \
|
|
@@ -67,5 +67,5 @@ release-tag: ## Tag the base branch as v<project.version> and push the tag (mino
|
|
|
67
67
|
git rev-parse --quiet --verify "refs/tags/$$tag" >/dev/null && { echo "release-tag: $$tag already exists"; exit 1; }; \
|
|
68
68
|
git tag -a "$$tag" -m "$$tag" && git push origin "$$tag"
|
|
69
69
|
|
|
70
|
-
.PHONY: install-python lint format-check mypy pyright typecheck
|
|
70
|
+
.PHONY: install-python lint format-check mypy pyright typecheck ferrolint conventional-git-latest \
|
|
71
71
|
format lint-fix lint-fix-unsafe pytest coverage build release-tag
|