Kapalı kaynaklı bir masaüstü uygulamasının milisaniye altı yerel arama indeksini nasıl kurduğunu, bir Electron paketinin preload katmanından ana sürece hangi IPC kanallarını açtığını veya derlenmiş bir ikili dosyanın ağ imzalama mantığını anlamaya çalıştığınızda, asıl darboğaz nadiren tek bir aracın eksikliğidir. Gerçek zaman kaybı; Ghidra sembol tabloları, Hopper sözde kod pencereleri, JADX sınıf ağaçları ve HAR ağ kayıtları arasında bağlam taşırken oluşur. GitHub üzerinde kısa sürede 466.000'i aşkın yıldız toplayan morluto/rea (REA — Reverse Engineer Anything), tam olarak bu orkestrasyon kopukluğunu gidermek üzere tasarlanmış bir mühendislik katmanıdır.
REA (rea-agents), MIT lisanslı açık kaynaklı bir komut satırı aracı (CLI) ve Model Context Protocol (MCP) sunucusudur (io.github.morluto/rea). Tek başına kapalı kodları sihirli biçimde kıran bir decompiler olmak yerine; Claude Code, Cursor, Codex ve Gemini CLI gibi kodlama ajanlarını yerel statik analiz işçilerine, Ghidra, Hopper, IDA Pro, Kuna ve JADX gibi endüstri standardı tersine mühendislik motorlarına bağlayarak kanıt, belirsizlik sınırı ve sözde kod üretir.
Yönetici Özeti ve Mimari Çıkarımlar
- Sihirli Klonlama Değil, Kanıt Tabanlı MCP Orkestrasyonu: REA; ikili dosyaları,
.asararşivlerini ve derlemeleri yerel makinenizde inceler, fonksiyon referanslarını kanıtlarıyla (evidence) haritalandırır ve ajanın bu bulgular üzerinden temiz bir yeniden uygulama yazmasını sağlar. - Bağlam Penceresi (Context) Disiplini: Kompakt giriş şeması profili ve 4.096 baytlık çıkış şeması bütçesi (
REA_MCP_OUTPUT_SCHEMA_PROFILE=compact) sayesinde büyük ikili analizlerde LLM jeton (token) taşmasını önler; komut çıktılarını 4 MiB sınırında tutar. - Kurumsal Savunma Zorunluluğu: İstemci tarafına gönderilen Electron
.asarpaketleri, kaynak haritaları (source maps) ve gizlenmemiş API uç noktaları artık dakikalar içinde haritalanabilmektedir; kritik iş kuralları sunucu tarafında izole edilmelidir.
Kurumsal ürün ekiplerinde kurumsal yapay zekâ çözümleri ve ajan tabanlı geliştirme hatları yaygınlaştıkça, hem mevcut eski (legacy) ikili sistemlerin belgelenmesi hem de dışa açılan istemci paketlerinin güvenlik denetimi özel yazılım geliştirme süreçlerinin doğrudan bir parçası haline gelmiştir. Bu rehberde REA'nın resmi v6.9.0 mimarisini, kurulum adımlarını, CI/CD maruziyet denetimini ve kurumsal güvenlik etkilerini birincil kaynak verileriyle inceliyoruz.
1. REA Mimarisinin Çekirdeği: Decompiler Değil, Kanıt Tabanlı MCP Köprüsü
Sosyal medyadaki yüzeysel paylaşımların aksine REA, sıfırdan özel mülkiyetli kaynak kodu "halüsinasyonla tahmin eden" bir araç değildir. Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 çalışma zamanı üzerinde saf ESM ("type": "module") yapısıyla çalışan sistem, ajanın doğal dildeki araştırma sorusunu deterministik analiz adımlarına böler.

