REA उन फ़ाइलों के आधार पर स्थानीय JavaScript या Electron ऐप का नक्शा बना सकता है जिन्हें देखने की आपको अनुमति है, भले ही आपके पास उसका स्रोत-वृक्ष न हो। उपयोगी परिणाम किसी एक व्यवहार के लिए प्रमाण की कड़ी है: कौन-सा मॉड्यूल उसे उपलब्ध कराता है, कॉल प्रक्रिया की सीमा कहाँ पार करता है और किन हिस्सों की अलग जाँच चाहिए। यह मार्गदर्शिका REA परियोजना के मौजूदा दस्तावेज़ का उपयोग करती है, जिसे 14 अक्टूबर 2026 को जाँचा गया था। BIG CHANGE ने किसी ऐप पर REA नहीं चलाया।

बड़ा बदलाव

  • क्या बदला: REA कोडिंग एजेंट को दिए गए ऐप डायरेक्टरी या ASAR से मॉड्यूल, इम्पोर्ट, सोर्स मैप, रूट और Electron IPC का व्यवस्थित नक्शा देता है। हर निष्कर्ष उन फ़ाइलों की ओर संकेत कर सकता है जिनसे वह निकला है।
  • यह क्यों मायने रखता है: किसी सुविधा की जाँच कर रहा डेवलपर, हाथ से क्या देखना है यह तय करने से पहले पैकेज किए गए ऐप में नामित API या IPC चैनल का अनुसरण कर सकता है। इससे सवाल सीमित होता है और प्रमाण जाँचना आसान होता है।
  • क्या ध्यान रखें: स्थिर कोड पथ केवल संभावित रास्ते हैं; वे इस बात का प्रमाण नहीं कि उपयोग के दौरान ऐप वही रास्ता अपनाता है। किसी खास व्यवहार के दावे के लिए अनुमति-प्राप्त लक्ष्य पर स्वतंत्र अवलोकन या परीक्षण अब भी ज़रूरी है।

शुरू करने से पहले

यह प्रक्रिया उस डेवलपर के लिए है जो स्थानीय JavaScript या Electron ऐप का मालिक है या उसकी जाँच की अनुमति रखता है। आपको निकाली गई ऐप डायरेक्टरी या उसकी app.asar फ़ाइल और उसका पूर्ण पथ चाहिए। REA का पैकेज मैनिफ़ेस्ट में rea-agents संस्करण 6.4.0 बताता है और Node.js 22.x श्रृंखला में 22.19 या नया, 24.x में 24.11 या नया, अथवा 26 और उसके बाद का संस्करण माँगता है। npm भी चाहिए। Linux पर REA के स्थिर JavaScript/Electron विश्लेषण के लिए procps-संगत ps भी आवश्यक है। REA के PATH प्रक्रिया-स्वामित्व जाँच के लिए, जैसा कि उसका इंस्टॉलेशन गाइड बताता है। ये REA होस्ट की आवश्यकताएँ हैं, लक्ष्य ऐप चलाने की आवश्यकताओं से अलग।

स्थिर JavaScript कार्यप्रवाह के लिए Hopper, Ghidra, IDA, ब्राउज़र या चलता हुआ Electron प्रोसेस आवश्यक नहीं है। वे उपकरण REA के अन्य कार्यप्रवाहों के लिए हैं। जाँचें कि लक्ष्य को देखने का अधिकार आपके पास है और मूल फ़ाइलों की प्रति रखें, ताकि ठीक-ठीक पता रहे कि परिणाम किस आर्टिफ़ैक्ट से आया। इंस्टॉलेशन के लिए आधिकारिक morluto/rea रिपॉज़िटरी या उससे जुड़े npm पैकेज का उपयोग करें; मिलता-जुलता नाम स्रोत की पुष्टि नहीं करता।

1. REA सेट करें या एक बार चलने वाला CLI उपयोग करें

कनेक्ट किए गए कोडिंग एजेंट के लिए दस्तावेज़ित सेटअप कमांड यह है:

