Add GitHub issue/PR templates and CI workflow (#4)

Add bug report and feature request issue forms, a PR checklist
template, and a CI workflow that builds+tests with GCC/Clang across
Debug/Release, checks clang-format, and runs clang-tidy against the
library headers (tests/examples excluded from tidy by design).

Reformat EventDescriptorTests.cpp to satisfy the new clang-format
check.

Author: alexcvc

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,52 @@
+name: Bug report
+description: Report unexpected or incorrect behavior in TickGuard
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened, and what did you expect instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      description: Smallest code snippet or steps that trigger the issue. Include EventConfig/EventMode used, if relevant.
+      render: cpp
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: TickGuard commit / tag
+      placeholder: e.g. 7a20843 or v1.2.0
+    validations:
+      required: true
+
+  - type: input
+    id: compiler
+    attributes:
+      label: Compiler and version
+      placeholder: e.g. GCC 14.2.0, Clang 18, MSVC 19.40
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: OS / platform
+      placeholder: e.g. Ubuntu 24.04, Debian 13, embedded target
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs / build output
+      render: shell
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,28 @@
+name: Feature request
+description: Suggest new functionality or a behavior change for TickGuard
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What are you trying to do that TickGuard doesn't support today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: >
+        What would you like to change? Note that new EventMode/timing behavior should fit inside
+        EventDescriptor's existing Debounce/Heartbeat phase machine rather than adding a parallel mechanism.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false

.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Summary
+
+<!-- What does this change do, and why? -->
+
+## Related issue
+
+<!-- Closes #... , if applicable -->
+
+## Changes
+
+- 
+
+## Testing
+
+- [ ] `ctest --test-dir build --output-on-failure` passes locally
+- [ ] Added/updated tests covering this change
+- [ ] Ran `clang-format` / `clang-tidy` (or confirmed CI will)
+
+## Checklist
+
+- [ ] New timing/`EventMode` behavior (if any) lives inside `EventDescriptor`'s existing Debounce/Heartbeat phase machine, not a parallel mechanism
+- [ ] No `.cpp` files added to the library itself (header-only)
+- [ ] Documentation (`doc/developer-guide.md`, `README.md`, `AGENTS.md`) updated if architecture or usage changed

.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  BUILD_DIR: build
+
+jobs:
+  build-and-test:
+    name: build-and-test (${{ matrix.compiler }}, ${{ matrix.build_type }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        compiler: [gcc, clang]
+        build_type: [Debug, Release]
+        include:
+          - compiler: gcc
+            cc: gcc-13
+            cxx: g++-13
+          - compiler: clang
+            cc: clang-18
+            cxx: clang++-18
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure CMake
+        env:
+          CC: ${{ matrix.cc }}
+          CXX: ${{ matrix.cxx }}
+        run: >
+          cmake -S . -B ${{ env.BUILD_DIR }}
+          -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
+
+      - name: Build
+        run: cmake --build ${{ env.BUILD_DIR }} --parallel
+
+      - name: Test
+        run: ctest --test-dir ${{ env.BUILD_DIR }} --output-on-failure
+
+  format-check:
+    name: clang-format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Check formatting
+        run: |
+          find include examples tests -name '*.hpp' -o -name '*.cpp' \
+            | xargs clang-format-18 --dry-run --Werror
+
+  tidy-check:
+    name: clang-tidy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # Library headers only — tests and examples are excluded by design.
+      - name: Run clang-tidy
+        run: |
+          status=0
+          for f in $(find include -name '*.hpp'); do
+            clang-tidy-18 "$f" -- -std=c++20 -Iinclude -pthread || status=1
+          done
+          exit $status

tests/EventDescriptorTests.cpp

@@ -201,8 +201,8 @@ TEST_CASE("nextDeadline reflects the armed/disarmed state across OneShot and Int
   REQUIRE_FALSE(oneShot.nextDeadline().has_value());
 
   EventDescriptor<bool> interval(EventId::ChannelLifeEthernet0,
-                                 EventConfig{.mode = EventMode::Interval, .delay = 1000ms, .interval = 3000ms},
-                                 sender, /*initial=*/false);
+                                 EventConfig{.mode = EventMode::Interval, .delay = 1000ms, .interval = 3000ms}, sender,
+                                 /*initial=*/false);
 
   interval.trigger(EventValue{true});
   REQUIRE(interval.nextDeadline() == std::optional{1000ms});