AI CodeOps

بوابات الجودة في GitHub Actions: إعدادات لعشر منظومات تقنية

Matt · · آخر تحديث · مدة القراءة: ⁨10⁩ دقيقة · الأدلة

بوابات جودة جاهزة للنسخ في GitHub Actions لعشر منظومات تقنية: الاختبارات، والحد الأدنى للتغطية، وقائمة SBOM، وسياسة التراخيص، وفحص الأسرار، مع إعداد AI CodeOps المقابل.

بوابة الجودة في GitHub Actions مهمة تُفشل طلب السحب حين لا تستوفى قاعدة ما، وتجعل فحصا مطلوبا فيبقى زر الدمج مقفلا إلى أن تنجح. وتعطي الوصفات أدناه عشر منظومات تقنية البوابات الخمس نفسها: الاختبارات، والحد الأدنى للتغطية، وقائمة SBOM بصيغة CycloneDX، وسياسة التراخيص، وفحص الأسرار، ولكل منها إعداد AI CodeOps المقابل. انسخ المهام المشتركة مرة واحدة، وأضف مهمة الاختبارات لمنظومتك، واشترط الفحوص.

ما تحتاجه بوابة الدمج

حين يفتح وكلاء الذكاء الاصطناعي طلبات السحب، لا تعود المراجعة عنق الزجاجة، بل تصبح نقطة الضعف. فالفريق الذي كان يراجع خمسة تغييرات في اليوم قد يتلقى الآن خمسين. والناس يتعبون. أما البوابة فلا. وكل وصفة هنا تمنع طلب السحب بسبب خمسة أمور:

  1. الاختبارات. يجب أن تنجح مجموعة الاختبارات.
  2. الحد الأدنى للتغطية. تغطية الأسطر التي تقل عن الحد الأدنى تفشل. وكل الوصفات تستخدم 80%؛ فاختر رقمك.
  3. قائمة SBOM. تبنى قائمة SBOM بصيغة CycloneDX لكل تغيير، وتحفظ مخرجا من مخرجات البناء. والقائمة الفارغة تفشل.
  4. سياسة التراخيص. طلب السحب الذي يضيف تبعية بترخيص لم تسمح به يفشل.
  5. فحص الأسرار. الإيداع في التغيير الذي يحتوي سرا يفشل.

والملاحظات عالية الخطورة تمنع أيضا: فمهمة التراخيص تفشل عند وجود ثغرات معروفة في التبعيات الجديدة، وفي تغييرات AI CodeOps تمنع بوابة الإصدار عند وجود ملاحظات مفتوحة.

هذه مسارات سير عمل عادية. وهي تعمل دون أي منتج، ومنها منتجنا. وقد راجعت كل إصدار للإجراءات وكل مدخل أدناه في ملف README الخاص بذلك الإجراء في 24 أكتوبر 2026، وشغلت حدي Node و Go محليا فوق الخط وتحته. ومع ذلك، شغل كل وصفة على فرع قبل أن تجعلها فحصا مطلوبا. ويشرح دليل بوابات الجودة ما البوابة وكيف تصممها؛ أما هذا المقال فللإعدادات.

قاعدتان وراء كل وصفة

الإغلاق عند الخطأ. البوابة التي لا تستطيع العمل يجب أن تفشل، لا أن تنجح. فلا يوجد continue-on-error ولا || true في أي مكان من هذه الملفات. وإذا لم تجد أداة SBOM شيئا، تفشل المهمة. وإذا تعذرت قراءة رقم التغطية، تفشل المهمة.

أبق الحد الأدنى في سير العمل. تتيح معظم الأدوات ضبط عتبة التغطية في ملف إعدادات: vitest.config.ts، أو pyproject.toml، أو .coveragerc. وذلك الملف يقع بجانب الكود، فالتغيير الذي يخفض التغطية يستطيع أن يخفض الحد الأدنى في الفروقات نفسها. ووكيل الذكاء الاصطناعي الذي يطلب منه «جعل CI ينجح» يفعل ذلك بالضبط أحيانا. وحيث يكون للأداة خيار في سطر الأوامر أو متغير بيئة، تضبط هذه الوصفات الحد الأدنى هناك، في .github/workflows/. ثم أضف .github/ إلى CODEOWNERS، فيحتاج تغيير أي بوابة إلى مراجعة أحد المالكين.