Terminal
npx rea-agents setup

एजेंट कॉन्फ़िगरेशन में प्रस्तावित बदलावों की समीक्षा करें, इच्छित बदलावों को मंज़ूरी दें और एजेंट को फिर से शुरू करें। केवल टर्मिनल से निरीक्षण करना हो, तो नीचे दिया दस्तावेज़ित कमांड उस रन के लिए पैकेज चलाता है। @latest चलाने के समय उपलब्ध रिलीज़ चुनता है; आउटपुट बदल सकता है, इसलिए प्रमाण के साथ हल हुई संस्करण संख्या भी दर्ज करें। ऊपर का 6.4.0 वह संस्करण है जो इस लेख की 14 अक्टूबर की जाँच में परियोजना मैनिफ़ेस्ट में दिखा था।

2. दी गई फ़ाइलों का विश्लेषण करें

उदाहरण पथ की जगह अपने अधिकृत ऐप फ़ोल्डर या ASAR का पूर्ण पथ दें:

Terminal
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json > app-evidence.json

CLI मार्गदर्शिका चेतावनी देती है कि पूरा Evidence बहुत बड़ा हो सकता है। उसे फ़ाइल में सहेजें और फिर सारांश या चुने गए मॉड्यूल का दृश्य पढ़ें। पूरा परिणाम प्रॉम्प्ट में न चिपकाएँ। कमांड विफल हो तो निदान के लिए त्रुटि और लक्ष्य पथ सुरक्षित रखें; शून्य निकास-स्थिति के बावजूद कवरेज अधूरा, चेतावनियाँ या अनसुलझे निष्कर्ष हो सकते हैं। Windows के लिए README ऐसा पथ दिखाता है: "D:/apps/example".

आर्टिफ़ैक्ट पुनर्निर्माण संदर्भ के अनुसार यह प्रक्रिया ऐप चलाए बिना चुनी हुई फ़ाइलों को डेटा की तरह पढ़ती है। यह आर्टिफ़ैक्ट पथ और डाइजेस्ट सूचीबद्ध करती है, उपलब्ध JavaScript और TypeScript पढ़ती है और संभावित प्रवेश-बिंदु, इम्पोर्ट, सोर्स मैप, रूट, नेटवर्क एंडपॉइंट, Electron preload और renderer के संबंध, contextBridge API, IPC कॉल और हैंडलर तथा नेटिव ऐड-ऑन अनुरोध बताती है। अपेक्षित परिणाम ग्राफ़, स्थिर Electron सारांश, कवरेज और सीमाओं वाला Evidence रिकॉर्ड है। कोई .node बाइंडिंग जाँचने योग्य संबंध है; वह उस नेटिव मॉड्यूल का डिकोड किया हुआ रूप नहीं है।

3. एक सीमित फ़ीचर का पता लगाएँ

ऐसा फ़ीचर चुनें जिसका नाम खोज सकें, जैसे मेन्यू क्रिया या उपलब्ध API विधि। उपयोगकर्ता को दिखने वाला नाम दर्ज करें और REA के परिणाम में संबंधित मॉड्यूल, शाब्दिक IPC चैनल या रूट खोजें। बताई गई स्रोत स्थितियों का क्रम से अनुसरण करें: renderer या पेज कॉल, preload ब्रिज, IPC संचार, मेल खाता मुख्य-प्रोसेस हैंडलर, फिर वह फ़ाइल या सेवा क्रिया जिसे हैंडलर बुलाता है। REA का Electron CSV उदाहरण इस तरीके को notes.exportCsv(), notes:export चैनल और मुख्य-प्रोसेस लेखक है। ये उदाहरण ऐप के नाम हैं; आपके लक्ष्य के नाम अलग होंगे।

