@checkmarkdevtools/commitlint-plugin-rai 0.0.0

package/README.md

@@ -0,0 +1,42 @@
+# @checkmarkdevtools/commitlint-plugin-rai
+
+Commitlint plugin for enforcing AI attribution in commit messages using standard Git trailers.
+
+## Installation
+
+```bash
+npm install --save-dev @checkmarkdevtools/commitlint-plugin-rai
+```
+
+## Usage
+
+Add to your `commitlint.config.js`:
+
+```javascript
+export default {
+  extends: ['@commitlint/config-conventional'],
+  plugins: ['@checkmarkdevtools/commitlint-plugin-rai'],
+  rules: {
+    'rai-footer-exists': [2, 'always'],
+  },
+};
+```
+
+## Valid Footer Formats
+
+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
+
+All patterns are case-insensitive.
+
+## Requirements
+
+- Node.js >= 20.0.0
+- @commitlint/cli >= 19.0.0
+
+## License
+
+Polyform Shield 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@commitlint/types';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,QAAA,MAAM,MAAM,EAAE,MAIb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import raiFooterExists from './rules/rai-footer-exists.js';
+const plugin = {
+    rules: {
+        'rai-footer-exists': raiFooterExists,
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAE3D,MAAM,MAAM,GAAW;IACrB,KAAK,EAAE;QACL,mBAAmB,EAAE,eAAe;KACrC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/rules/rai-footer-exists.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from '@commitlint/types';
+declare const raiFooterExists: Rule;
+export default raiFooterExists;
+//# sourceMappingURL=rai-footer-exists.d.ts.map

package/dist/rules/rai-footer-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rai-footer-exists.d.ts","sourceRoot":"","sources":["../../src/rules/rai-footer-exists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAU9C,QAAA,MAAM,eAAe,EAAE,IA6BtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/rules/rai-footer-exists.js

@@ -0,0 +1,35 @@
+const AI_ATTRIBUTION_PATTERNS = [
+    /^Authored-by:\s+[^<]+\s+<[^>]+>$/im,
+    /^Commit-generated-by:\s+[^<]+\s+<[^>]+>$/im,
+    /^Assisted-by:\s+[^<]+\s+<[^>]+>$/im,
+    /^Co-authored-by:\s+[^<]+\s+<[^>]+>$/im,
+    /^Generated-by:\s+[^<]+\s+<[^>]+>$/im,
+];
+const raiFooterExists = (parsed) => {
+    const { raw } = parsed;
+    if (!raw) {
+        return [false, 'Commit message is empty'];
+    }
+    const hasValidFooter = AI_ATTRIBUTION_PATTERNS.some((pattern) => pattern.test(raw));
+    if (!hasValidFooter) {
+        return [
+            false,
+            '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>"',
+        ];
+    }
+    return [true, ''];
+};
+export default raiFooterExists;
+//# sourceMappingURL=rai-footer-exists.js.map

package/dist/rules/rai-footer-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rai-footer-exists.js","sourceRoot":"","sources":["../../src/rules/rai-footer-exists.ts"],"names":[],"mappings":"AAEA,MAAM,uBAAuB,GAAG;IAC9B,oCAAoC;IACpC,4CAA4C;IAC5C,oCAAoC;IACpC,uCAAuC;IACvC,qCAAqC;CACtC,CAAC;AAEF,MAAM,eAAe,GAAS,CAAC,MAAM,EAAE,EAAE;IACvC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAEvB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;YACL,KAAK;YACL,sDAAsD;gBACpD,6DAA6D;gBAC7D,2FAA2F;gBAC3F,iFAAiF;gBACjF,0FAA0F;gBAC1F,gFAAgF;gBAChF,IAAI;gBACJ,aAAa;gBACb,kDAAkD;gBAClD,2DAA2D;gBAC3D,0DAA0D;gBAC1D,yDAAyD;gBACzD,yDAAyD;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@checkmarkdevtools/commitlint-plugin-rai",
+  "version": "0.0.0",
+  "description": "Commitlint plugin for RAI footer validation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20 <25"
+  },
+  "scripts": {
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "lint": "eslint . --fix",
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "commitlint",
+    "plugin",
+    "rai",
+    "ai-attribution"
+  ],
+  "author": "Ashley Childress",
+  "license": "Polyform-Shield-1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChecKMarKDevTools/rai-lint.git",
+    "directory": "packages/node-commitlint"
+  },
+  "bugs": {
+    "url": "https://github.com/ChecKMarKDevTools/rai-lint/issues"
+  },
+  "homepage": "https://github.com/ChecKMarKDevTools/rai-lint#readme",
+  "peerDependencies": {
+    "@commitlint/types": "^20.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/types": "^20.0.0",
+    "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "^4.0.13",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.7"
+  },
+  "volta": {
+    "node": "24.11.1"
+  }
+}