المهام المشتركة الثلاث

الأسرار وقائمة SBOM والتراخيص واحدة لكل المنظومات. وهذه هي مرة واحدة. وكل وصفة تنتهي بهذه المهام الثلاث، دون تغيير.

secrets:
  name: Secrets scan
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v7
      with:
        fetch-depth: 0
        persist-credentials: false
    - name: gitleaks
      env:
        RANGE: ${{ github.event_name == 'pull_request' && format('{0}..{1}', github.event.pull_request.base.sha, github.event.pull_request.head.sha) || format('{0}..{1}', github.event.before, github.sha) }}
      run: >-
        docker run --rm -v "$PWD:/repo" ghcr.io/gitleaks/gitleaks:v8.30.1
        git /repo --redact --verbose --log-opts="$RANGE"

sbom:
  name: SBOM (CycloneDX)
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v7
      with:
        persist-credentials: false
    - uses: anchore/sbom-action@v0
      with:
        path: .
        format: cyclonedx-json
        output-file: sbom.cdx.json
        upload-artifact: false
    - name: The SBOM lists components
      run: jq -e '(.components // []) | length > 0' sbom.cdx.json
    - uses: actions/upload-artifact@v7
      with:
        name: sbom-cyclonedx
        path: sbom.cdx.json

licenses:
  name: License policy
  if: github.event_name == 'pull_request'
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v7
      with:
        persist-credentials: false
    - uses: actions/dependency-review-action@v5
      with:
        config-file: ./.github/dependency-review-config.yml

وفيه بضعة خيارات تستحق الشرح.

أداة Gitleaks من صورتها، لا من إجرائها. الملف الثنائي لأداة gitleaks مرخص بترخيص MIT ولا يحتاج إلى مفتاح. أما إجراء gitleaks في GitHub Actions فيطلب من المؤسسات مفتاح ترخيص. وتشغيل الصورة الرسمية، مثبتة على إصدار، يتجنب المفتاح ويبقي الإصدار تحت تحكمك. ولا يغطي الفحص إلا الإيداعات التي يضيفها التغيير، من الفرع الأساسي لطلب السحب إلى رأسه، فلا يمنع تسريب قديم في موضع آخر من التاريخ تغيير اليوم. وضع ملف .gitleaks.toml في جذر المستودع لضبط القواعد؛ فالصورة تلتقطه.

أداة Syft لكل قوائم SBOM. يشغل anchore/sbom-action أداة Syft على النسخة المستخرجة ويكتب CycloneDX بصيغة JSON. وتقرأ Syft ملفات القفل لكل المنظومات هنا: package-lock.json و requirements.txt و go.sum و Gemfile.lock و pom.xml و packages.lock.json و Cargo.lock. وخطوة jq -e تُفشل المهمة حين لا تحتوي قائمة SBOM على مكونات، وهذا يعني أنه لم يعثر على ملف قفل. والقائمة الفارغة التي تنجح أسوأ من غيابها.

مراجعة التبعيات للتراخيص. يقارن طلب السحب بفرعه الأساسي، ويفشل عند أي تبعية جديدة ترخيصها ليس في قائمتك. وهناك ثلاثة أمور ينبغي معرفتها. فهو يحتاج إلى رسم التبعيات (dependency graph) في GitHub، وهو مفعل للمستودعات العامة ويحتاج إلى GitHub Advanced Security للمستودعات الخاصة. ويفحص التبعيات التي يضيفها طلب السحب أو يغيرها، لا الموجودة أصلا. وإذا تعذر عليه اكتشاف ترخيص، يبلغ عنه لكنه لا يفشل.

وتوجد قائمة التراخيص في .github/dependency-review-config.yml، كما يلي:

allow-licenses:
  - MIT
  - Apache-2.0
  - BSD-2-Clause
  - BSD-3-Clause
  - ISC
  - 0BSD
  - Zlib
  - Unlicense
  - CC0-1.0
  - BlueOak-1.0.0
  - Python-2.0
  - MPL-2.0