हर लिंक के लिए आर्टिफ़ैक्ट डाइजेस्ट, फ़ाइल पथ और स्थान तथा कोड वास्तव में क्या दिखाता है, दर्ज करें। किसी एक हैंडलर से जुड़े शाब्दिक चैनल और गणना किए गए चैनल या अस्पष्ट मेल में अंतर करें। किसी मॉड्यूल या हैंडलर को अनुपस्थित मानने से पहले कवरेज और सीमाओं वाले फ़ील्ड देखें। REA के अनुसार खराब या अनुपलब्ध फ़ाइलें, ASAR की सहायक बाइट्स का न होना, अनसुलझे एक्सप्रेशन और सीमित विश्लेषण संबंधों को अज्ञात छोड़ सकते हैं। सोर्स मैप मूल स्रोत के नाम दिखा सकता है, पर टूल मूल सोर्स ट्री देने का वादा नहीं करता।

4. व्यवहार की स्वतंत्र पुष्टि करें

स्थिर ट्रेस से एक ऐसा दावा लिखें जिसे गलत साबित किया जा सके, जैसे: “यह क्रिया इस चैनल को बुलाती है और हैंडलर इस प्रकार की फ़ाइल लिखता है।” फिर स्वीकृत परीक्षण वातावरण में केवल वही क्रिया करें और परिणाम सीधे देखें: बनी हुई फ़ाइल, बदली हुई स्थिति या अपने अधिकारों के भीतर एकत्र किया गया ट्रेस। ऐप संस्करण, आर्टिफ़ैक्ट डाइजेस्ट, परीक्षण के चरण और देखा गया परिणाम दर्ज करें। ऐप चलाने की अनुमति न हो तो दावा स्थिर कोड-पथ तक सीमित रखें। REA का उदाहरण स्पष्ट कहता है कि अनुमानित पथ को रनटाइम कैप्चर से जाँचा जा सकता है; स्थिर ग्राफ़ अकेले यह नहीं बताता कि कौन-सी शाखा चली।

आप तब सफल हुए जब दूसरा डेवलपर वही स्रोत स्थान पहचान सके, स्थिर मेल की सीमाएँ समझ सके और आपकी सीमित जाँच दोहरा सके। केवल विश्लेषण कमांड की सफलता रनटाइम व्यवहार की पुष्टि या ऐप के विश्वसनीय पुनर्निर्माण को साबित नहीं करती।

यदि परिणाम अधूरा हो

पहले जाँचें कि पथ पूरे निकाले गए डायरेक्टरी या ASAR की ओर जाता है और आवश्यक .asar.unpacked सहायक फ़ाइलें मौजूद हैं। REA की कवरेज और निदान देखें; स्रोत का गायब होना या विफल होना अज्ञात स्थिति है, नकारात्मक निष्कर्ष नहीं। बड़े ऐप के लिए संदर्भ में सटीक --source-path फ़ाइल चयन का तरीका बताया गया है, पर चुनी न गई फ़ाइलें विश्लेषण के दायरे से बाहर रहती हैं। IPC का शाब्दिक मेल अस्पष्ट हो या चैनल गणना से बने तो बताई गई फ़ाइलें देखें और प्रश्न सीमित करें। अस्पष्टता बनी रहे तो अंतिम टिप्पणियों में रखें।

REA का कोड MIT लाइसेंस के अंतर्गत है, लेकिन लक्ष्य सॉफ़्टवेयर और बाहरी विश्लेषण इंजन के अपने लाइसेंस व शर्तें हैं। स्थिर विश्लेषण लक्ष्य फ़ाइलों को स्थानीय रूप से संसाधित करता है। REA के निष्कर्ष किसी कोडिंग एजेंट को देने पर मॉडल प्रदाता की डेटा नीति लागू होगी; संगठन की अनुमति से पहले गोपनीय जानकारी या निजी आउटपुट न भेजें। उपयोग से पहले अपने एजेंट और वैकल्पिक इंजन की शर्तें व लागत जाँचें। प्रक्रिया और पैकेज संस्करण की जाँच 14 अक्टूबर 2026 को हुई और यह दस्तावेज़ों पर आधारित है।