commit-check 2.19.2__py3-none-any.whl → 2.19.4__py3-none-any.whl

commit_check/__init__.py

@@ -86,6 +86,10 @@ DEFAULT_BRANCH_TYPES = [
     "codex",
     "copilot",
     "cursor",
+    # VS Code's Agents window hard-codes this prefix and users cannot change
+    # it; the spec will accept it as an alias of "ai"
+    # (https://github.com/conventional-branch/conventional-branch/issues/196).
+    "agents",
     # Automation/bot prefixes
     "dependabot",
     "renovate",

commit_check/ai_signatures_data.py

@@ -242,15 +242,35 @@ CURSOR = KnownAiTool(
         # Cursor's agent signs as ``Cursor Agent <cursoragent@cursor.com>``;
         # the address catches it under any display name.
         *_identity(r"[^<\n]*<cursoragent@cursor\.com>", "... <cursoragent@cursor.com>"),
+        # Cursor's own mark on commits it writes:
+        # https://forum.cursor.com/t/allow-disabling-made-with-cursor-commit-trailer/154494
+        _trailer(
+            ("Made-with",), r"Cursor", ROLE_STAMP, "``Made-with: Cursor`` trailer"
+        ),
     ],
 )
 
 # --- Devin ---
+# Devin credits itself as ``Devin AI`` with its GitHub App's address,
+# ``158243242+devin-ai-integration[bot]@users.noreply.github.com``.
+# "Devin" alone is a person's name, so with an address it counts only when
+# the address is the app's.
 DEVIN = KnownAiTool(
     name="Devin",
     name_pattern=_names(r"devin"),
     patterns=[
-        *_identity(r"Devin[ \t]*(?:<[^>\n]*>)?", "Devin"),
+        *_identity(r"Devin AI[ \t]*(?:<[^>\n]*>)?", "Devin AI"),
+        *_identity(
+            r"Devin(?:[ \t]*<(?:\d+\+)?devin-ai-integration\[bot\]"
+            r"@users\.noreply\.github\.com>)?",
+            "Devin",
+        ),
+        # The app's address catches it under any display name.
+        *_identity(
+            r"[^<\n]*<(?:\d+\+)?devin-ai-integration\[bot\]"
+            r"@users\.noreply\.github\.com>",
+            "... <N+devin-ai-integration[bot]@users.noreply.github.com>",
+        ),
     ],
 )
 

commit_check/rule_builder.py

@@ -21,6 +21,7 @@ from commit_check import (
     GIT_MERGE_SUBJECT_PATTERN,
 )
 from commit_check.config import ConfigError
