Complete Changes from Version 0.2.2 to 0.5.1

.commitlintrc.yml

@@ -0,0 +1,54 @@
+---
+extends: '@commitlint/config-conventional'
+
+rules:
+  # See: https://commitlint.js.org/reference/rules.html
+  #
+  # Rules are made up by a name and a configuration array. The configuration
+  # array contains:
+  #
+  # * Severity [0..2]: 0 disable rule, 1 warning if violated, or 2 error if
+  #   violated
+  # * Applicability [always|never]: never inverts the rule
+  # * Value: value to use for this rule (if applicable)
+  #
+  # Run `npx commitlint --print-config` to see the current setting for all rules.
+
+  header-max-length:      [2, always, 100]        # Header can not exceed 100 chars
+
+  type-case:              [2, always, lower-case] # Type must be lower case
+  type-empty:             [2, never]              # Type must not be empty
+
+  # Supported conventional commit types
+  type-enum:              [2, always, [build, ci, chore, docs, feat, fix, perf, refactor, revert, style, test]]
+
+  scope-case:             [2, always, lower-case] # Scope must be lower case
+
+  # Error if subject is one of these cases (encourages lower-case)
+  subject-case:           [2, never, [sentence-case, start-case, pascal-case, upper-case]]
+  subject-empty:          [2, never]              # Subject must not be empty
+  subject-full-stop:      [2, never, "."]         # Subject must not end with a period
+
+  body-leading-blank:     [2, always]             # Body must have a blank line before it
+  body-max-line-length:   [2, always, 100]        # Body lines can not exceed 100 chars
+
+  footer-leading-blank:   [2, always]             # Footer must have a blank line before it
+  footer-max-line-length: [2, always, 100]        # Footer lines can not exceed 100 chars
+
+  # ------------------------------------------------------------
+  # BREAKING CHANGES — guidance (informational; not enforced):
+  #
+  # How to mark a breaking change (either or both):
+  # 1) Put "!" in the header after the type or scope, e.g.:
+  #      feat!: drop support for node 14
+  #      refactor(auth)!: remove legacy token flow
+  #
+  # 2) Add a footer that starts with:
+  #      BREAKING CHANGE: <short summary>
+  #    Follow with impact/migration details, each line ≤ 100 chars.
+  #
+  # This config already allows both patterns via @commitlint/config-conventional.
+  # Note: commitlint cannot (in YAML) *require* a BREAKING CHANGE footer only
+  # when "!" is used. If you need that kind of conditional enforcement, use a
+  # JS config (*.cjs) with a custom rule.
+  # ------------------------------------------------------------

.github/pull_request_template.md

@@ -1,5 +1,6 @@
-## Why now?
+## Summary
 <!-- Explain the problem, context, and why this change is needed. Link to the issue. -->
+
 Related issue: #____
 
 ## What changed?

.github/workflows/ci.yml

@@ -1,23 +1,39 @@
 name: CI
 
 on:
-  push:
-    branches: [main, develop]
   pull_request:
-    branches: [main, develop]
+    branches:
+      - develop
+      - main
+      - master
+  push:
+    branches:
+      - develop
+      - main
+      - master
 
 jobs:
   build:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-java@v4
+      - uses: actions/setup-java@v5
         with:
           java-version: '21'
           distribution: 'temurin'
           cache: 'maven'
       - name: Build with Maven
-        run: ./mvnw -q verify
+        run: ./mvnw -q verify |& tee build.log
+      - name: Show build log
+        if: failure()
+        run: |
+          echo "Build error"
+          grep '^\[ERROR\]' build.log || true
+          echo "Build log tail"
+          tail -n 200 build.log
       - name: Upload surefire reports
         if: always()
         uses: actions/upload-artifact@v4
@@ -41,4 +57,22 @@ jobs:
         if: ${{ !cancelled() }}
         uses: codecov/test-results-action@v1
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
+          token: ${{ secrets.CODECOV_TOKEN }}
+      - name: Create issue on failure
+        if: failure() && github.ref == 'refs/heads/develop'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const file = fs.readFileSync('build.log', 'utf8').split('\\n');
+            const errors = file.filter(line => line.startsWith('[ERROR]'))
+              .slice(-20)
+              .join('\\n');
+            const log = file.slice(-50).join('\\n');
+            await github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `CI build failed for ${context.sha.slice(0,7)}`,
+              body: `Build failed for commit ${context.sha} in workflow run ${context.runId}.\\n\\nBuild error:\\n\\n\u0060\u0060\u0060\\n${errors}\\n\u0060\u0060\u0060\\n\\nLast lines of build log:\\n\\n\u0060\u0060\u0060\\n${log}\\n\u0060\u0060\u0060`,
+              labels: ['ci']
+            });

.github/workflows/enforce_conventional_commits.yml

@@ -0,0 +1,28 @@
+---
+name: Conventional Commits
+
+permissions:
+  contents: read
+
+on:
+  pull_request:
+    branches:
+      - develop 
+
+jobs:
+  commit-lint:
+    name: Verify Conventional Commits
+
+    # Skip this job if this is a release PR
+    if: (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--'))
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with: { fetch-depth: 0 }
+
+      - name: Check Commit Messages
+        uses: wagoid/commitlint-github-action@v6
+        with: { configFile: .commitlintrc.yml }

.github/workflows/google-java-format.yml

@@ -0,0 +1,20 @@
+name: Format
+
+on:
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+
+  formatting:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5 # v2 minimum required
+      - uses: axel-op/googlejavaformat-action@v4
+        with:
+          args: "--replace"
+          # Recommended if you use MacOS:
+          # github-token: ${{ secrets.GITHUB_TOKEN }}