gitlint-rai 0.0.0__py3-none-any.whl

gitlint_rai/__init__.py

@@ -0,0 +1,3 @@
+from gitlint_rai.rules import RaiFooterExists
+
+__all__ = ["RaiFooterExists"]

gitlint_rai/__main__.py

@@ -0,0 +1,14 @@
+import sys
+
+from gitlint.cli import cli
+
+
+def main():
+    if "--extra-path" not in sys.argv:
+        sys.argv.insert(1, "--extra-path")
+        sys.argv.insert(2, "gitlint_rai")
+    sys.exit(cli())
+
+
+if __name__ == "__main__":
+    main()

gitlint_rai/rules.py

@@ -0,0 +1,80 @@
+import re
+
+from gitlint.rules import CommitRule, RuleViolation
+
+
+class RaiFooterExists(CommitRule):
+    name = "rai-footer-exists"
+    id = "UC1"
+    target = "commit"
+
+    AI_ATTRIBUTION_KEYS = {
+        "Authored-by",
+        "Commit-generated-by",
+        "Assisted-by",
+        "Co-authored-by",
+        "Generated-by",
+    }
+
+    AI_ATTRIBUTION_VALUE_PATTERN = re.compile(r"^[^<]+ <[^>]+>$")
+    TRAILER_PATTERN = re.compile(r"^([A-Za-z][\w-]*)\s*:\s*(.+)$")
+
+    def _parse_trailers(self, message_body):
+        if not message_body:
+            return {}
+
+        lines = message_body if isinstance(message_body, list) else message_body.split("\n")
+        trailers = {}
+        in_trailer_block = False
+        trailer_lines = []
+
+        for i in range(len(lines) - 1, -1, -1):
+            line = lines[i].strip()
+            if not line:
+                if in_trailer_block:
+                    break
+                continue
+
+            match = self.TRAILER_PATTERN.match(line)
+            if match:
+                in_trailer_block = True
+                trailer_lines.insert(0, (match.group(1), match.group(2)))
+            elif in_trailer_block:
+                break
+
+        for key, value in trailer_lines:
+            normalized_key = key.lower()
+            if normalized_key not in trailers:
+                trailers[normalized_key] = []
+            trailers[normalized_key].append(value.strip())
+
+        return trailers
+
+    def validate(self, commit):
+        trailers = self._parse_trailers(commit.message.body)
+
+        for key in self.AI_ATTRIBUTION_KEYS:
+            normalized_key = key.lower()
+            if normalized_key in trailers:
+                for value in trailers[normalized_key]:
+                    if self.AI_ATTRIBUTION_VALUE_PATTERN.match(value):
+                        return []
+
+        return [
+            RuleViolation(
+                self.id,
+                "Commit message must include AI attribution footer:\n"
+                '  1. "Authored-by: [Human] <contact>" - Human only, no AI\n'
+                '  2. "Commit-generated-by: [AI Tool] <contact>" - Trivial AI (docs, commit msg, advice)\n'
+                '  3. "Assisted-by: [AI Tool] <contact>" - AI helped, but primarily human code\n'
+                '  4. "Co-authored-by: [AI Tool] <contact>" - Roughly 50/50 AI and human (40-60 leeway)\n'
+                '  5. "Generated-by: [AI Tool] <contact>" - Majority of code was AI generated\n'
+                "\n"
+                "Examples:\n"
+                '  - "Authored-by: Jane Doe <jane@example.com>"\n'
+                '  - "Commit-generated-by: ChatGPT <chatgpt@openai.com>"\n'
+                '  - "Assisted-by: GitHub Copilot <copilot@github.com>"\n'
+                '  - "Co-authored-by: Verdent AI <verdent@verdent.ai>"\n'
+                '  - "Generated-by: GitHub Copilot <copilot@github.com>"',
+            )
+        ]

