Bulut ajanları (cloud agents) vs Yerel terminal ajanları (local agents) مقارنة

// وكيل سحابي — إعداد بيئة GitHub Copilot cloud agent
// ملف سير العمل (workflow) هذا المُضاف إلى المستودع يحدد بأي تبعيات
// تُقام البيئة السحابية العابرة (ephemeral، المدعومة بـ GitHub Actions).
// مسار الملف: .github/workflows/copilot-setup-steps.yml
name: "Copilot Setup Steps"

on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  # اسم المهمة يجب أن يكون "copilot-setup-steps" —
  # يقوم cloud agent بتشغيل هذه المهمة تلقائيًا عند إقامة البيئة.
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v7
        with:
          node-version: "22"
          cache: "npm"

      - name: Install dependencies
        run: npm ci

      - name: Warm build cache
        run: npm run build --if-present

# وكيل طرفية محلي — العمل بآلة واحدة باستخدام Aider
# التثبيت بأمر واحد، البيئة هي جهازك؛ يوجد وصول مباشر
# إلى الشبكة الداخلية/localhost، ولا يغادر السر/الكود إلى الخارج.

# 1) التثبيت
python -m pip install aider-install
aider-install

# 2) إعداد دائم في جذر المشروع (.aider.conf.yml)
cat > .aider.conf.yml <<'CONF'
model: sonnet          # الاسم المستعار المدمج في aider (docs/config/model-aliases)
auto-commits: true
dark-mode: true
test-cmd: npm test
lint-cmd: npm run lint
CONF

# 3) التشغيل في الطرفية على ملفات محددة
# (متزامن، جلسة واحدة — جميع الفروقات (diffs) تظهر فورًا على الشاشة)
aider src/api/auth.ts src/api/session.ts \
  --message "أضف حد معدل (rate-limit) لتدوير رمز التحديث (refresh token)، وحدّث الاختبارات"

# 4) وصول مباشر إلى خدمة localhost في الشبكة الداخلية
# (لا حاجة لنفق/قائمة سماح إضافية — الوكيل يعمل داخل الصدفة الخاصة بك)
pg_isready -h localhost -p 5432 && aider --message "أضف فحص سلامة قاعدة البيانات (DB health check) إلى CI"