ci: automate releases with release-please and enforce conventional commits

- Add release-please workflow to create release PRs on push to main
- Add auto-merge workflow to merge release PRs after CI passes
- Add workflow to build and upload sc-custom-cards.js to releases
- Remove old semantic-release workflow and dependencies
- Add Lefthook with commitlint for conventional commit validation
- Add pre-commit hook for linting staged files
- Configure release-please for Node.js with CHANGELOG generation

This ensures releases are fully automated, assets are never missing,
and all commits follow conventional commit format for proper
semantic versioning.

Author: sergiocarracedo

.github/workflows/auto-merge-release.yml

@@ -0,0 +1,26 @@
+name: Auto-merge Release PRs
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge-release-pr:
+    runs-on: ubuntu-latest
+    # Only run on release-please PRs
+    if: |
+      github.event.pull_request.user.login == 'github-actions[bot]' &&
+      startsWith(github.event.pull_request.head.ref, 'release-please--')
+    steps:
+      - name: Enable auto-merge for release PR
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release-please.yml

@@ -0,0 +1,24 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+      upload_url: ${{ steps.release.outputs.upload_url }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          # This uses the default token which has permissions for creating releases
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Upload Release Assets
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build the project
+        run: pnpm run build
+
+      - name: Upload release asset
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ github.event.release.upload_url }}
+          asset_path: ./dist/sc-custom-cards.js
+          asset_name: sc-custom-cards.js
+          asset_content_type: application/javascript

.github/workflows/upload-release-assets.yml

@@ -0,0 +1,3 @@
+{
+  ".": "1.5.0"
+}

.release-please-manifest.json

@@ -0,0 +1,27 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat', // New feature
+        'fix', // Bug fix
+        'docs', // Documentation changes
+        'style', // Code style changes (formatting, etc)
+        'refactor', // Code refactoring
+        'perf', // Performance improvements
+        'test', // Adding or updating tests
+        'build', // Build system or dependencies
+        'ci', // CI configuration
+        'chore', // Other changes (maintenance)
+        'revert', // Revert a previous commit
+      ],
+    ],
+    'type-case': [2, 'always', 'lower-case'],
+    'type-empty': [2, 'never'],
+    'subject-empty': [2, 'never'],
+    'subject-full-stop': [2, 'never', '.'],
+    'header-max-length': [2, 'always', 100],
+  },
+}

commitlint.config.js

@@ -0,0 +1,14 @@
+# Lefthook configuration
+# https://lefthook.dev/configuration/
+
+commit-msg:
+  commands:
+    commitlint:
+      run: npx commitlint --edit {1}
+
+pre-commit:
+  parallel: true
+  commands:
+    lint:
+      glob: '*.{js,ts}'
+      run: pnpm run lint

lefthook.yml

@@ -18,7 +18,8 @@
     "lint:oxlint": "oxlint . --fix -D correctness --ignore-path .gitignore",
     "lint:eslint": "eslint . --fix",
     "lint": "run-s lint:*",
-    "format": "prettier --write src/"
+    "format": "prettier --write src/",
+    "prepare": "lefthook install"
   },
   "dependencies": {
     "@kipk/load-ha-components": "^1.0.3",
@@ -29,30 +30,26 @@
     "lit": "^2.8.0"
   },
   "devDependencies": {
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "^7.1.0",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/npm": "^12.0.1",
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
     "@tsconfig/node22": "^22.0.0",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^22.13.9",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/eslint-plugin": "^1.1.36",
     "canvas": "^3.2.1",
-    "conventional-changelog-conventionalcommits": "^8.0.0",
     "dotenv": "^16.5.0",
     "eslint": "^9.21.0",
     "eslint-config-love": "^119.0.0",
     "eslint-plugin-oxlint": "^0.15.13",
     "globals": "^16.0.0",
     "jiti": "^2.4.2",
     "jsdom": "^26.0.0",
+    "lefthook": "^2.1.2",
     "npm-run-all2": "^7.0.2",
     "oxlint": "^0.15.13",
     "prettier": "3.5.3",
     "sass-embedded": "^1.85.1",
-    "semantic-release": "^24.2.3",
     "ts-lit-plugin": "^2.0.2",
     "typescript": "~5.8.0",
     "vite": "^6.2.1",