gitlint_rai-0.0.0.dist-info/METADATA

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: gitlint-rai
+Version: 0.0.0
+Summary: Gitlint plugin for RAI footer validation
+Author-email: Ashley Childress <human@checkmarkdevtools.dev>
+License-Expression: LicenseRef-PolyForm-Shield-1.0.0
+Project-URL: Homepage, https://github.com/ChecKMarKDevTools/rai-lint
+Project-URL: Repository, https://github.com/ChecKMarKDevTools/rai-lint
+Project-URL: Issues, https://github.com/ChecKMarKDevTools/rai-lint/issues
+Keywords: gitlint,rai,ai-attribution,commit-validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Typing :: Typed
+Requires-Python: <3.13,>=3.11
+License-File: LICENSE
+Requires-Dist: gitlint>=0.19.1
+Dynamic: license-file

gitlint_rai-0.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+gitlint_rai/__init__.py,sha256=eUxlw8w3Y4Jv0ns3_CTNgFPrfOybEaS1rFcnRbV_t1w,77
+gitlint_rai/__main__.py,sha256=8a6q0AQ1oPCR4d9JSXaEO14p3VS9vL0NrZngl_oYU7Y,238
+gitlint_rai/rules.py,sha256=TArCtcjFH0ERMzTSylBquvBVpe-G2bKlu9F7k-UPDPo,2897
+gitlint_rai-0.0.0.dist-info/licenses/LICENSE,sha256=3c8GK71bQJ4ntGrNHvwSXxL9xOcoKzZQBFUSzAV4k-o,2061
+gitlint_rai-0.0.0.dist-info/METADATA,sha256=Xp_1rSj5owAUhx-7TII8cJO1XmAExb4wEvkyA0Mrejk,1037
+gitlint_rai-0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gitlint_rai-0.0.0.dist-info/entry_points.txt,sha256=16Vx_ChzAUS3pIaVlUl-wO4QNS9d0cmNgBbdHcXsB7M,131
+gitlint_rai-0.0.0.dist-info/top_level.txt,sha256=ZC0BtlUyjIdbfhft755kpqK8fh5ViuXYkbtcyKglq4E,12
+gitlint_rai-0.0.0.dist-info/RECORD,,

gitlint_rai-0.0.0.dist-info/WHEEL

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

gitlint_rai-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+gitlint-rai = gitlint_rai.__main__:main
+
+[gitlint.plugins]
+rai-footer-exists = gitlint_rai.rules:RaiFooterExists

gitlint_rai-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,30 @@
+Polyform Shield License 1.0.0
+
+Copyright (c) 2025 ChecKMarK DevTools / Ashley Childress
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and/or distribute the Software for any purpose—including personal, professional, or commercial use—subject to the following conditions:
+
+1. **No Profit or Monetization.**
+   The Software may not be sold, rebranded, licensed, hosted as a paid SaaS, or used as the basis of any product or service from which you or your organization earns revenue or profit, without explicit written permission from Ashley Childress.
+
+   - **You CAN** use, copy, fork, or adapt this for your own workflows, inside your company, for client projects, demos, education, or anything else—as long as you’re not selling the code, charging for it, or making money from the project itself.
+   - **You CANNOT** resell, offer as a paid service, or monetize this project or its derivatives without prior written approval.
+
+2. **Endorsement.**
+   Neither the name of ChecKMarK DevTools / Ashley Childress nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+3. **Attribution.**
+   Any public fork, copy, or substantial reuse must include this LICENSE and a clear statement in your documentation or README:
+   “Based on original work by ChecKMarK DevTools / Ashley Childress – see \[original repo link\].”
+
+4. **No Warranty.**
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+Full license text: https://polyformproject.org/licenses/shield/1.0.0/
+
+---
+
+This project is licensed under Polyform Shield License 1.0.0.
+For exceptions or monetization/commercialization questions, contact Ashley Childress at [human@checkmarkdevtools.dev](mailto:human@checkmarkdevtools.dev).

gitlint_rai-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gitlint_rai