re-agent reverse --class CTrain
    │
    ├── التكوين (re-agent.yaml + env + CLI)
    │   └── project_profile (stub_markers, hook_patterns, source_layout)
    │
    ├── المُنسّق (منفرد / مشغل صف)
    │   ├── منتقي الدوال (يرتب حسب عدد المستدعين، يصفى المكتملة)
    │   ├── جامع السياق (تفكيك + مراجع متقاطعة + هياكل + استرجاع المصدر)
    │   │
    │   ├── حلقة الوكيل (عكسي → مدقق → إصلاح، بحد أقصى N جولة)
    │   │   ├── مزودو LLM: Claude | واجهات برمجة متوافقة مع OpenAI | CLI Codex
    │   │   └── قوالب الأوامر (ملفات .md قابلة للتخصيص)
    │   │
    │   ├── مُدقق الأهداف (فحوصات عدد الاستدعاءات وسلامة تدفق التحكم)
    │   │
    │   ├── محرك التكافؤ (بوابة تحقق أخضر/أصفر/أحمر)
    │   │   ├── مفهرس المصدر (محلل جسم C++)
    │   │   ├── 11 إشارة استدلالية (قابلة للتكوين والتبديل)
    │   │   └── قواعد دلالية + موافقات يدوية
    │   │
    │   └── حالة الجلسة (ملف تقدّم JSON)
    │
    └── النظام الخلفي للهندسة العكسية: ghidra-ai-bridge
        └── أعلام القدرة → تدهور سلس

pip install auto-re-agent

# 1. تهيئة تكوين المشروع
re-agent init

# 2. تحرير re-agent.yaml بإعدادات مشروعك

# 3. عكس دالة واحدة
re-agent reverse --address 0x6F86A0

# 4. عكس جميع دوال صف
re-agent reverse --class CTrain --max-functions 10

# 5. تشغيل فحوص التكافؤ
re-agent parity --address 0x6F86A0

# 6. التحقق من التقدم
re-agent status

llm:
  provider: claude           # claude | openai | openai-compat | codex
  model: claude-sonnet-4-5-20250929
  # api_key: يتم تعيينه عبر متغير البيئة RE_AGENT_LLM_API_KEY
  timeout_s: 1800

backend:
  type: ghidra-bridge
  cli_path: ~/ghidra-tools/ghidra

orchestrator:
  max_review_rounds: 4
  max_functions_per_class: 10
  objective_verifier_enabled: true

project_profile:
  source_root: ./source/game_sa
  hook_patterns:
    - 'RH_ScopedInstall\s*\(\s*(\w+)\s*,\s*(0x[0-9A-Fa-f]+)'
  stub_markers: ["NOTSA_UNREACHABLE"]
  stub_call_prefix: "plugin::Call"

git clone https://github.com/dryxio/auto-re-agent.git
cd auto-re-agent
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

pytest tests/
ruff check src/
mypy src/re_agent/