fail-on-severity: high

إنها قائمة سماح عن قصد. فالخيار deny-licenses في هذا الإجراء مهمل، وقائمة الحظر تسمح بمرور كل ترخيص لم تفكر فيه. والقائمة أعلاه مثال على سياسة متساهلة، لا استشارة قانونية. والإجراء نفسه يفشل أيضا عند وجود ثغرات معروفة في التبعيات الجديدة؛ ويضع fail-on-severity: high ذلك الحد.

وكل سير عمل يبدأ بالطريقة نفسها: يعمل على pull_request وعلى عمليات الدفع إلى main، مع permissions: contents: read ولا شيء أكثر.

المنظومات العشر

لا تعرض كل منظومة أدناه إلا خطوات مهمة tests الخاصة بها. ضعها تحت jobs.tests.steps، وأعط المهمة name: Tests and coverage floor، وأضف المهام المشتركة الثلاث، فيكتمل سير العمل. وكل مهمة tests تبدأ بخطوة الاستخراج نفسها؛ وهي معروضة مرة واحدة، في الوصفة الأولى.

ولكل منظومة أيضا إعداد AI CodeOps. فجلسة AI CodeOps تشغل Test command (أمر الاختبار) الخاص بمشروعك (يضبط على المشروع تحت Plan → Projects) على تغييرها داخل بيئة معزولة وتسجل النتيجة، ثم تستطيع بوابة الإصدار في CI لديك أن تشترط minCoveragePct: 80. ولا تسجل الجلسة التغطية إلا حين يطبع الأمر ملخصا يقرؤه AI CodeOps: سطر TOTAL من pytest-cov أو coverage.py، أو جدول All files من Vitest أو Jest أو مشغل الاختبارات في Node، أو سطر Coverage: 85%. ويخزن الرقم عددا صحيحا مقربا إلى الأدنى، فتفشل نسبة 79.6% أمام حد أدنى قدره 80. والتشغيل الذي لا ملخص تغطية فيه لا يمكن فحصه في ضوء حد أدنى، فترفضه بوابة الإصدار حين يضبط minCoveragePct. تأكد من أن صفحة التشغيل تعرض رقما للتغطية قبل أن تضيف الحد الأدنى.

Next.js

- uses: actions/checkout@v7
  with:
    persist-credentials: false
- uses: actions/setup-node@v7
  with:
    node-version: 24
    cache: npm
- run: npm ci
- run: npx vitest run --coverage.enabled --coverage.thresholds.lines=80
- run: npm run build

أداة Vitest هي مشغل اختبارات الوحدات الذي تعده وثائق Next.js. أضف @vitest/coverage-v8 إلى تبعيات التطوير التي يسردها الدليل. ويفحص next build الأنواع أيضا. ولا تشغل Vitest مكونات الخادم من نوع async، فتحتاج إلى اختبارات شاملة ولا تحتسب في هذا الحد الأدنى.

إعداد AI CodeOps: أمر الاختبار npx vitest run --coverage.enabled --coverage.thresholds.lines=80. ويطبع المبلغ النصي في Vitest جدول All files، ويأخذ AI CodeOps عموده الأول، وهو التعليمات لا الأسطر.

Node.js

- run: npm ci
- run: node --test --experimental-test-coverage --test-coverage-lines=80

لمشغل الاختبارات المضمّن في Node خيار للحد الأدنى منذ Node 22.8. وتحت الحد ينتهي التشغيل بالرمز 1 مع سطر مثل Error: 53.85% line coverage does not meet threshold of 80%. وما زالت التغطية في المشغل موسومة بأنها تجريبية. وخطوتا الاستخراج و setup-node كما في Next.js.

إعداد AI CodeOps: أمر الاختبار node --test --experimental-test-coverage --test-coverage-lines=80. وينتهي تقرير المشغل بصف all files يقرؤه AI CodeOps.

Python / Django

- uses: actions/setup-python@v7
  with:
    python-version: "3.13"
    cache: pip
