ci.yml

# ==============================================================================
# @file ci.yml
# @brief Validation only.
# @details Executes core test suites in Debug mode to ensure logic integrity 
# without the overhead of production release packaging.
# ==============================================================================

name: ci-tests

on:
  push:
    branches: [ "main", "master" ]
    paths-ignore:
      - '**.md'
      - 'docs/**'
  pull_request:
    branches: [ "main", "master" ]

# Cancel redundant runs to save free-tier minutes
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

# Strict security: The runner only needs to read the source code
permissions:
  contents: read

jobs:
  ci-test-suite:
    name: Ubuntu LTS (Debug Test Suite)
    runs-on: ubuntu-latest
    timeout-minutes: 5 # Even tighter timeout for a leaner workflow

    steps:
      - name: Checkout source code
        uses: actions/checkout@v4
        with:
          submodules: recursive 

      - name: Run Core Test Suite (Debug Mode)
        run: make test CC=clang