chore: add husky and commitlint for improved commit message linting

Author: Morgy93

.github/CONTRIBUTING.md

@@ -79,16 +79,20 @@ src/
 
 ### Commits
 
-We follow conventional commits:
+We follow [Conventional Commits](https://www.conventionalcommits.org/) to automate our release process. We use `husky` and `commitlint` to enforce this standard locally.
 
-- `feat:` New features
-- `fix:` Bug fixes
-- `docs:` Documentation changes
-- `test:` Test additions/changes
-- `refactor:` Code refactoring
-- `chore:` Maintenance tasks
+**Format**: `type(scope): description`
 
-Example: `feat: add auto-detection of PHPStan config files`
+- `feat`: New features (triggers a minor version bump)
+- `fix`: Bug fixes (triggers a patch version bump)
+- `docs`: Documentation changes
+- `test`: Test additions/changes
+- `refactor`: Code refactoring
+- `chore`: Maintenance tasks
+
+**Examples**:
+- `feat: add auto-detection of PHPStan config files`
+- `fix: resolve crash when parsing error output`
 
 ## Pull Request Process
 

.github/copilot-instructions.md

@@ -56,6 +56,13 @@ This project is a VS Code extension that integrates PHPStan (Static Analysis) ru
     - Use Status Bar items effectively to show tool status (Ready, Error, etc.).
     - Provide "Quick Fixes" or buttons in error messages for common actions (like "Start DDEV").
 
+5.  **Commit Messages**:
+    - STRICTLY follow Conventional Commits format: `type(scope): description`.
+    - Allowed types: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`.
+    - Examples:
+      - `feat: add new setting`
+      - `fix: resolve crash`
+
 ## Common Tasks
 
 - **Adding a new setting**:

.github/workflows/commitlint.yml

@@ -0,0 +1,22 @@
+name: Commit Lint
+
+on: [push, pull_request]
+
+jobs:
+  commitlint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+      - name: Install dependencies
+        run: npm ci
+      - name: Validate current commit (last commit)
+        if: github.event_name == 'push'
+        run: npx commitlint --from HEAD~1 --to HEAD --verbose
+      - name: Validate PR commits
+        if: github.event_name == 'pull_request'
+        run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

commitlint.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+};