Bağlam Bütçesi ve Şema Sıkıştırma Tasarımı
Standart bir tersine mühendislik aracının ham sembol tablosunu doğrudan bir dil modeline göndermek, birkaç çağrı içinde yüz binlerce jetonluk bağlam penceresini doldurur. REA resmi dokümantasyonu bu darboğazı üç mimari mekanizmayla çözer:
- Kompakt Giriş Şeması Profili: MCP sunucusu
tools/listaşamasında gereksiz şema şişkinliğini atarak kompakt giriş şemaları yayınlar; buna karşın sunucu tarafında kanonik tip ve parametre doğrulamasını eksiksiz korur. - Sıfır Varsayılan Çıkış Şeması Yükü: Model API'leri çıkış şemalarını doğrudan okumadığı için REA varsayılan olarak bunları
tools/listyanıtından çıkarır ve her sonucu kendi içinde doğrular. İhtiyaç halindeREA_MCP_OUTPUT_SCHEMA_PROFILE=compactortam değişkeni ile her çıkış şeması 4.096 bayt bütçesiyle sınırlandırılabilir. - İzole İşçi Süreçleri ve 4 MiB Çıktı Tavanı: JavaScript ve web paket analizleri ana süreci bloklamamak için ayrı işçi süreçlerinde (
#javascript-analysis-workerve#web-bundle-analysis-worker) yürütülür; güncelleyici ve alt komut çıktıları terminal geri basıncına (backpressure) uyarak en fazla 4 MiBstdout/stderrtutar.
2. Kurulum, Ortam Hazırlığı ve Doğrudan CLI İş Akışları
REA hem yapay zekâ ajanınıza MCP sunucusu olarak bağlanabilir hem de doğrudan terminalden tekil komutlarla çalıştırılabilir. Linux ortamlarında Ghidra, JADX ve statik Electron analizlerinin süreç sahipliğini doğrulayabilmesi için procps uyumlu sistem ps aracının kurulu olması gerekir.
Adım 1: Ajan Entegrasyonu ve Otomatik Kurulum
Node.js (22.23.4+) ve npm kurulu bir iş istasyonunda hedef projenin dışındaki güvenilir bir dizinden kurulum sihirbazı başlatılır:
# Ajanları algılar, mevcut ayarların yedeğini alır ve MCP sunucusunu kaydeder
npx rea-agents setup
# Düzenli terminal kullanımı için global CLI kurulumu
npm install --global rea-agents
# Bağlı decompiler ve sağlayıcıların sağlık kontrolü
rea doctor --json
# Global kurulumu doğrulanmış akışla güncelleme
rea update
Kurulum sihirbazı Claude Code, Cursor, Codex, Gemini CLI ve Grok Build yapılandırmalarını otomatik tanır; değişiklikleri uygulamadan önce onayınıza sunar ve mevcut yapılandırma dosyalarını yedekler. İşlem tamamlandığında ajanınızı yeniden başlatmanız yeterlidir.
Adım 2: Harici Motor Gerektirmeyen Statik JS / Electron Analizi ve CI Denetimi
Paketlenmiş bir Electron uygulamasını (.asar) veya web paketini incelemek için Ghidra ya da IDA Pro kurulumuna ihtiyaç yoktur. Aşağıdaki üretim tipi TypeScript örneği, dağıtım öncesinde kendi masaüstü veya web paketinizin dışarıya sızdırdığı kaynak haritalarını, IPC sınırlarını ve iç rotaları otomatik denetleyen bir CI/CD kontrol kapısını göstermektedir:
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import path from "node:path";
const execFileAsync = promisify(execFile);
export interface ReaJsModuleFinding {
readonly modulePath: string;
readonly imports: readonly string[];
readonly ipcChannels: readonly string[];
readonly hasSourceMap: boolean;
}
export interface ReaJsAnalysisReport {
readonly targetPath: string;
readonly electronBoundaries: readonly string[];
readonly modules: readonly ReaJsModuleFinding[];
readonly limitations: readonly string[];
}
export async function runReaBundleExposureGate(
rawAppDirectory: string,
): Promise<{ passed: boolean; violations: string[]; report: ReaJsAnalysisReport }> {
const resolvedTarget = path.resolve(rawAppDirectory);
const { stdout } = await execFileAsync(
"npx",
["-y", "rea-agents@latest", "analyze-javascript-application", resolvedTarget, "--json"],
{
timeout: 120_000,
maxBuffer: 4 * 1024 * 1024, // REA 4 MiB tanı tavanıyla uyumlu tampon
windowsHide: true,
},
);
const report = JSON.parse(stdout) as ReaJsAnalysisReport;
const violations: string[] = [];
for (const mod of report.modules) {
if (mod.hasSourceMap) {
violations.push(`Üretim paketinde açık source map tespit edildi: ${mod.modulePath}`);
}
}
return {
passed: violations.length === 0,
violations,
report,
};
}
3. İncelenebilen Hedef Katmanlar: Statik Analizden Native Binary ve RL Ortamlarına
REA v6.9.0 sürümü itibarıyla 30'dan fazla ikili ve çalışma zamanı formatını tek bir kanıt şemasında birleştirir:
A. Harici Decompiler Gerektirmeyen Yerleşik Statik Analizler
Uygulamayı hiç çalıştırmadan (sıfır kod yürütme riskiyle) doğrudan dosya başlıkları ve bayt dizilimleri üzerinden çalışan modüllerdir:
- JavaScript, Web ve Electron: Modül grafikleri,
source mapkalıntıları, yönlendirme tabloları,preloadveIPCsınırları, yerel eklentiler (native add-ons) verea audit-release-exposureyayın sızıntısı taraması. - Derlenmiş Modern Diller (Go, Rust, .NET, Deno, PyInstaller): Go ikili dosyalarında gömülü derleyici sürümü ve modül değişimleri; Rust derlemelerinde
cargo-auditablebağımlılık ağacı;.NETderlemelerinde CIL talimatları; PyInstallerCArchiveiçerikleri veDeno compilesanal dosya sistemleri. - Oyun Motorları, Yapay Zekâ Modelleri ve İkili Sertleştirme: Unity
IL2CPP(global-metadata.datsürüm 24, 27, 29, 31 ve 39), GodotPCKarşivleri,GGUFvesafetensorstensör başlıkları, CUDA/HIP/PTX GPU nesneleri, Windows PEAuthenticode(PKCS#7/X.509) imzaları ve ELF/PE/Mach-O güvenlik bayrakları (PIE,NX,RELRO,CFG).
B. Derin Native Decompiler Köprüleri
C, C++ veya assembly düzeyinde kontrol akışı ve sözde kod gerektiğinde REA; sisteminizde kurulu olan Hopper (hopper_bridge.py), Ghidra (ReaGhidraBridge.java — 16-bit DOS, MIPS ve RISC-V çağrı kuralları dahil), IDA Pro, Kuna, Cutter/Rizin ve JEB (REA_JEB_MCP_URL) motorlarını köprüler. Büyük ikili dosyalarda başlatma zaman aşımı REA_GHIDRA_STARTUP_TIMEOUT_MS veya REA_HOPPER_STARTUP_TIMEOUT_MS ile esnetilebilir.
C. Mobil, Firmware, Ağ Kayıtları ve Pekiştirmeli Öğrenme (RL) Ortam Sentezi
Headless JADX, ADB ve Apktool ile Android APK ve cihaz incelemesi; Binwalk / Unblob ile firmware bölge çıkarımı; WABT ile WebAssembly (inspect_wasm_artifact); evmole ile çevrimdışı EVM akıllı kontrat seçici analizi desteklenir. Ayrıca kaydedilmiş bir tarayıcı HAR oturumunu alıp rea environment-build ./session.har ./my-env --name my-env --json komutuyla yapay zekâ ajanlarının orijinal uygulamayı çalıştırmadan üzerinde görev pratiği yapabileceği deterministik bir AgentEnv (RL) ortamına dönüştürebilir.
4. Karşılaştırmalı Mimari Matris: Geleneksel Süreç vs. REA Orkestrasyonu
| Değerlendirme Kriteri | Geleneksel Manuel Tersine Mühendislik | Ham LLM Kopyala-Yapıştır Yaklaşımı | REA (MCP + Kanıt Tabanlı Orkestrasyon) |
|---|---|---|---|
| Araçlar Arası Bağlam Geçişi | Analist Ghidra, JADX, HAR ve terminal arasında manuel veri taşır | Geliştirici parçalı decompile çıktılarını sohbet penceresine elle yapıştırır | Ajan, tek MCP protokolü üzerinden 30+ hedef aracını doğrudan sorgular |
| Halüsinasyon ve Kanıt Kontrolü | Yüksek doğruluk ancak tamamen insan hızına bağımlı | Eksik bağlamda uydurma fonksiyon mantığı üretme riski yüksek | Her bulgu sembol, ofset, referans kanıtı ve bilinen sınırlarla (limitations) döner |
| Token ve Bağlam Maliyeti | Model kullanılmaz | Ham çıktılar bağlam penceresini hızla taşırır | Kompakt giriş şeması + 4.096 bayt çıkış profili + 4 MiB çıktı sınırı |
| Electron / JS Sızıntı Denetimi | Manuel asar extract ve tek tek dosya taraması | Büyük bundle dosyalarını tek seferde okuyamaz | İzole işçi süreçleriyle modül, IPC ve audit-release-exposure haritası çıkarır |
| RL ve Ajan Test Ortamı Üretimi | Sıfırdan sahte (mock) API sunucusu kodlamayı gerektirir | Desteklemez | HAR kayıtlarından doğrulanmış AgentEnv görev ortamı dışa aktarır |
5. Doğrulanmış Saha Örnekleri: DX-Ball, Notion IPC Köprüsü ve 16-Bit Rekonstrüksiyon
REA'nın resmi vitrininde yer alan üç doğrulanmış vaka çalışması, aracın "kodu sihirli biçimde kopyalamak" yerine kanıt tabanlı yeniden inşa için nasıl çalıştığını somut biçimde gösterir:
- DX-Ball Ses Konumlandırma (Sound-Pan) Hesabı: Orijinal x86 ikili dosyasındaki ses çağrısı takip edilerek eksik sözde kod C diline dönüştürülmüş; üretilen fonksiyon 3.205 orijinal x86 test vakasını eksiksiz geçmiş ve derlenmiş 63 fonksiyon baytının tamamını birebir yeniden üretmiştir.
- Notion Masaüstü Pano (Clipboard) Köprüsü: Electron
renderersürecindeki pano API'sinden başlanarakpreloadbetiği veIPCkanalları üzerindenmainsürecine uzanan zengin pano veri formatı uçtan uca haritalandırılmıştır. - TH04 (PC-98) 16-Bit Mermi Halkası Matematiği: Klasik PC-98 oyununun 16-bit DOS talimatları incelenerek sabit ve hedefli açı hesaplamaları C++ dilinde yeniden kurulmuş ve tarihsel derleyici çıktısıyla doğrulanmıştır.
6. Kopyala-Yapıştır Hazır REA Ajan Prompt Şablonları
Kurulum (npx rea-agents setup) tamamlandıktan sonra Claude Code, Cursor veya Gemini CLI içinde doğrudan kullanabileceğiniz dört kanıt odaklı inceleme şablonu aşağıdadır. Pazarlama ve reklam verilerinde MCP protokolünün nasıl çalıştığını görmek için kardeş rehberimiz olan Claude ve Meta Ads MCP Entegrasyonu yazısını da inceleyebilirsiniz.
# 1. Electron (.asar) Preload ve IPC Güvenlik Sınırı Haritalama
REA kullanarak /mutlak/yol/app.asar paketini statik olarak incele.
Renderer sürecinden preload ve ipcMain katmanına açılan tüm IPC kanallarını,
parametre doğrulaması eksik uçları ve kalmış source map dosyalarını kanıtlarıyla listele.
# 2. Native İkili Dosyada Algoritma ve Çağrı Grafiği Çıkarımı (Ghidra / Hopper)
REA üzerinden /mutlak/yol/hedef-binary dosyasındaki paket imzalama veya sıkıştırma
fonksiyonunu bul. Sembol adreslerini, çağıran/çağrılan fonksiyon zincirini, sözde kodu
ve belirsiz kalan sınırları (limitations) raporla; ardından eşdeğer TypeScript testini yaz.
# 3. Android APK İmza (v1-v3.1) ve Ağ Uç Noktası Denetimi
REA ile /mutlak/yol/uygulama.apk dosyasının sertifika zincirini (inspect_apk_signature)
ve JADX üzerinden dışarıya açılan HTTPS/gRPC istemci sınıflarını çıkar.
# 4. Kaydedilmiş HAR Oturumundan Deterministik AgentEnv (RL) Ortamı Üretimi
REA kullanarak ./oturum.har kaydından ./test-env klasörüne çalıştırılabilir bir AgentEnv
ortamı oluştur; hangi API işlemlerinin doğrulandığını ve nasıl test edileceğini özetle.
7. Sık Karşılaşılan Kurulum Hataları ve Sorun Giderme (rea doctor)
Sahada rea doctor --json çıktısında en sık karşılaşılan dört yapılandırma engeli ve kök çözümleri şunlardır:
- macOS Hopper İlk Çalıştırma Penceresi Kilidi: macOS üzerinde Hopper ilk kez açıldığında lisans veya demo modu seçimi isteyen grafiksel bir onay penceresi çıkarır. Otomatik MCP görevlerinden önce Hopper'ı aynı kullanıcı oturumunda bir kez manuel açıp bu pencereyi onaylayın.
- Linux
procpsSüreç Sahipliği Hatası: Minimal Docker konteynerlerinde veya kırpılmış Linux dağıtımlarındapskomutubusyboxtabanlıysa Ghidra, JADX ve statik Electron işçileri süreç sahipliği kontrolünde durur;apt install procpsile tam uyumlupspaketini yükleyin. - Büyük İkili Dosyalarda Başlatma Zaman Aşımı: Yüzlerce megabaytlık C++, Rust veya Unity ikililerinde ilk sembol indekslemesi varsayılan süreyi aşabilir. Ortam değişkeni olarak
REA_GHIDRA_STARTUP_TIMEOUT_MS=300000veyaREA_HOPPER_STARTUP_TIMEOUT_MS=180000tanımlayarak süreyi uzatın. - Windows Üzerinde Ghidra Sağlayıcı Tanımlaması: Windows x64 ortamında tam JDK kurulumunun
JAVA_HOMEile eşleştiğinden emin olun verea doctor --jsonile sağlayıcı yolunu doğrulayın.
Kaynak Kodlu AST Analizi ile REA İkili Analizi Arasındaki Fark
Kaynak koduna zaten sahip olduğunuz projelerde mimari bağımlılıkları taramak için deterministik AST bilgi grafikleri çok daha düşük maliyetlidir; REA ise kaynak kodunun bulunmadığı derlenmiş ikili dosyalar, üçüncü parti .asar paketleri ve üretim sızıntı denetimleri için tasarlanmıştır. Sitenizin yapay zekâ yanıt motorlarındaki görünürlüğünü ölçmek için AI ve GEO Arama Denetimi aracımızı kullanabilirsiniz.
8. Kurumsal Güvenlik ve Savunma Mimarisi: İstemci Tarafı Kodunuz Artık Şeffaf
REA gibi ajan destekli analiz çerçevelerinin yükselişi, hem aracı kullanan geliştiriciler hem de ticari yazılım üreten kurumlar için kritik güvenlik sorumlulukları doğurur.
Tedarik Zinciri, Lisans ve Veri Gizliliği Uyarısı
- Taklit Depolara Karşı Resmi Kaynak Kontrolü: Popüler tersine mühendislik araçlarının isimlerini taklit eden zararlı paketlere karşı kurulumu yalnızca resmi
github.com/morluto/rea,rea.toolsve npm üzerindekirea-agentspaketinden yapın. - Yerel Analiz vs. Model Sağlayıcı Politikası: REA ikili dosyalarınızı kendi sunucularına yüklemez; tüm analiz yerel makinede çalışır. Ancak MCP araçlarının döndürdüğü sözde kod ve dizgiler bağlı olduğunuz yapay zekâ model sağlayıcısına iletilir; hassas kurumsal ikililerde veri saklama politikası kısıtlı kurumsal uç noktalar kullanılmalıdır.
- Ticari Lisans ve Yasal Kapsam: IDA Pro, Hopper ve JEB gibi ticari motorlar geçerli kullanıcı lisansı gerektirir; REA yalnızca yasal birlikte çalışabilirlik, güvenlik araştırması ve yetkili olunan yazılımların analizi içindir.

Yazılım Üreticileri ve CTO'lar İçin 3 Savunma Kuralı
Bir geliştiricinin tek bir npx rea-agents komutuyla Electron paketinizi, mobil APK dosyanızı veya istemci JavaScript yığınınızı dakikalar içinde haritalandırabildiği bir ortamda "karmaşıklaştırma yoluyla güvenlik" (security through obscurity) tamamen geçerliliğini yitirmiştir:
- Üretim Paketlerinde Sıfır Source Map ve Anahtar Kuralı: CI/CD boru hattınızda
source mapdosyalarını genel dağıtımdan ayırın; üçüncü parti API anahtarlarını veya gizli yönlendirme kurallarını asla istemci paketine gömmeyin. - Sıfır Güven (Zero-Trust) IPC ve API Doğrulaması: Electron
contextBridge/ipcMainişleyicilerinde ve web API uç noktalarında istemciden gelen her parametreyi şema doğrulamasından geçirin; yetki kontrolünü arayüzde değil sunucu çekirdeğinde uygulayın. - Ticari Algoritmaların Sunucu Tarafı İzolasyonu: Fiyatlandırma motorları, kredi/risk skorlama algoritmaları ve çok kiracılı veri filtreleri istemci ikilisinde değil, yüksek güvenlikli arka uç mikroservislerinde çalıştırılmalıdır.
Kurumsal Mimari Denetim ve Güvenli Sistem Tasarımı
Mevcut masaüstü/web uygulamalarınızın istemci sızıntı yüzeyini kapatmak, Sıfır Güven API sınırları kurgulamak veya kurum içi güvenli MCP ajan iş akışları inşa etmek için proje maliyet hesaplayıcı aracımızla kapsam oluşturabilir ya da doğrudan Kling Digital mühendislik ekibiyle iletişime geçebilirsiniz.




