feat(ci): Add multi-architecture RPM builds and local GitHub Actions testing

- Add act configuration for local GitHub Actions workflow testing
- Implement multi-architecture RPM builds (x86_64, aarch64)
- Improve RPM build scripts with architecture-specific support
- Add comprehensive RPM build documentation
- Fix clang-tidy warnings and improve code formatting checks
- Enhance test infrastructure with proper discovery timeouts
- Add missing cstdint include in error.h

Author: libraz

.actrc

@@ -0,0 +1,17 @@
+# act configuration file
+# See: https://nektosact.com/usage/index.html
+
+# Use medium-sized Docker images (balance between size and features)
+-P ubuntu-latest=catthehacker/ubuntu:act-latest
+
+# For Apple Silicon, use amd64 architecture
+--container-architecture linux/amd64
+
+# Enable verbose output
+-v
+
+# Reuse containers to speed up subsequent runs
+--reuse
+
+# Bind Docker socket for Docker-in-Docker operations
+--container-daemon-socket -

.clang-tidy

@@ -3,6 +3,7 @@ Checks: >
   clang-diagnostic-*,
   clang-analyzer-*,
   -clang-analyzer-cplusplus.NewDeleteLeaks,
+  -clang-analyzer-core.uninitialized.Assign,
   cppcoreguidelines-*,
   modernize-*,
   performance-*,

.github/workflows/release.yml

@@ -10,15 +10,24 @@ permissions:
 
 jobs:
   build-rpm:
-    name: Build RPM Package
+    name: Build RPM Package (${{ matrix.arch }})
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        arch: [x86_64, aarch64]
+      fail-fast: false
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           fetch-depth: 0  # Fetch all history for git describe
 
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64,amd64
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
@@ -27,60 +36,167 @@ jobs:
         run: |
           VERSION="${GITHUB_REF#refs/tags/v}"
           echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "Building version: $VERSION"
+          echo "Building version: $VERSION for architecture: ${{ matrix.arch }}"
 
-      - name: Build RPM package
+      - name: Set architecture-specific variables
+        id: arch
+        run: |
+          if [ "${{ matrix.arch }}" = "x86_64" ]; then
+            echo "docker_platform=linux/amd64" >> $GITHUB_OUTPUT
+            echo "docker_arch=amd64" >> $GITHUB_OUTPUT
+          else
+            echo "docker_platform=linux/arm64" >> $GITHUB_OUTPUT
+            echo "docker_arch=arm64" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Build RPM builder Docker image
         run: |
-          cd support/rpm
-          ./test-rpm-build.sh
+          docker buildx build \
+            --platform ${{ steps.arch.outputs.docker_platform }} \
+            --load \
+            --cache-from type=gha,scope=rpmbuild-${{ matrix.arch }} \
+            --cache-to type=gha,mode=max,scope=rpmbuild-${{ matrix.arch }} \
+            -f support/rpm/Dockerfile.rpmbuild \
+            -t mygramdb-rpmbuild:${{ steps.version.outputs.version }}-${{ matrix.arch }} \
+            .
+
+      - name: Build RPM packages
+        run: |
+          # Create output directory in workspace
+          mkdir -p "$GITHUB_WORKSPACE/dist/rpm"
+
+          # Run RPM build with absolute paths
+          docker run --rm \
+            --platform ${{ steps.arch.outputs.docker_platform }} \
+            -e MYGRAMDB_VERSION="${{ steps.version.outputs.version }}" \
+            -v "$GITHUB_WORKSPACE/dist:/workspace/dist" \
+            mygramdb-rpmbuild:${{ steps.version.outputs.version }}-${{ matrix.arch }}
 
-      - name: List generated RPMs
+      - name: Verify RPM packages exist
         run: |