- run: pip install -r requirements.txt coverage
- run: python manage.py makemigrations --check --dry-run
- run: coverage run --source=. manage.py test
- run: coverage report --fail-under=80

يفشل فحص عمليات الترحيل حين يتغير نموذج دون عملية ترحيل. وهذه خطوة يسهل على الوكيل نسيانها. ضع قواعد omit لعمليات الترحيل والإعدادات في .coveragerc، لكن أبق --fail-under في سطر الأوامر.

إعداد AI CodeOps: أمر الاختبار coverage run --source=. manage.py test && coverage report --fail-under=80. ويحمل سطر TOTAL في التقرير النسبة المئوية.

FastAPI

- run: pip install -r requirements.txt -r requirements-dev.txt
- run: pytest --cov=app --cov-report=term-missing --cov-fail-under=80

اضبط Python كما في Django. ويحتوي requirements-dev.txt على pytest و pytest-cov و httpx، الذي يحتاجه TestClient في FastAPI. وغيّر --cov=app إلى حزمتك.

إعداد AI CodeOps: أمر الاختبار pytest --cov=app --cov-fail-under=80. ويحمل سطر TOTAL من pytest-cov النسبة المئوية.

Go

- uses: actions/setup-go@v7
  with:
    go-version-file: go.mod
- run: go vet ./...
- run: go test -race -coverprofile=coverage.out ./...
- name: 80% statement coverage floor
  run: |
    total=$(go tool cover -func=coverage.out | awk '/^total:/ { sub("%", "", $3); print $3 }')
    echo "Total coverage: ${total:-none}%"
    awk -v t="$total" 'BEGIN { exit !(t != "" && t + 0 >= 80) }' || { echo "::error::Coverage ${total:-none}% is below the 80% floor"; exit 1; }

لا يوجد في go test خيار للحد الأدنى، فتقرأ الخطوة سطر total: وتقارنه. وعلى وحدة اختبار صغيرة تغطيتها 33.3% تفشل عند 80 وتنجح عند 30. والإجمالي الفارغ يفشل أيضا، فلا تستطيع خطوة اختبار لم تكتب ملف تغطية أن تتسلل.

إعداد AI CodeOps: أمر الاختبار go test -coverprofile=coverage.out ./... && go tool cover -func=coverage.out. وينتهي go tool cover -func بسطر total:، يقرؤه AI CodeOps كما يقرأ سطر TOTAL.

Ruby on Rails

- uses: ruby/setup-ruby@v1
  with:
    bundler-cache: true
- run: bin/rails db:prepare
  env:
    RAILS_ENV: test
- run: bin/rails test
  env:
    RAILS_ENV: test
    PARALLEL_WORKERS: "1"
    COVERAGE_MIN: "80"

وفي أعلى ملف test/test_helper.rb تماما:

require "simplecov"
SimpleCov.start "rails" do
  minimum_coverage Integer(ENV.fetch("COVERAGE_MIN", "80"))
end

لا يوجد في SimpleCov حد أدنى في سطر الأوامر، فيمرره سير العمل في متغير بيئة. وعامل تشغيل واحد يبقي مجموعة الاختبارات في عملية واحدة، فترى SimpleCov كلها.

إعداد AI CodeOps: أمر الاختبار bin/rails test، مع ضبط COVERAGE_MIN كما أعلاه. وتطبع SimpleCov في نهاية التشغيل سطرا على نمط Line Coverage: 85.0%.

Java / Spring Boot (Maven)

- uses: actions/setup-java@v6
  with:
    distribution: temurin
    java-version: "21"
    cache: maven
- run: ./mvnw -B verify -Dcoverage.minimum=0.80

أضف jacoco-maven-plugin بالإصدار 0.8.15 إلى pom.xml مع الأهداف prepare-agent و report و check، وقاعدة BUNDLE على LINE COVEREDRATIO مع <minimum>${coverage.minimum}</minimum>. ويرتبط check بالمرحلة verify، فيفشل البناء تحت الحد الأدنى. وفي Gradle، لا يرى رسم التبعيات في GitHub البناء إلا عبر إرسال التبعيات (dependency submission)، فأعد ذلك قبل أن تعتمد على فحص التراخيص.