+from commit_check.config_merger import get_default_config
 from commit_check.rules_catalog import (
     BRANCH_RULES,
     COMMIT_RULES,
@@ -194,6 +195,32 @@ def _string_list(
     )
 
 
+#: The settings that take ``true`` or ``false``, as (section, key).
+_BOOLEAN_SETTINGS = tuple(
+    (section, key)
+    for section, defaults in get_default_config().items()
+    for key, default in defaults.items()
+    if isinstance(default, bool)
+)
+
+
+def _check_booleans(config: dict[str, Any]) -> None:
+    """Refuse a boolean setting given anything but ``true`` or ``false``.
+
+    ``"false"`` is a non-empty string, so it used to turn the rule on.
+    """
+    for section, key in _BOOLEAN_SETTINGS:
+        values = config.get(section)
+        if not isinstance(values, dict):
+            continue
+        value = values.get(key)
+        if value is not None and not isinstance(value, bool):
+            setting = f"[{section}] {key}"
+            raise ConfigError(
+                f"{setting} must be true or false, got {value!r}", setting=setting
+            )
+
+
 class RuleBuilder:
     """Builds validation rules from config and catalog entries."""
 
@@ -204,6 +231,7 @@ class RuleBuilder:
         self.push_config = config.get("push", {})
         self.tag_config = config.get("tag", {})
         self.files_config = config.get("files", {})
+        _check_booleans(config)
         self.warn_checks = self._resolve_warn_list(config.get("warn", []))
 
     def build_all_rules(self) -> list[ValidationRule]:

{commit_check-2.19.2.dist-info → commit_check-2.19.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commit-check
-Version: 2.19.2
+Version: 2.19.4
 Summary: Commit policy as code for teams and AI agents: check commit messages, branch names, authors, tags, files and AI attribution.
 Author-email: Xianpeng Shen <xianpeng.shen@gmail.com>
 License-Expression: MIT
@@ -65,6 +65,10 @@ attribution against one `cchk.toml` — in your commit hook, in CI, on every
 pull request and inside your AI agent. When the fix is obvious, it hands you
 the line.
 
+**On GitHub?** [Install the Commit Check App](https://github.com/apps/commit-check)
+and every push and pull request gets a check run, with no workflow file. It is
+free for public repositories and personal accounts.
+
 ![commit-check demo](https://github.com/commit-check/commit-check/raw/main/assets/demo.gif)
 
 ## Quick start
@@ -84,7 +88,7 @@ Stop bad commits before they exist. In `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/commit-check/commit-check
-    rev: v2.19.0
+    rev: v2.19.4
     hooks:
       - id: check-message
       - id: check-branch
@@ -102,8 +106,8 @@ The same `cchk.toml` drives all of them:
 
 | Run it in | How |
 |---|---|
-| GitHub Actions | `uses: commit-check/commit-check-action@v2` — see [commit-check-action](https://github.com/commit-check/commit-check-action) |
 | GitHub, no workflow | [Install the GitHub App](https://github.com/apps/commit-check) — one check run per commit |
+| GitHub Actions | `uses: commit-check/commit-check-action@v2` — see [commit-check-action](https://github.com/commit-check/commit-check-action) |
 | AI agents | `--format json`, the [Python API](#ai-native-usage), or the [MCP server](https://github.com/commit-check/commit-check-mcp) |
 
 ## What it checks
@@ -171,7 +175,7 @@ Priority: CLI > env > TOML > default. Booleans accept `true/false`, `yes/no`,
 | `commit.author_name_pattern` | `""` | `--author-name-pattern` | `CCHK_AUTHOR_NAME_PATTERN` | Regex the author name must match (CC101, with `--author-name`) |
 | `branch.conventional_branch` | `true` | `--conventional-branch` | `CCHK_CONVENTIONAL_BRANCH` | Enforce `<type>/<description>` branch names (CC201) |
 | `branch.require_description_grammar` | `false` | `--require-description-grammar` | `CCHK_REQUIRE_DESCRIPTION_GRAMMAR` | Also hold the description after `<type>/` to the Conventional Branch grammar: lowercase alphanumeric words joined by single hyphens, dots allowed inside a word (CC201). Off by default, since bot branches such as `dependabot/npm_and_yarn/lodash-4.17.21` do not follow it |
-| `branch.allow_branch_types` | `feature, bugfix, hotfix, release, chore, feat, fix, build, ci, docs, perf, refactor, test, style, ai, claude, codex, copilot, cursor, dependabot, renovate` | `--allow-branch-types` | `CCHK_ALLOW_BRANCH_TYPES` | Allowed branch `<type>` prefixes; each entry is a regex matched against the whole type |
+| `branch.allow_branch_types` | `feature, bugfix, hotfix, release, chore, feat, fix, build, ci, docs, perf, refactor, test, style, ai, claude, codex, copilot, cursor, agents, dependabot, renovate` | `--allow-branch-types` | `CCHK_ALLOW_BRANCH_TYPES` | Allowed branch `<type>` prefixes; each entry is a regex matched against the whole type |
 | `branch.allow_branch_names` | `[]` | `--allow-branch-names` | `CCHK_ALLOW_BRANCH_NAMES` | Extra branch names allowed besides `main`, `master`, `develop`, `HEAD`, `PR-.+`; each entry is a regex matched against the whole branch name, so `create-pull-request/.+` allows a family of them |
 | `branch.require_rebase_target` | `""` | `--require-rebase-target` | `CCHK_REQUIRE_REBASE_TARGET` | Branch the current branch must be rebased onto (CC202); empty disables |
 | `branch.ignore_authors` | `[]` | `--branch-ignore-authors` | `CCHK_BRANCH_IGNORE_AUTHORS` | Authors whose branches skip the branch checks |
@@ -231,8 +235,10 @@ shape. Unlike the CLI they do not read `cchk.toml`: pass the policy as a
 page covers each function and how to load a repository's file.
 
 Exit codes: `0` passed · `1` a check failed · `2` nothing was checked — bad
-usage, or a config that is missing, is not valid TOML, names an unknown rule or
-holds a regex that does not compile. `--dry-run` reports everything and exits `0`. More output formats: [examples](https://commit-check.com/example/).
+usage, or a config that is missing, is not valid TOML, names an unknown rule,
+holds a regex that does not compile or gives a `[commit]` or `[branch]` setting
+a value of the wrong type (`subject_max_length = "abc"`). A `[files]` value it
+cannot use turns that rule off with a notice instead. `--dry-run` reports everything and exits `0`. More output formats: [examples](https://commit-check.com/example/).
 
 ## Why Commit Check
 

{commit_check-2.19.2.dist-info → commit_check-2.19.4.dist-info}/RECORD

@@ -1,7 +1,7 @@
-commit_check/__init__.py,sha256=wHIreV-DEKM5AiobnjfvxIuvIQ2DShRxc5SwSx50oX4,5232
+commit_check/__init__.py,sha256=UAg0cSgL4QKAOc9GEbqFdoQ94JejOupRGoGgaDwIcF0,5456
 commit_check/ai_policy.py,sha256=gYC3ROLgGL1TDyhPkFXkV-NiYbvMt80Qt0MFrJcbJY4,8131
 commit_check/ai_signatures.py,sha256=0HTZy4othuwKVqfGZ2J7PaIMUPmQArhEQa0k7zGnCzs,10251
-commit_check/ai_signatures_data.py,sha256=2xWH8M3HoFlUh7n766GK4ahkKJi8_FvcTTOuYv_yWls,14314
+commit_check/ai_signatures_data.py,sha256=dgTJxur3IqYLbmj0PzhG6LWb8mY2QwWUJVaFCLQJYzo,15258
 commit_check/api.py,sha256=07bvBtV8PrhZIOwCDHiHfu_7CXsX_4U2_K2xMAucd6c,12905
 commit_check/config.py,sha256=SB8Zvcll-kFOZgQ-olzYLv9CLJqaYIaCb37bcrjVNOE,14068
 commit_check/config_merger.py,sha256=umsjoTcWG7WXufxn7dIMlHrek0a8VWmqjynJR-A4LYQ,13406
@@ -10,12 +10,12 @@ commit_check/fixes.py,sha256=BpbdoHsKDyw2WfsqymwYpnrW73aHdCDGr8tMF6Ho2RU,7305
 commit_check/imperatives.py,sha256=dEd_ssu4G0j6Cann6jqPdB97lw5Adua43K0_Odg_FyA,9518
 commit_check/main.py,sha256=LR3uyJXXHHLsVS90pshHbB7FfyTiUr-OmecI8wwvgEo,28157
 commit_check/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-commit_check/rule_builder.py,sha256=YDa3re0-gNTKEBBOvnF_K8kP8MpFo9UC_l9eC_punsw,33435
+commit_check/rule_builder.py,sha256=XqTjDrPcepC6jP-ui0RyiMFYSVvKXGuRxwllg_XxvKI,34391
 commit_check/rules_catalog.py,sha256=-C3Jo721vXRrY7-LzJs9iNF3ffXKEFldDfmBoLtujt4,11920
 commit_check/util.py,sha256=Q9nI_0yYu6WEJLD55vMnFozWhZzfP2Z4xrElecmqZBQ,32755
-commit_check-2.19.2.dist-info/licenses/LICENSE,sha256=9mdTva71kQhrpWh_nZulxrdCnUrl5c6xJYh5hdo4p_s,1070
-commit_check-2.19.2.dist-info/METADATA,sha256=ArwljHXzZqWZE2oKS5aSfoosL9b5RrPG49bS-MIsRyg,15971
-commit_check-2.19.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-commit_check-2.19.2.dist-info/entry_points.txt,sha256=YMrkFGeub-3-IanV1d9qnopXVaRQM7MA9foXKW9iZ88,86
-commit_check-2.19.2.dist-info/top_level.txt,sha256=Wf46u-ooHBMJNHbhfrBNQw3wC5_m8wt-o_Lfbc4QpRg,13
-commit_check-2.19.2.dist-info/RECORD,,
+commit_check-2.19.4.dist-info/licenses/LICENSE,sha256=9mdTva71kQhrpWh_nZulxrdCnUrl5c6xJYh5hdo4p_s,1070
+commit_check-2.19.4.dist-info/METADATA,sha256=Nmu5vjvJVhOUeHNlCRmoVzk-HMjHnU-l8VLPLh1x_ns,16369
+commit_check-2.19.4.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+commit_check-2.19.4.dist-info/entry_points.txt,sha256=YMrkFGeub-3-IanV1d9qnopXVaRQM7MA9foXKW9iZ88,86
+commit_check-2.19.4.dist-info/top_level.txt,sha256=Wf46u-ooHBMJNHbhfrBNQw3wC5_m8wt-o_Lfbc4QpRg,13
+commit_check-2.19.4.dist-info/RECORD,,

{commit_check-2.19.2.dist-info → commit_check-2.19.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any