+          if ! ls dist/rpm/*.rpm 1> /dev/null 2>&1; then
+            echo "Error: No RPM packages found in dist/rpm/"
+            ls -la dist/rpm/ || true
+            exit 1
+          fi
           echo "Generated RPM packages:"
           ls -lh dist/rpm/*.rpm
 
       - name: Test RPM installation (AlmaLinux 9)
         run: |
-          docker run --rm -v "$(pwd)/dist:/dist" almalinux:9 bash -c "
+          # Find the main RPM package (not debuginfo/debugsource/devel)
+          MAIN_RPM=$(find dist/rpm -name "mygramdb-${{ steps.version.outputs.version }}-*.el9.${{ matrix.arch }}.rpm" \
+            ! -name "*debuginfo*" ! -name "*debugsource*" ! -name "*devel*" -print -quit)
+
+          if [ -z "$MAIN_RPM" ]; then
+            echo "Error: Main RPM package not found for architecture ${{ matrix.arch }}"
+            echo "Looking for: mygramdb-${{ steps.version.outputs.version }}-*.el9.${{ matrix.arch }}.rpm"
+            echo "Available files:"
+            ls -la dist/rpm/
+            exit 1
+          fi
+
+          echo "Testing RPM: $MAIN_RPM"
+
+          docker run --rm \
+            --platform ${{ steps.arch.outputs.docker_platform }} \
+            -v "$GITHUB_WORKSPACE/dist:/dist" \
+            almalinux:9 bash -c "
+            set -e
             echo '=== Installing Oracle MySQL 8.0 repository ==='
-            dnf install -y https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm > /dev/null 2>&1
-            dnf module disable -y mysql > /dev/null 2>&1
+            dnf install -y https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm
+            dnf module disable -y mysql
 
             echo '=== Installing MygramDB RPM ==='
-            dnf install -y /dist/rpm/mygramdb-${{ steps.version.outputs.version }}-*.el9.*.rpm
+            dnf install -y /dist/rpm/$(basename $MAIN_RPM)
 
             echo '=== Verifying installation ==='
+            echo 'Checking binaries exist...'
+            test -x /usr/bin/mygramdb || (echo 'Error: mygramdb binary not found'; exit 1)
+            test -x /usr/bin/mygram-cli || (echo 'Error: mygram-cli binary not found'; exit 1)
+
             echo 'Checking for missing library dependencies...'
-            ldd /usr/bin/mygramdb | grep 'not found' && exit 1 || echo 'mygramdb: OK'
-            ldd /usr/bin/mygram-cli | grep 'not found' && exit 1 || echo 'mygram-cli: OK'
+            if ldd /usr/bin/mygramdb | grep 'not found'; then
+              echo 'Error: mygramdb has missing dependencies'
+              exit 1
+            fi
+            echo 'mygramdb: OK'
+
+            if ldd /usr/bin/mygram-cli | grep 'not found'; then
+              echo 'Error: mygram-cli has missing dependencies'
+              exit 1
+            fi
+            echo 'mygram-cli: OK'
 
             echo '=== Installation test passed! ==='
           "
 
       - name: Upload RPM artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: rpm-packages
-          path: |
-            dist/rpm/*.rpm
+          name: rpm-packages-${{ matrix.arch }}
+          path: dist/rpm/*.rpm
           retention-days: 30
+          if-no-files-found: error
+
+  create-release:
+    name: Create GitHub Release
+    needs: build-rpm
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/v}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist/rpm
+          pattern: rpm-packages-*
+          merge-multiple: true
+
+      - name: List downloaded artifacts
+        run: |
+          echo "Downloaded RPM packages:"
+          ls -lh dist/rpm/
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           name: Release ${{ steps.version.outputs.version }}
           draft: false
           prerelease: false
           generate_release_notes: true
-          files: |
-            dist/rpm/mygramdb-${{ steps.version.outputs.version }}-*.el9.*.rpm
-            dist/rpm/mygramdb-debuginfo-${{ steps.version.outputs.version }}-*.el9.*.rpm
-            dist/rpm/mygramdb-debugsource-${{ steps.version.outputs.version }}-*.el9.*.rpm
+          files: dist/rpm/*.rpm
+          fail_on_unmatched_files: true
           body: |
             ## MygramDB ${{ steps.version.outputs.version }}
 
             ### Installation (RHEL/AlmaLinux/Rocky Linux 9)
 
+            #### For x86_64 (Intel/AMD):
+            ```bash
+            # Install Oracle MySQL 8.0 repository
+            sudo dnf install -y https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm
+            sudo dnf module disable -y mysql
+
+            # Download and install MygramDB RPM
+            wget https://github.com/${{ github.repository }}/releases/download/v${{ steps.version.outputs.version }}/mygramdb-${{ steps.version.outputs.version }}-1.el9.x86_64.rpm
+            sudo dnf install -y ./mygramdb-${{ steps.version.outputs.version }}-1.el9.x86_64.rpm
+
+            # Configure and start service
+            sudo cp /etc/mygramdb/config.yaml.example /etc/mygramdb/config.yaml
+            sudo vi /etc/mygramdb/config.yaml  # Edit configuration
+            sudo systemctl enable --now mygramdb
+            ```
+
+            #### For aarch64 (ARM64):
             ```bash
             # Install Oracle MySQL 8.0 repository
             sudo dnf install -y https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm
@@ -98,7 +214,7 @@ jobs:
 
             ### Package Details
             - **Platform**: RHEL 9 / AlmaLinux 9 / Rocky Linux 9
-            - **Architecture**: aarch64 (ARM64)
+            - **Architectures**: x86_64 (Intel/AMD), aarch64 (ARM64)
             - **Build Type**: Static linking (minimal dependencies)
             - **Dependencies**: libicu, MySQL client libraries (auto-installed)
 
@@ -108,3 +224,8 @@ jobs:
             - Systemd service: `/usr/lib/systemd/system/mygramdb.service`
             - Config example: `/etc/mygramdb/config.yaml.example`
             - Data directory: `/var/lib/mygramdb`
+
+            ### Available Packages
+            - `mygramdb-${{ steps.version.outputs.version }}-1.el9.x86_64.rpm` - Main package (x86_64)
+            - `mygramdb-${{ steps.version.outputs.version }}-1.el9.aarch64.rpm` - Main package (aarch64)
+            - Debug packages available for both architectures

.gitignore

@@ -28,6 +28,10 @@ _deps/
 .claude/
 CLAUDE.md
 
+# act (GitHub Actions local runner)
+.secrets
+.act/
+
 # Cache
 .cache/
 

Makefile

@@ -148,13 +148,13 @@ uninstall:
 # Format code with clang-format
 format:
 	@echo "Formatting code..."
-	@find src tests -name "*.cpp" -o -name "*.h" | xargs $(CLANG_FORMAT) -i
+	@find src tests -type f \( -name "*.cpp" -o -name "*.h" \) ! -path "*/build/*" | xargs $(CLANG_FORMAT) -i
 	@echo "Format complete!"
 
 # Check code formatting (CI mode - fails on formatting issues)
 format-check:
 	@echo "Checking code formatting..."
-	@find src tests -name "*.cpp" -o -name "*.h" | xargs $(CLANG_FORMAT) --dry-run --Werror
+	@find src tests -type f \( -name "*.cpp" -o -name "*.h" \) ! -path "*/build/*" | xargs $(CLANG_FORMAT) --dry-run --Werror
 	@echo "Format check passed!"
 
 # Check code with clang-tidy
@@ -270,7 +270,7 @@ docker-lint-linux: docker-build-linux
 docker-format-check-linux: docker-dev-build
 	@echo "Checking code formatting in Linux container..."
 	docker run --rm -v $$(pwd):/workspace -w /workspace $(DOCKER_DEV_IMAGE) \
-		bash -c "find src tests -name '*.cpp' -o -name '*.h' | xargs clang-format --dry-run --Werror"
+		bash -c "find src tests -type f \( -name '*.cpp' -o -name '*.h' \) ! -path '*/build/*' | xargs clang-format --dry-run --Werror"
 	@echo "Format check passed!"
 
 # Clean build directory in Linux container

src/utils/error.h

@@ -9,6 +9,7 @@
 
 #pragma once
 
+#include <cstdint>
 #include <sstream>
 #include <string>
 #include <utility>

support/dev/Dockerfile

@@ -47,8 +47,8 @@ RUN ccache --set-config=max_size=500M
 WORKDIR /workspace
 
 # Default compiler (matching CI)
-ENV CC=ccache gcc
-ENV CXX=ccache g++
+ENV CC="ccache gcc"
+ENV CXX="ccache g++"
 
 # Default command: show help
 CMD ["bash", "-c", "echo 'MygramDB Linux Development Environment'; \

support/rpm/Dockerfile.rpmbuild

@@ -1,6 +1,15 @@
 # Dockerfile for building RPM packages
 FROM rockylinux:9
 
+# Accept build arguments for multi-arch support
+ARG TARGETARCH
+ARG TARGETPLATFORM
+
+# Log build information
+RUN echo "Building for platform: ${TARGETPLATFORM:-unknown}" && \
+    echo "Target architecture: ${TARGETARCH:-unknown}" && \
+    echo "System architecture: $(uname -m)"
+
 # Install Oracle MySQL 8.0 repository
 RUN dnf -y install \
     https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm && \
@@ -51,6 +60,7 @@ VERSION="${MYGRAMDB_VERSION:-0.0.0}"
 NAME="mygramdb"
 
 echo -e "${YELLOW}Building ${NAME}-${VERSION}${NC}"
+echo -e "${YELLOW}Architecture: $(uname -m)${NC}"
 
 # Create source tarball
 echo -e "${YELLOW}Creating source tarball...${NC}"