moai-adk 0.11.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

moai_adk/templates/.github/workflows/cpp-tag-validation.yml

@@ -0,0 +1,79 @@
+# @CODE:LDE-010-CPP | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# C++ TAG Validation Workflow
+# Validates C++ code with g++/clang++, Google Test, and cpplint
+
+name: C++ TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 C++ Tests & Static Analysis
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        compiler: ['g++', 'clang++']
+        cpp-standard: ['17', '20']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install build tools and Google Test
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake g++ clang libgtest-dev lcov
+
+      - name: Install cpplint
+        run: pip install cpplint
+
+      - name: Set compiler
+        run: |
+          if [ "${{ matrix.compiler }}" == "g++" ]; then
+            echo "CXX=g++" >> $GITHUB_ENV
+          else
+            echo "CXX=clang++" >> $GITHUB_ENV
+          fi
+
+      - name: Run cpplint
+        run: cpplint --recursive --filter=-legal/copyright src/
+
+      - name: Configure CMake
+        run: cmake -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_STANDARD=${{ matrix.cpp-standard }} -DENABLE_COVERAGE=ON
+
+      - name: Build project
+        run: cmake --build build --config Debug
+
+      - name: Run Google Test
+        run: |
+          cd build
+          ctest --output-on-failure --verbose
+
+      - name: Generate coverage report
+        if: matrix.compiler == 'g++' && matrix.cpp-standard == '17'
+        run: |
+          cd build
+          lcov --capture --directory . --output-file coverage.info
+          lcov --remove coverage.info '/usr/*' '*/test/*' --output-file coverage.info
+          lcov --list coverage.info
+
+      - name: Upload coverage artifacts
+        if: always() && matrix.compiler == 'g++' && matrix.cpp-standard == '17'
+        uses: actions/upload-artifact@v4
+        with:
+          name: cpp-coverage-${{ matrix.compiler }}-cpp${{ matrix.cpp-standard }}
+          path: build/coverage.info
+          retention-days: 30

moai_adk/templates/.github/workflows/csharp-tag-validation.yml

@@ -0,0 +1,65 @@
+# @CODE:LDE-008-CSHARP | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# C# TAG Validation Workflow
+# Validates C# code with xUnit tests, StyleCop linting, and dotnet CLI
+
+name: C# TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 C# Tests & Linting
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        dotnet-version: ['8.0.x', '9.0.x']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ matrix.dotnet-version }}
+
+      - name: Restore dependencies
+        run: dotnet restore
+
+      - name: Build project
+        run: dotnet build --configuration Release --no-restore
+
+      - name: Run tests with coverage
+        run: dotnet test --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage"
+
+      - name: Run StyleCop analysis
+        run: dotnet build --no-restore /p:EnforceCodeStyleInBuild=true /p:TreatWarningsAsErrors=true
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: csharp-coverage-${{ matrix.dotnet-version }}
+          path: '**/TestResults/**/*.coverage'
+          retention-days: 30
+
+      - name: Publish test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: csharp-test-results-${{ matrix.dotnet-version }}
+          path: '**/TestResults/**/*.trx'
+          retention-days: 30

moai_adk/templates/.github/workflows/dart-tag-validation.yml

@@ -0,0 +1,82 @@
+# @CODE:LDE-005-DART | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Dart/Flutter TAG Validation Workflow
+# Validates Dart code with flutter test, dart analyze, and pub dependencies
+
+name: Dart TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Dart Tests & Analysis
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        dart-version: ['stable', 'beta']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check if Flutter project
+        id: detect-flutter
+        run: |
+          if grep -q "flutter:" pubspec.yaml 2>/dev/null; then
+            echo "is_flutter=true" >> $GITHUB_OUTPUT
+            echo "Flutter project detected"
+          else
+            echo "is_flutter=false" >> $GITHUB_OUTPUT
+            echo "Dart project detected"
+          fi
+
+      - name: Setup Dart (non-Flutter)
+        if: steps.detect-flutter.outputs.is_flutter == 'false'
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: ${{ matrix.dart-version }}
+
+      - name: Setup Flutter (Flutter projects)
+        if: steps.detect-flutter.outputs.is_flutter == 'true'
+        uses: subosito/flutter-action@v2
+        with:
+          channel: ${{ matrix.dart-version }}
+
+      - name: Install dependencies (Dart)
+        if: steps.detect-flutter.outputs.is_flutter == 'false'
+        run: dart pub get
+
+      - name: Install dependencies (Flutter)
+        if: steps.detect-flutter.outputs.is_flutter == 'true'
+        run: flutter pub get
+
+      - name: Run dart analyze
+        run: dart analyze --fatal-infos
+
+      - name: Run tests (Dart)
+        if: steps.detect-flutter.outputs.is_flutter == 'false'
+        run: dart test
+
+      - name: Run tests (Flutter)
+        if: steps.detect-flutter.outputs.is_flutter == 'true'
+        run: flutter test
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: dart-coverage-${{ matrix.dart-version }}
+          path: coverage/
+          retention-days: 30