إعداد AI CodeOps: تكتب JaCoCo تقريرها إلى ملفات، لا إلى واجهة الأوامر، فيسجل تشغيل الجلسة النجاح أو الفشل دون تغطية. أبق الحد الأدنى في بناء Maven، فيفشل البناء تحته في كل الأحوال. واحذف minCoveragePct من استدعاء بوابة الإصدار لهذه المنظومة: فمع عدم تسجيل أي تغطية، سترفض البوابة كل تغيير.

.NET

- uses: actions/setup-dotnet@v6
  with:
    dotnet-version: "10.0.x"
- run: dotnet restore --locked-mode
- run: dotnet test --no-restore /p:CollectCoverage=true /p:Threshold=80 /p:ThresholdType=line /p:ThresholdStat=total

أضف coverlet.msbuild إلى كل مشروع اختبار، واضبط RestorePackagesWithLockFile على true، لتوجد ملفات packages.lock.json من أجل --locked-mode ومن أجل Syft. ويفحص ThresholdStat=total الحل كله بدل كل وحدة على حدة. وهناك تنبيه واحد: تعمل coverlet.msbuild مع VSTest، وهو الافتراضي، ولا تجمع شيئا تحت Microsoft.Testing.Platform. فإذا كان ملف global.json لديك يختار تلك المنصة، فاستخدم إضافة التغطية الخاصة بها.

إعداد AI CodeOps: كما مع JaCoCo، اعتمد على Threshold في البناء نفسه لإفشال التشغيل؛ وافحص صفحة تشغيل الجلسة قبل أن تضبط minCoveragePct أيضا.

Rust

- run: rustup update stable
- uses: taiki-e/install-action@cargo-llvm-cov
- run: cargo clippy --all-targets --all-features -- -D warnings
- run: cargo llvm-cov --all-features --workspace --fail-under-lines 80

هذا هو الإعداد الذي يستخدمه مثال CI الخاص بأداة cargo-llvm-cov، مع إضافة خيار الحد الأدنى. وأودع Cargo.lock، للمكتبات أيضا، لترى قائمة SBOM وفحص التراخيص الإصدارات بدقة.

إعداد AI CodeOps: أمر الاختبار cargo llvm-cov --workspace --fail-under-lines 80. يُفشل الخيار التشغيل تحت الحد الأدنى؛ وافحص صفحة التشغيل لترى أي نسبة سجلتها الجلسة قبل أن تضبط minCoveragePct أيضا.

المستودع الأحادي (Monorepo)

يحتاج المستودع الأحادي إلى فكرة إضافية. فأنت لا تريد تشغيل اختبارات كل حزمة مع كل تغيير، فتصفي حسب المسار. لكن GitHub يبلغ عن المهمة التي تخطاها شرطها if على أنها ناجحة، حتى حين تكون فحصا مطلوبا. فإذا كانت web مطلوبة وفشلت المهمة التي تقرر هل تعمل، تتخطى web، وينجح طلب السحب.

والحل مهمة أخيرة واحدة تعمل في كل مرة وتقرأ كل نتيجة:

changes:
  runs-on: ubuntu-latest
  permissions:
    contents: read
    pull-requests: read
  outputs:
    web: ${{ steps.filter.outputs.web }}
    api: ${{ steps.filter.outputs.api }}
  steps:
    - uses: actions/checkout@v7
      with:
        persist-credentials: false
    - uses: dorny/paths-filter@v4
      id: filter
      with:
        filters: |
          web:
            - 'apps/web/**'
            - 'package-lock.json'
          api:
            - 'services/api/**'

# web and api: the Next.js and FastAPI test steps above, each with
# needs: changes and if: needs.changes.outputs.<name> == 'true'

gate:
  name: Quality gates
  if: always()
  needs: [changes, web, api, secrets, sbom, licenses]
  runs-on: ubuntu-latest
  steps:
    - env:
        RESULTS: ${{ toJSON(needs.*.result) }}
      run: |
        echo "$RESULTS"
        if echo "$RESULTS" | grep -Eq '"(failure|cancelled)"'; then exit 1; fi

