root: ci: Add husky,commitlint.config.js& Update docs

fsfsdf

Author: dibyanshu-pal-kushwaha

.github/workflows/lint-commit.yml

@@ -0,0 +1,21 @@
+name: Lint Commit Messages
+
+on: [pull_request]
+
+jobs:
+  lint-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: "npm"
+          cache-dependency-path: package-lock.json
+      - name: Install dependencies
+        run: npm ci
+      - name: Lint commit messages
+        run: npm run lint:commit

Dockerfile

@@ -4,7 +4,7 @@ ARG IMAGE_BASE=alpine:3.22.2@sha256:4b7ce07002c69e8f3d704a9c5d6fd3053be500b7f1c6
 FROM ${IMAGE_BASE} AS image-base
 
 
-FROM --platform=${BUILDPLATFORM} golang:1.24.11@sha256:cf1272dbf972a94f39a81dcb9dc243a8d2f981e5dd3b5a5c965f6d9ab9268b26 AS backend-build
+FROM --platform=${BUILDPLATFORM} golang:1.24.11@sha256:28252a22a79f4995895749d69853d4c8f750167bd94113ae4da4a570ec5ce7b2 AS backend-build
 
 WORKDIR /headlamp
 
@@ -28,7 +28,7 @@ RUN --mount=type=cache,target=/root/.cache/go-build \
     --mount=type=cache,target=/go/pkg/mod \
     cd ./backend && go build -o ./headlamp-server ./cmd/
 
-FROM --platform=${BUILDPLATFORM} node:22@sha256:4ad2c2b350ab49fb637ab40a269ffe207c61818bb7eb3a4ea122001a0c605e1f AS frontend-build
+FROM --platform=${BUILDPLATFORM} node:22@sha256:379c51ac7bbf9bffe16769cfda3eb027d59d9c66ac314383da3fcf71b46d026c AS frontend-build
 
 # We need .git and app/ in order to get the version and git version for the frontend/.env file
 # that's generated when building the frontend.

Dockerfile.plugins

@@ -1,5 +1,5 @@
 # Build the plugin
-FROM node:22@sha256:4ad2c2b350ab49fb637ab40a269ffe207c61818bb7eb3a4ea122001a0c605e1f as builder
+FROM node:22@sha256:379c51ac7bbf9bffe16769cfda3eb027d59d9c66ac314383da3fcf71b46d026c as builder
 
 # Set the working directory
 WORKDIR /headlamp-plugins

commitlint.config.js

@@ -0,0 +1,54 @@
+module.exports = {
+  plugins: [
+    {
+      rules: {
+        'headlamp-format': ({ header }) => {
+          if (!header) {
+            return [false, 'Commit message header must not be empty'];
+          }
+           if (/ :/.test(header)) {
+            return [false, 'There should be no space before ":"'];
+          }
+          const parts = header.split(':').map(p => p.trim());
+          if (parts.length < 2) {
+            return [
+              false,
+              'Commit message must follow format: <area>: <description>',
+            ];
+          }
+          const [area, subOrDesc] = parts;
+          if (!area) {
+            return [false, 'Area must not be empty'];
+          }
+          if (!subOrDesc) {
+            return [false, 'Description or sub-area must not be empty'];
+          }
+          const strictAreas = ['app', 'frontend', 'backend'];
+          if (strictAreas.includes(area.toLowerCase()) && parts.length < 3) {
+            return [
+              false,
+              `Commits starting with "${area}" must follow format: ` +
+              `<${area}>: <sub-area>: <description>\n` +
+              `Example: "${area}: HomeButton: Fix navigation"`,
+            ];
+          }
+          const description =
+            parts.length >= 3 ? parts.slice(2).join(': ') : parts[1];
+          if (!description) {
+            return [false, 'Description must not be empty'];
+          }
+          if (description[0] !== description[0].toUpperCase()) {
+            return [false, 'Description must start with a capitalized verb'];
+          }
+          return [true, ''];
+        },
+      },
+    },
+  ],
+
+  rules: {
+    'headlamp-format': [2, 'always'],
+    'header-max-length': [2, 'always', 72],
+    'body-max-line-length': [2, 'always', 72],
+  },
+};

docs/contributing.md

@@ -185,6 +185,13 @@ dedicated [i18n docs](./development/i18n).
 For general guidelines on making PRs/commits easier to review, please check
 out Kinvolk's
 [contribution guidelines on git](https://github.com/kinvolk/contribution/tree/master/topics/git.md).
+We also use `commitlint` to enforce these guidelines automatically. You can check your commits locally by running:
+
+```bash
+npm run lint:commit
+```
+
+This command checks all commit messages that exist after origin/main against our guidelines. The same check runs in our CI system for every Pull Request.
 
 ## Testing