moai_adk/templates/.github/workflows/java-tag-validation.yml

@@ -0,0 +1,75 @@
+# @CODE:LDE-003-JAVA | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Java TAG Validation Workflow
+# Validates Java code with JUnit 5 tests, Jacoco coverage, and Maven/Gradle builds
+
+name: Java TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Java Tests & Build
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        java-version: ['17', '21']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: ${{ matrix.java-version }}
+          cache: 'maven'  # Auto-detects Maven or Gradle
+
+      - name: Detect build tool
+        id: detect-build
+        run: |
+          if [ -f "pom.xml" ]; then
+            echo "tool=maven" >> $GITHUB_OUTPUT
+            echo "Maven detected"
+          elif [ -f "build.gradle" ] || [ -f "build.gradle.kts" ]; then
+            echo "tool=gradle" >> $GITHUB_OUTPUT
+            echo "Gradle detected"
+          else
+            echo "No build tool detected"
+            exit 1
+          fi
+
+      - name: Build and test with Maven
+        if: steps.detect-build.outputs.tool == 'maven'
+        run: |
+          mvn clean verify
+          mvn jacoco:report
+
+      - name: Build and test with Gradle
+        if: steps.detect-build.outputs.tool == 'gradle'
+        run: |
+          chmod +x gradlew
+          ./gradlew clean test jacocoTestReport
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: java-coverage-${{ matrix.java-version }}
+          path: |
+            target/site/jacoco/
+            build/reports/jacoco/
+          retention-days: 30

moai_adk/templates/.github/workflows/kotlin-tag-validation.yml

@@ -0,0 +1,67 @@
+# @CODE:LDE-007-KOTLIN | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Kotlin TAG Validation Workflow
+# Validates Kotlin code with JUnit 5 tests, ktlint, and Gradle
+
+name: Kotlin TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Kotlin Tests & Linting
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        java-version: ['17', '21']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Java (for Kotlin)
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: ${{ matrix.java-version }}
+          cache: 'gradle'
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
+      - name: Run ktlint check
+        run: ./gradlew ktlintCheck
+
+      - name: Build project
+        run: ./gradlew build
+
+      - name: Run tests with coverage
+        run: ./gradlew test jacocoTestReport
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: kotlin-coverage-java${{ matrix.java-version }}
+          path: build/reports/jacoco/
+          retention-days: 30
+
+      - name: Publish test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: kotlin-test-results-java${{ matrix.java-version }}
+          path: build/test-results/
+          retention-days: 30

moai_adk/templates/.github/workflows/php-tag-validation.yml

@@ -0,0 +1,56 @@
+# @CODE:LDE-002-PHP | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# PHP TAG Validation Workflow
+# Validates PHP code with PHPUnit tests, PHPCS linting, and composer dependencies
+
+name: PHP TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 PHP Tests & Linting
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        php-version: ['8.1', '8.2', '8.3']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          tools: composer, phpunit, phpcs
+          coverage: xdebug
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run PHPUnit tests
+        run: vendor/bin/phpunit --coverage-text
+
+      - name: Run PHPCS linting
+        run: vendor/bin/phpcs --standard=PSR12 src/
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-coverage-${{ matrix.php-version }}
+          path: coverage/
+          retention-days: 30

moai_adk/templates/.github/workflows/ruby-tag-validation.yml

