Dev to Main

.bumpversion.toml

@@ -1,12 +1,19 @@
 [tool.bumpversion]
-current_version = "1.4.2"
+current_version = "1.5.2"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
-search  = "{current_version}"
-replace = "{new_version}"
-regex   = false
+commit = true
+tag = true
+tag_name = "v{new_version}"
+commit_args = "--no-verify"
+message = "chore: bump version to {new_version}"
 
 [[tool.bumpversion.files]]
 filename = "custom_components/simple_pid_controller/manifest.json"
 search = '"version": "{current_version}"'
 replace = '"version": "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "setup.cfg"
+search = "current_version = {current_version}"
+replace = "current_version = {new_version}"

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,68 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill in the form as completely as possible.
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Which version are you using?
+      placeholder: "e.g. 1.2.3"
+    validations:
+      required: true
+
+  - type: input
+    id: ha_version
+    attributes:
+      label: Home Assistant version (if applicable)
+      placeholder: "e.g. 2025.2.0"
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug description
+      description: What goes wrong? Be as specific as possible.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this?
+      placeholder: |
+        1. Go to ...
+        2. Click on ...
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What should happen instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Error messages
+      description: Paste relevant logs or error messages (Home Assistant log, browser console, etc.)
+      render: text
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues and this is not a duplicate
+          required: true
+        - label: I am using the latest version
+          required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,45 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your suggestion! Please describe your request as clearly as possible.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the problem or need that motivates this request.
+      placeholder: "As a user I want to ... so that ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How would you implement this?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you considered other solutions?
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add any other context, screenshots, or examples.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues and this is not a duplicate
+          required: true

.github/labeler.yml

@@ -1,12 +1,23 @@
 bug:
-  - "error"
-  - "fail"
-feature:
-  - "feature request"
-  - "enhancement"
+  - '(?i)(bug|error|exception|traceback|crash|not working|broken|failing|AttributeError|ValueError|TypeError|KeyError|ImportError|does not work|stopped working)'
+
+enhancement:
+  - '(?i)(feature|enhancement|feature request|add support|support for|request|wish|suggestion|could you|can you add)'
+
+question:
+  - '(?i)(question|how to|how do|what is|help|explain|why|where|where can|confused|understand)'
+
 documentation:
-  - "docs"
-  - "documentation"
-maintenance:
-  - "dependabot"
+  - '(?i)(docs|documentation|readme|example|wiki|manual|how to configure|guide)'
+
+configuration:
+  - '(?i)(config|setup|install|yaml|options|settings|configure|option|parameter)'
+
+performance:
+  - '(?i)(slow|performance|memory|cpu|hang|freeze|timeout|lagging|delayed)'
+
+"home assistant":
+  - '(?i)(home assistant|hass|HA \d+\.\d+|homeassistant|core \d+\.\d+)'
 
+dependencies:
+  - '(?i)(dependency|requirement|package|pip|version incompatible|requires|needs version)'

.github/labels.yml

@@ -0,0 +1,52 @@
+# GitHub Labels — synced via sync-labels.yml workflow
+- name: bug
+  color: "d73a4a"
+  description: "Something isn't working as expected"
+
+- name: enhancement
+  color: "a2eeef"
+  description: "New feature or improvement"
+
+- name: question
+  color: "d876e3"
+  description: "More information needed"
+
+- name: documentation
+  color: "0075ca"
+  description: "Improvement or addition to documentation"
+
+- name: configuration
+  color: "e4e669"
+  description: "Configuration or setup related"
+
+- name: performance
+  color: "f9d0c4"
+  description: "Performance or resource usage"
+
+- name: dependencies
+  color: "0366d6"
+  description: "Update dependencies"
+
+- name: duplicate
+  color: "cfd3d7"
+  description: "This issue already exists"
+
+- name: wontfix
+  color: "ffffff"
+  description: "Will not be fixed"
+
+- name: "good first issue"
+  color: "7057ff"
+  description: "Good for new contributors"
+
+- name: "help wanted"
+  color: "008672"
+  description: "Extra attention or help wanted"
+
+- name: stale
+  color: "ededed"
+  description: "No recent activity"
+
+- name: "breaking change"
+  color: "e11d48"
+  description: "Contains a breaking change"

.github/pr-labeler.yml

@@ -0,0 +1,23 @@
+bug:
+  - changed-files:
+    - any-glob-to-any-file: []  # no file-based bug detection; use issue labels or manual
+
+enhancement:
+  - changed-files:
+    - any-glob-to-any-file:
+      - custom_components/simple_pid_controller/**
+
+documentation:
+  - changed-files:
+    - any-glob-to-any-file:
+      - "*.md"
+      - docs/**
+      - custom_components/simple_pid_controller/translations/**
+      - custom_components/simple_pid_controller/strings.json
+
+dependencies:
+  - changed-files:
+    - any-glob-to-any-file:
+      - requirements*.txt
+      - custom_components/simple_pid_controller/manifest.json
+      - setup.cfg

.github/pull_request_template.md

@@ -1,33 +1,22 @@
-## 📝 What’s Changed?
+## Description
 
-<!-- Briefly describe the main changes in this PR -->
-- ...
+<!-- Briefly describe what this PR does and why -->
 
-## 🔍 Why is this Change Needed?
+## Type of change
 
-<!-- Explain the reason or motivation behind the change -->
-- ...
+- [ ] `fix:` Bug fix (patch version bump)
+- [ ] `feat:` New feature (minor version bump)
+- [ ] `feat!:` / `BREAKING CHANGE:` Breaking change (major version bump)
+- [ ] `chore:` / `docs:` / `ci:` Maintenance or documentation (no version bump)
 
-## 🧪 How Was This Tested?
+## Checklist
 
-<!-- Describe how you tested the changes -->
-- [ ] Added or updated unit tests
-- [ ] Manually tested in development environment
-- [ ] CI/CD pipeline passed successfully
-
-## ✅ Checklist
-
-- [ ] Code follows the style guide
-- [ ] All tests are passing
+- [ ] Commit title follows [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `chore:`, etc.)
+- [ ] Tests added or updated where applicable
 - [ ] Documentation updated if needed
-- [ ] No breaking changes (or clearly documented)
-
-## 📸 Screenshots / Logs (Optional)
-
-<!-- Add any relevant UI screenshots or logs -->
-_(e.g., Home Assistant UI, terminal output, etc.)_
+- [ ] CI is green
+- [ ] PR targets the `dev` branch (not `main`, unless this is a hotfix)
 
-## 📎 Additional Notes
+## Screenshots / Logs (optional)
 
-<!-- Add anything else reviewers should know -->
-- ...
+<!-- Add relevant screenshots or log output -->

.github/workflows/bump-version.yml

@@ -0,0 +1,51 @@
+name: Bump Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump type"
+        type: choice
+        options: [patch, minor, major]
+        default: patch
+        required: true
+
+permissions:
+  contents: write
+
+jobs:
+  bump:
+    name: Bump ${{ inputs.bump }} version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install bump-my-version
+        run: pip install bump-my-version
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        run: bump-my-version bump ${{ inputs.bump }}
+
+      - name: Push commit and tag
+        run: |
+          git push origin main
+          git push origin --tags
+
+      - name: Show new version
+        run: |
+          NEW_TAG=$(git describe --tags --abbrev=0)
+          echo "Version bumped to $NEW_TAG"
+          echo "### Version bumped to $NEW_TAG" >> $GITHUB_STEP_SUMMARY