feat: 1995

2026-08-04 02:09:54 +02:00 · 2026-08-04 02:09:54 +02:00 · fb89263930
commit fb89263930
69 changed files with 3359 additions and 0 deletions
--- a/.agents/resources/commitlint.md
+++ b/.agents/resources/commitlint.md
@ -0,0 +1,214 @@
+@commitlint/config-conventional
+===============================
+
+Lint your conventional commits
+
+Shareable `commitlint` config enforcing [conventional commits](https://conventionalcommits.org/). Use with [@commitlint/cli](https://npm.im/@commitlint/cli) and [@commitlint/prompt-cli](https://npm.im/@commitlint/prompt-cli).
+
+Getting started
+---------------
+
+```
+npm install --save-dev @commitlint/config-conventional @commitlint/cli
+echo "export default {extends: \['@commitlint/config-conventional'\]};" \> commitlint.config.js
+```
+
+Rules
+-----
+
+### Problems
+
+The following rules are considered problems for `@commitlint/config-conventional` and will yield a non-zero exit code when not met.
+
+Consult [Rules reference](https://commitlint.js.org/reference/rules) for a list of available rules.
+
+#### type-enum
+
+-   **condition**: `type` is found in value
+
+-   **rule**: `always`
+
+-   **level**: `error`
+
+-   **value**
+
+    ```
+    [
+      'build',
+      'chore',
+      'ci',
+      'docs',
+      'feat',
+      'fix',
+      'perf',
+      'refactor',
+      'revert',
+      'style',
+      'test'
+    ];
+
+    ```
+
+```
+echo "foo: some message" # fails
+echo "fix: some message" # passes
+```
+
+#### type-case
+
+-   **description**: `type` is in case `value`
+-   **rule**: `always`
+-   **level**: `error`
+-   **value**
+    ```
+    'lowerCase'
+
+    ```
+
+```
+echo "FIX: some message" # fails
+echo "fix: some message" # passes
+```
+
+#### type-empty
+
+-   **condition**: `type` is empty
+-   **rule**: `never`
+-   **level**: `error`
+
+```
+echo ": some message" # fails
+echo "fix: some message" # passes
+```
+
+#### subject-case
+
+-   **condition**: `subject` is in one of the cases `['sentence-case', 'start-case', 'pascal-case', 'upper-case']`
+-   **rule**: `never`
+-   **level**: `error`
+
+```
+echo "fix(SCOPE): Some message" # fails
+echo "fix(SCOPE): Some Message" # fails
+echo "fix(SCOPE): SomeMessage" # fails
+echo "fix(SCOPE): SOMEMESSAGE" # fails
+echo "fix(scope): some message" # passes
+echo "fix(scope): some Message" # passes
+```
+
+#### subject-empty
+
+-   **condition**: `subject` is empty
+-   **rule**: `never`
+-   **level**: `error`
+
+```
+echo "fix:" # fails
+echo "fix: some message" # passes
+```
+
+#### subject-full-stop
+
+-   **condition**: `subject` ends with `value`
+-   **rule**: `never`
+-   **level**: `error`
+-   **value**
+
+```
+'.'
+
+```
+
+```
+echo "fix: some message." # fails
+echo "fix: some message" # passes
+```
+
+#### header-max-length
+
+-   **condition**: `header` has `value` or less characters
+-   **rule**: `always`
+-   **level**: `error`
+-   **value**
+
+```
+100
+
+```
+
+```
+echo "fix: some message that is way too long and breaks the line max-length by several characters" # fails
+echo "fix: some message" # passes
+```
+
+#### footer-leading-blank
+
+-   **condition**: `footer` should have a leading blank line
+-   **rule**: `always`
+-   **level**: `warning`
+
+```
+echo "fix: some message
+BREAKING CHANGE: It will be significant" # warning
+
+echo "fix: some message
+BREAKING CHANGE: It will be significant" # passes
+```
+
+#### footer-max-line-length
+
+-   **condition**: `footer` each line has `value` or less characters
+-   **rule**: `always`
+-   **level**: `error`
+-   **value**
+
+```
+100
+
+```
+
+```
+echo "fix: some message
+BREAKING CHANGE: footer with multiple lines
+has a message that is way too long and will break the line rule 'line-max-length' by several characters" # fails
+
+echo "fix: some message
+BREAKING CHANGE: footer with multiple lines
+but still no line is too long" # passes
+```
+
+#### body-leading-blank
+
+-   **condition**: `body` should have a leading blank line
+-   **rule**: `always`
+-   **level**: `warning`
+
+```
+echo "fix: some message
+body" # warning
+
+echo "fix: some message
+body" # passes
+```
+
+#### body-max-line-length
+
+-   **condition**: `body` each line has `value` or less characters
+-   **rule**: `always`
+-   **level**: `error`
+-   **value**
+
+```
+100
+
+```
+
+```
+echo "fix: some message
+body with multiple lines
+has a message that is way too long and will break the line rule 'line-max-length' by several characters" # fails
+
+echo "fix: some message
+body with multiple lines
+but still no line is too long" # passes
+```