اشترط Quality gates وحدها. فالتخطي لا ينجح الآن إلا حين يقول المرشح إن تلك الحزمة لم تتغير. وما زالت مهام الأسرار وقائمة SBOM والتراخيص تعمل مع كل تغيير، على المستودع كله، وتجد Syft ملف القفل لكل حزمة.

إعداد AI CodeOps: يحتاج المستودع الأحادي عادة إلى أمر اختبار خاص به، مثل نص برمجي يشغل الحزم التي يمسها التغيير. اضبطه على المشروع؛ فالاستنتاج التلقائي لا يبحث إلا عن نص اختبار واحد في package.json، أو pytest، أو Go، في الجذر.

جعلها فحوصا مطلوبة

سير العمل الفاشل لا يوقف الدمج وحده. فلا يقفل GitHub زر الدمج إلا على الفحوص التي توسمها بأنها مطلوبة: في حماية الفروع، «يجب أن تنجح كل فحوص الحالة المطلوبة قبل أن يتمكن المتعاونون من دمج التغييرات في الفرع المحمي» (About protected branches، راجعتها في 24 أكتوبر 2026). وتذكر الصفحة نفسها skipped بين الحالات التي تستوفي الفحص المطلوب، ولهذا تنتهي وصفة المستودع الأحادي بمهمة واحدة تعمل دائما.

  • اشترط الفحوص. في حماية الفروع أو في مجموعة قواعد على الفرع الافتراضي، اشترط Tests and coverage floor و Secrets scan و SBOM (CycloneDX) و License policy، أو Quality gates في المستودع الأحادي. ولا يظهر الفحص في قائمة الاختيار إلا بعد أن يعمل مرة واحدة، فافتح طلب سحب تجريبيا أولا. ويشرح مقال مجموعات القواعد في GitHub لوكلاء الذكاء الاصطناعي مجموعة القواعد نفسها خطوة بخطوة.
  • احم البوابات. ضع CODEOWNERS على .github/، مع اشتراط مراجعة مالكي الكود. فتغيير البوابة تغيير في سياستك.
  • ثبّت الإصدارات بصرامة أكبر إن احتجت. تثبت هذه الوصفات كل إجراء على إصداره الرئيسي الحالي. ولنظافة أشد في سلسلة التوريد، ثبت كلا منها على تجزئة SHA كاملة لإيداع، ودع Dependabot يحدّثها.
  • اكسر كل بوابة مرة واحدة. احذف اختبارا، وأضف تبعية بترخيص GPL، وأودع مفتاحا مزيفا. وراقب كل مهمة وهي تتحول إلى الأحمر قبل أن تثق بالأخضر فيها.

نسخة AI CodeOps

لدى AI CodeOps بوابة إصدار خاصة به. وهي لا تقرأ ملف إعدادات في مستودعك. بل يطرح عليها CI لديك سؤالا واحدا عبر API، فتجيب انطلاقا من كل جلسة AI CodeOps مست التغيير: الملاحظات المفتوحة، وتشغيل الاختبار الخاص بالجلسة وتغطيته، والتراخيص في قائمة SBOM للمشروع، وأي مسارات سير عمل مطلوبة أو ترقيات بين البيئات.

release-gate:
  if: startsWith(github.head_ref, 'codeops/run-')
  runs-on: ubuntu-latest
  steps:
    - env:
        AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
        PR_URL: ${{ github.event.pull_request.html_url }}
        HEAD_SHA: ${{ github.event.pull_request.head.sha }}
      run: |
        body=$(jq -n --arg pr "$PR_URL" --arg sha "$HEAD_SHA" \
          '{pullRequestURL: $pr, commitSHA: $sha, blockingSeverity: "high", minCoveragePct: 80}')
        response=$(curl -sS --fail --retry 3 --max-time 30 -X POST \
          "https://console.aicodeops.dev/api/release/check" \
          -H "Authorization: Bearer $AICODEOPS_API_KEY" \
          -H "Content-Type: application/json" -d "$body") \
          || { echo "Release check unavailable: failing closed"; exit 1; }
        [ "$(echo "$response" | jq -r '.allowed')" = "true" ] \
          || { echo "$response" | jq -r '.summary, (.reasons // [])[]'; exit 1; }

