@checkmarkdevtools/commitlint-plugin-rai 0.1.1 → 0.1.3

package/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).

package/README.md

@@ -1,18 +1,33 @@
 # @checkmarkdevtools/commitlint-plugin-rai
 
-Commitlint plugin for enforcing AI attribution in commit messages using standard Git trailers.
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/ChecKMarKDevTools/admin-things/main/assets/logos/checkmark-rai-lint-logo.png"
+    alt="ChecKMarK RAI"
+    width="160"
+  />
+</p>
 
-## Installation
+<p align="center">
+  A commitlint plugin that enforces exactly one thing:<br />
+  if AI touched the code, say so in the commit. ⚖️
+</p>
+
+<p align="center">
+  That’s it. No philosophy, no negotiations. Pick a trailer and move on.
+</p>
+
+## Installation 🔧
 
 ```bash
 npm install --save-dev @checkmarkdevtools/commitlint-plugin-rai
 ```
 
-## Usage
+## Usage 🚦
 
-Add to your `commitlint.config.js`:
+Add the plugin to your `commitlint.config.js`:
 
-```javascript
+```js
 export default {
   extends: ['@commitlint/config-conventional'],
   plugins: ['@checkmarkdevtools/commitlint-plugin-rai'],
@@ -22,21 +37,40 @@ export default {
 };
 ```
 
-## Valid Footer Formats
+Once this is in place, commitlint will refuse to proceed until a valid RAI trailer is present.
+
+## Valid Trailers 📌
+
+Pick **exactly one**.
+Skip it and the commit fails.
+Use more than one and the commit also fails.
+
+No negotiations.
+
+1. `Authored-by: [Human] <email>` — all you, no AI involved
+2. `Commit-generated-by: [AI Tool] <email>` — AI wrote the commit message, you wrote the code
+3. `Assisted-by: [AI Tool] <email>` — AI helped some, you were still driving
+4. `Co-authored-by: [AI Tool] <email>` — roughly 50/50, like actual pair programming
+5. `Generated-by: [AI Tool] <email>` — AI did most of it, you supervised
+
+All patterns are case-insensitive, because enforcing honesty does not require enforcing capitalization.
+
+## Why This Exists ⚖️
+
+If two humans pair program, both names go on the commit.
+If an AI helps and we pretend it didn’t happen, that’s a choice, but it’s a strange one.
+
+Git already supports trailers. This plugin just closes the gap between “we could do this” and “we actually do this,” by making attribution a default instead of a discussion.
 
-1. **`Authored-by: [Human] <email>`** - Human only, no AI
-2. **`Commit-generated-by: [AI Tool] <email>`** - Trivial AI (docs, commit msg, advice, reviews)
-3. **`Assisted-by: [AI Tool] <email>`** - AI helped, but primarily human code
-4. **`Co-authored-by: [AI Tool] <email>`** - Roughly 50/50 AI and human (40-60 leeway)
-5. **`Generated-by: [AI Tool] <email>`** - Majority of code was AI generated
+If you want the longer version of that reasoning, it’s written up at [Did AI Erase Attribution?](https://dev.to/anchildress1/did-ai-erase-attribution-your-git-history-is-missing-a-co-author-1m2l).
 
-All patterns are case-insensitive.
+This plugin is the boring enforcement layer that follows.
 
-## Requirements
+## Requirements ⚙️
 
 - Node.js >= 20.0.0
 - @commitlint/cli >= 19.0.0
 
-## License
+## License 📄
 
 PolyForm Shield License 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkmarkdevtools/commitlint-plugin-rai",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Commitlint plugin for RAI footer validation",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,8 +14,10 @@
   },
   "files": [
     "dist",
-    "bom.json",
-    "README.md"
+    "sbom.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=20 <25"

package/{bom.json → sbom.json}

@@ -113,15 +113,15 @@
       "type": "library",
       "name": "commitlint-plugin-rai",
       "group": "@checkmarkdevtools",
-      "version": "0.1.1",
-      "bom-ref": "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.1",
+      "version": "0.1.3",
+      "bom-ref": "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.3",
       "licenses": [
         {
           "expression": "LicenseRef-PolyForm-Shield-1.0.0",
           "acknowledgement": "declared"
         }
       ],
-      "purl": "pkg:npm/%40checkmarkdevtools/commitlint-plugin-rai@0.1.1",
+      "purl": "pkg:npm/%40checkmarkdevtools/commitlint-plugin-rai@0.1.3",
       "properties": [
         {
           "name": "cdx:npm:package:path",
@@ -134,11 +134,11 @@
     {
       "ref": "rai-lint",
       "dependsOn": [
-        "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.1"
+        "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.3"
       ]
     },
     {
-      "ref": "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.1"
+      "ref": "rai-lint|@checkmarkdevtools/commitlint-plugin-rai@0.1.3"
     }
   ]
 }