jquery35-local-agent

बंद नेटवर्क में केवल Node.js से चलने वाला jQuery CVE-2020-11023 उपचार स्वचालन उपकरण (लेगेसी Java/Spring/JSP प्रोजेक्ट के लिए · npm install की आवश्यकता नहीं · इंटरनेट की आवश्यकता नहीं · बाहरी निर्भरता 0)

पुराने लेगेसी वेब (Spring/JSP श्रृंखला + jQuery 1.x) में jQuery को 3.5+ पर अपग्रेड करते समय आवश्यक पूरी प्रक्रिया को स्थानीय रूप से संभालता है: पूर्ण स्थैतिक विश्लेषण → सुरक्षित स्वचालित सुधार (TO-BE निर्माण) → jQuery 3.5.1 + Migrate प्रतिस्थापन → स्क्रीन के लिए Runtime Probe → mock Lab सर्वर → AI निर्णय पैक → संचालन में प्रतिबिंब से पहले गेट जाँच → रिपोर्ट।

विशेषताएँ

• मूल को अपरिवर्तित रखने का सिद्धांत — सभी परिवर्तन केवल --target TO-BE फ़ोल्डर में बनाए जाते हैं। report/index.html में फ़ाइल क्लिक पर AS-IS/TO-BE split diff देखकर पुष्टि के बाद लागू करें।
• झूठे धनात्मक कम करने वाला स्कैनर — साधारण regex नहीं, बल्कि टोकन मास्किंग (टिप्पणी/स्ट्रिंग/रेगुलर एक्सप्रेशन हटाना) + रिसीवर चेन बैकट्रेसिंग + कोष्ठक-संतुलन आर्ग्युमेंट पार्सर + फ़ाइल के भीतर taint ट्रैकिंग (ajax कॉलबैक पैरामीटर → DOM sink प्रोन्नति) + संपूर्ण प्रोजेक्ट कॉलसाइट प्रकार अनुमान (AutoInferred)।
• केवल सुरक्षित चीज़ों का स्वतः-सुधार — .bind→.on, .size()→.length, boolean .attr→.prop जैसे केवल वे पूर्ववर्ती परिवर्तन जो jQuery 1.x/3.x दोनों पर काम करते हैं। .html(response) जैसे XSS उम्मीदवारों को कभी भी स्वतः-सुधारा नहीं जाता, केवल वर्गीकृत किया जाता है।
• बंद नेटवर्क/पुराने वातावरण के लिए समर्थन — Edge IE mode (डेवलपर टूल्स प्रतिबंध) के लिए ES5 Runtime Probe, EUC-KR फ़ाइल बाइट संरक्षण (latin1 round-trip), npm के बिना सीधे CSV/XLS रिपोर्ट निर्माण।
• डिफ़ॉल्ट jQuery रनटाइम बंडल — patch-jquery jquery-3.5.1.min.js और jquery-migrate-3.6.0.min.js को TO-BE ट्री में स्वतः रखता है, इसलिए डिफ़ॉल्ट संयोजन अलग फ़ाइल तैयार किए बिना चलाया जा सकता है। अनकंप्रेस्ड jquery-migrate-3.6.0.js अस्थायी Tracing/debug के लिए साथ शामिल है।
• AI समीक्षा पैक (review-pack) — केवल अस्पष्ट कोड बिंदुओं (फ़ंक्शन नाम + आगे-पीछे की कुछ पंक्तियाँ, स्ट्रिंग/टिप्पणी/रेगुलर एक्सप्रेशन मास्क्ड) को चुनकर बाहरी AI के साथ बीस प्रश्न जैसे पुनरावृत्त सीखने का लूप। कंपनी-विशिष्ट साझा फ़ंक्शन (AJAX रैपर आदि) में से किसी एक की भूमिका जान लेने पर वह ज्ञान संपूर्ण कॉलसाइट पर प्रसारित हो जाता है। सीखा गया ज्ञान कभी भी स्वतः-सुधार ट्रिगर नहीं करता, केवल वर्गीकरण को प्रभावित करता है।
• Hermes स्थानीय निरीक्षण पैक (hermes-pack) — बाहरी AI प्रश्नों से अलग, प्रत्येक CASE के स्थिर सत्यापन बिंदु, स्थानीय Probe/Lab परीक्षण, पास/फ़ेल मानदंड, project-profile प्रतिबिंबन टेम्पलेट, CASE-वार मॉकिंग परीक्षण वेबपेज उत्पन्न करता है। बंद नेटवर्क के भीतर पुनरावृत्त निरीक्षण ज्ञान संचित करने के लिए घटक पैक।
• सार्वजनिक वितरण हेतु rulepack — वेबरूट उम्मीदवार, Probe इंसर्शन संकेत, वेंडर अनुशंसा, mock डिफ़ॉल्ट प्रतिक्रिया को rules/*.json में अलग किया गया। प्रत्येक वितरण स्थल पर JS कोड बदले बिना केवल रूलपैक बदलकर ट्यूनिंग करें।
• Java/Spring स्थिर प्रमाण — Spring चलाए बिना @RequestMapping श्रेणी और XML कॉन्फ़िगरेशन पढ़कर ajaxToServerMap.csv, serverEndpoints.csv, hermes_server_evidence.json उत्पन्न करता है और mock route में कंट्रोलर संकेत जोड़ता है।
• Runtime सत्यापन परिदृश्य — JSP/HTML के id/class/name/बटन टेक्स्ट को JS selector से मिलाकर, runtime_scenarios.html में 1-नेट code-only/static, 2-नेट Chrome smoke, Edge IE mode final sample सत्यापन व्यवहार उत्पन्न करता है।
• Runtime Parity विश्लेषण — Local Lab/mock परिणामों पर कहाँ तक भरोसा किया जा सकता है, इसे अलग करके LOCAL_LAB_OK, CHROME_SMOKE_REQUIRED, IE_FINAL_SAMPLE_REQUIRED लेन की रिपोर्ट करता है और runtime_parity.html, runtimeParity.csv, ieModeRisk.csv उत्पन्न करता है।
• वैकल्पिक Runtime Lab टेम्पलेट — public ZIP में Docker/JDK/Tomcat/WAR शामिल नहीं हैं, केवल runtime-lab/ स्कैफ़ोल्ड प्रदान किया जाता है जिससे Codex/स्थानीय PC पर WAR रखकर प्रयोग किया जा सके।
• Voyager/AI निर्णय कॉपी-पेस्ट पैकेट — CSV फ़ाइलें स्थानांतरित न कर पाने वाली बंद नेटवर्क स्थिति के लिए voyager_packet.txt में सारांश/परिदृश्य/selector/AJAX को संक्षिप्त करता है, और ai_verdict_packet.txt में 1000 अक्षरों से कम में "मानव निरीक्षण पर्याप्त/अतिरिक्त रनटाइम आवश्यक/IEDriver समीक्षा आवश्यक" निर्णय प्रश्न को संक्षिप्त करता है।
• बंद नेटवर्क वितरण आर्टिफ़ैक्ट — airgap_manifest.json/txt से निर्भरता-रहित/संचार-रहित प्रमाण छोड़ता है, और --mode release-zip से सार्वजनिक वितरण हेतु ZIP उत्पन्न करता है।
• स्थानीय वेब कंसोल — 실행0_웹대시보드.bat या --mode ui से ब्राउज़र में पथ Browse, स्वतः पथ गणना, plan/autofix/patch/Hermes/report पाइपलाइन, Local Lab, मौजूदा रिपोर्ट HTML खोलने को संभालता है।
• एग्रीगेशन/निरीक्षण डैशबोर्ड — index.html में पहले प्रकार-वार ग्राफ़ (event-shortcut-load आदि) और डायरेक्टरी depth-वार वितरण देखें, फ़ाइल पर क्लिक करने पर AS-IS/TO-BE के आसपास का कोड मोडल में तुलना करें।
• स्व-सत्यापन अंतर्निहित — --mode self-test एक अस्थायी नमूना प्रोजेक्ट बनाकर पूरे चक्र का सत्यापन करता है। v5.6.10 में source-only स्वचालित सेटिंग, S1~S11 वेब कंसोल चरण-नाम, पथ/प्रकार एग्रीगेशन, AS-IS/TO-BE पंक्ति-विराम संरक्षण स्वचालित सुधार, बंडल jQuery स्वचालित प्लेसमेंट, पुरानी core फ़ाइलों की सफ़ाई, UI तत्व-आधारित रनटाइम परिदृश्य, code-only/Chrome smoke/IE final sample Runtime Parity, और Voyager/AI निर्णय कॉपी-पेस्ट पैकेट निर्माण शामिल हैं।

त्वरित शुरुआत

node run-jquery35-v5.js --mode self-test

node run-jquery35-v5.js --mode ui --port 18088

node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode plan

ब्राउज़र कंसोल http://127.0.0.1:18088/ पर खुलता है। यहाँ केवल source Browse या दर्ज करने पर TO-BE/report/profile/server-source/verify-source के डिफ़ॉल्ट पथ स्वतः निर्धारित हो जाते हैं, और व्यक्तिगत S1~S11 चरणों या Pipeline के माध्यम से चलाया जा सकता है। यदि कमांड-आधारित तरीका सुविधाजनक हो, तो report\index.html डैशबोर्ड खोलकर स्थिति देखें, और README_FIRST.txt के क्रम (विश्लेषण → स्वतः-सुधार → jQuery प्रतिस्थापन → Probe → Lab → verify-clean) का पालन करें। Windows उपयोगकर्ता संलग्न 실행0_웹대시보드.bat ~ 실행9_배포ZIP생성.bat के केवल शीर्ष पथ को संशोधित करके चलाएँ।

सार्वजनिक वितरण/अन्य साइट पर लागू करते समय, project-profile.public.sample.json को कॉपी करके project-profile.json बनाएँ, और यदि आवश्यक हो तो केवल rules/public-defaults.json, rules/vendor-compat.json, rules/mock-defaults.json को संशोधित करें।

node run-jquery35-v5.js --report ".\release" --mode release-zip

दस्तावेज़

• README_KO.md — पूर्ण मैनुअल (निर्णय मानदंड, मोड विवरण, Git/CI फ़्लो, FAQ)
• VENDOR_COMPAT_KO.md — विक्रेता संगतता ब्रीफ़: jqGrid/jQuery UI/select2/autoNumeric के jQuery 3.x संगत संस्करण, jQuery UI के स्वयं के CVE, Migrate जिन व्यवहार परिवर्तनों को पुनर्स्थापित नहीं कर सकता (स्व-बंद टैग आदि)
• RUN_EXAMPLES_KO.txt — कमांड उदाहरणों का संग्रह
• README_FIRST.txt — त्वरित शुरुआत

दस्तावेज़ में सभी पथ (C:\work\legacy-app आदि) उदाहरण हैं। अपने वास्तविक प्रोजेक्ट पथ से बदलकर उपयोग करें।

आवश्यकताएँ

Node.js 16+ minimum, Node.js 18+ recommended. बस इतना ही।

लाइसेंस

MIT