الشرط if مهم. فـ AI CodeOps يفتح طلبات السحب الخاصة به من فروع codeops/run-<id>، والبوابة ترفض التغيير الذي لا جلسات AI CodeOps فيه، فتشغيلها على طلب سحب فتحه شخص سيفشل دائما. وتعيد نقطة النهاية رمز HTTP 200 في حالتي السماح والرفض، فتقرأ الخطوة قيمة allowed. والحقول موجودة في صفحة API.

وتنبيه واحد بشأن minCoveragePct. فهو يرفض التغيير الذي لم يبلغ تشغيل اختباره عن أي تغطية، لأن الحد الأدنى الذي لا يمكن فحصه لا ينجح. فإذا كانت منظومتك من التي لا تسجل فيها الجلسة أي تغطية، مثل JaCoCo أعلاه، فاحذف ذلك الحقل من جسم الطلب.

وتنبيهان إذا أضفت disallowedLicenses. المطابقة تامة، فلا يطابق GPL-3.0 المعرف GPL-3.0-only: اذكر كل صيغة كتابة تستخدمها قوائم SBOM لديك. والفحص يقرأ قائمة SBOM المسجلة للمشروع في AI CodeOps. فمع ضبط قاعدة للتراخيص وعدم تسجيل أي قائمة SBOM، ترفض البوابة، لأنها لا تستطيع الفحص.

والنصف الآخر هو سياسة مساحة العمل. فهذه القواعد تجعل أي تغيير من الذكاء الاصطناعي على الملفات التي تعرّف بواباتك ينتظر مراجعة موافقا عليها:

[
  { "id": "review-ci-definitions", "action": "diff.apply", "resource": ".github/**", "decision": "ask" },
  { "id": "review-secret-scan-config", "action": "diff.apply", "resource": ".gitleaks.toml", "decision": "ask" },
  { "id": "review-vitest-config", "action": "diff.apply", "resource": "**vitest.config.*", "decision": "ask" }
]

النمط ** يعبر المجلدات و * يبقى داخل مجلد واحد، فيطابق **vitest.config.* ملف الإعدادات في الجذر وفي كل حزمة. استخدم النصفين فوق البوابات العادية، لا بدلا منها. وإذا كنت تفضل البدء من سير عمل كامل، فإن القوالب تتضمن حدا أدنى للتغطية في Python وبوابة تراخيص قائمة على SBOM.

لديك منظومة فاتتنا؟

لغات PHP و Elixir و Kotlin مع Gradle و Swift هي الفجوات الواضحة. وسننشر الوصفات العشر كلها في مستودع بترخيص MIT، ونريد المزيد. فإذا كنت تشغل إحدى هذه المنظومات، ساهم بوصفة. وتحتاج إلى تشغيل أخضر وتشغيل أحمر دليلا، وتنسب المساهمة إليك برابط.

والقواعد التي تطبقها كل بوابة من جهة AI CodeOps، وطريقة فرز تغيير ممنوع، موجودة في وثائق بوابات الجودة.

أهم النقاط

  • لا تمنع البوابة الدمج إلا حين تصبح فحصا مطلوبا؛ وسير العمل الأحمر وحده مجرد نصيحة.
  • الإغلاق عند الخطأ: لا continue-on-error، ولا || true، وقائمة SBOM الفارغة أو رقم التغطية الذي تتعذر قراءته يفشلان.
  • أبق الحد الأدنى للتغطية في سير العمل، وضع .github/ تحت CODEOWNERS، فلا يستطيع التغيير الذي يخفض التغطية أن يخفض الحد الأدنى أيضا.
  • في المستودع الأحادي، اشترط مهمة أخيرة واحدة تقرأ كل نتيجة، لأن المهمة المتخطاة تحتسب ناجحة.
  • يسجل AI CodeOps تغطية الجلسة عددا صحيحا مقربا إلى الأدنى، فتفشل نسبة 79.6% أمام حد أدنى قدره 80.