@@ -0,0 +1,68 @@
+# @CODE:LDE-001-RUBY | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Ruby TAG Validation Workflow
+# Validates Ruby code with RSpec tests, Rubocop linting, and bundle dependencies
+
+name: Ruby TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Ruby Tests & Linting
+    runs-on: ubuntu-latest
+
+    # Skip validation on draft PRs (allow WIP)
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Fetch all history for comprehensive validation
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true  # Enable bundler caching
+
+      - name: Install dependencies
+        run: |
+          gem install bundler
+          bundle install
+
+      - name: Run RSpec tests
+        run: bundle exec rspec --format documentation
+
+      - name: Run Rubocop linting
+        run: bundle exec rubocop
+
+      - name: Generate coverage report
+        if: always()
+        run: |
+          echo "## Ruby Test Coverage" >> $GITHUB_STEP_SUMMARY
+          if [ -f coverage/.last_run.json ]; then
+            cat coverage/.last_run.json | ruby -rjson -e "puts JSON.parse(STDIN.read)['result']['line'].to_s + '%'" >> $GITHUB_STEP_SUMMARY || echo "Coverage data not available" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "Coverage report not generated" >> $GITHUB_STEP_SUMMARY
+          fi
+
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: ruby-coverage-${{ matrix.ruby-version }}
+          path: coverage/
+          retention-days: 30

moai_adk/templates/.github/workflows/rust-tag-validation.yml

@@ -0,0 +1,73 @@
+# @CODE:LDE-004-RUST | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Rust TAG Validation Workflow
+# Validates Rust code with cargo test, clippy linting, and rustfmt formatting
+
+name: Rust TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Rust Tests & Linting
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    strategy:
+      matrix:
+        rust-version: ['stable', 'beta']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: ${{ matrix.rust-version }}
+          components: rustfmt, clippy
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/registry
+          key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache cargo index
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/git
+          key: ${{ runner.os }}-cargo-git-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Run cargo test
+        run: cargo test --verbose
+
+      - name: Run clippy (treat warnings as errors)
+        run: cargo clippy -- -D warnings
+
+      - name: Check formatting with rustfmt
+        run: cargo fmt -- --check
+
+      - name: Generate coverage report
+        if: matrix.rust-version == 'stable'
+        run: |
+          cargo install cargo-tarpaulin
+          cargo tarpaulin --out Xml --output-dir coverage
+
+      - name: Upload coverage artifacts
+        if: always() && matrix.rust-version == 'stable'
+        uses: actions/upload-artifact@v4
+        with:
+          name: rust-coverage
+          path: coverage/
+          retention-days: 30

moai_adk/templates/.github/workflows/shell-tag-validation.yml

@@ -0,0 +1,65 @@
+# @CODE:LDE-011-SHELL | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+# Shell TAG Validation Workflow
+# Validates shell scripts with shellcheck and bats-core
+
+name: Shell TAG Validation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main, develop, "feature/**"]
+
+jobs:
+  test:
+    name: 🧪 Shell Tests & Linting
+    runs-on: ubuntu-latest
+
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install shellcheck and bats
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y shellcheck bats
+
+      - name: Run shellcheck on all shell scripts
+        run: |
+          echo "Running shellcheck on all .sh files"
+          find . -name "*.sh" -type f -print0 | xargs -0 shellcheck --severity=warning
+
+      - name: Check for POSIX compatibility
+        run: |
+          echo "Checking POSIX compatibility"
+          find . -name "*.sh" -type f -print0 | xargs -0 shellcheck --shell=sh
+
+      - name: Run bats tests
+        if: hashFiles('tests/**/*.bats') != ''
+        run: |
+          if [ -d "tests" ]; then
+            bats tests/
+          else
+            echo "No tests/ directory found, skipping bats tests"
+          fi
+
+      - name: Generate test summary
+        if: always()
+        run: |
+          echo "## Shell Script Validation Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- shellcheck: ✅ Passed" >> $GITHUB_STEP_SUMMARY
+          echo "- POSIX compatibility: ✅ Passed" >> $GITHUB_STEP_SUMMARY
+          if [ -d "tests" ]; then
+            echo "- bats tests: ✅ Executed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- bats tests: ⚠️ No tests found" >> $GITHUB_STEP_SUMMARY
+          fi