यह कैसे काम करता है

RADAR कैसे काम करता है।

डेवलपर्स के लिए एक तकनीकी परिचय। RADAR कोडिंग एजेंटों को चलाता है और किसी कार्य को तभी बंद करता है जब वह उस कार्य का स्वीकृति परीक्षण खुद दोबारा चला ले। एजेंट का “पूरा हुआ” एक दावा है; दोबारा चलाना प्रमाण है।

01 लूप

हर कार्य के लिए एक ही लूप।

हर कार्य एक ही लूप से गुज़रता है, और हर चरण तभी चलता है जब उससे पहले वाला चरण पास हो गया हो।

01 · खोलना कार्य और स्वीकृति परीक्षण काम शुरू होने से पहले लिखा गया
02 · लीज़ एक मालिक, अपना worktree लीज़ और fence token
03 · काम एजेंट काम करता है प्रोजेक्ट की अपनी अलग कॉपी में
04 · दावा एजेंट कहता है, पूरा हुआ नतीजे के रूप में नहीं, दावे के रूप में दर्ज
05 · जाँच RADAR परीक्षण दोबारा चलाता है मौजूदा रिविज़न पर
पास होने पर बंद प्रमाण लेजर में रखा जाता है
फेल होने पर · प्रयास n / 3 फिर से खुला, विफलता साथ में वही एजेंट चरण 03 से फिर कोशिश करता है
3 प्रयासों के बाद दूसरा एजेंट काम सँभालता है चरण 03 से, 3 और प्रयासों तक
3 और के बाद कार्य आपका इंतज़ार करता है लेजर आगे के प्रयास अस्वीकार करता है

चित्र 1 · कार्य लूप। दावा दोबारा चलाने तक पहुँचता है, कभी सीधे बंद होने तक नहीं।

खोलना: कार्य उसके लक्ष्य और दोबारा चलाई जा सकने वाली स्वीकृति कमांड के साथ खोला जाता है। कार्य खोलते समय कमांड की जाँच होती है, उसे चलाए बिना: जो मानदंड लिखे हुए रूप में चल नहीं सकता, उसे उसी समय अस्वीकार कर दिया जाता है, अंत में जाकर उसका पता नहीं चलता।
लीज़: एक समय में एक ही मालिक किसी कार्य को रखता है, एक लीज़ और एक fence token के ज़रिए। पुराने पड़ चुके मालिक का write अस्वीकार कर दिया जाता है।
काम: एजेंट अपने git worktree में, अपनी ब्रांच पर काम करता है।
दावा: एजेंट की यह रिपोर्ट कि काम पूरा हो गया, एक दावे के रूप में दर्ज होती है। दावे से कार्य बंद नहीं होता।
जाँच: RADAR स्वीकृति कमांड खुद चलाता है, काम के मौजूदा रिविज़न पर। एजेंट की अपनी रिपोर्ट पढ़ी जाती है, लेकिन वह प्रमाण नहीं है।
बंद करना या फिर से खोलना: पास होने पर कार्य बंद हो सकता है, और जाँच का रिकॉर्ड उसके प्रमाण के रूप में रखा जाता है। फेल होने पर कार्य विफलता के ब्योरे के साथ फिर से खुल जाता है।
सीमाएँ: वर्कर के तीन प्रयास, फिर दूसरे एजेंट द्वारा तीन बार काम सँभालना। उसके बाद लेजर और प्रयास अस्वीकार करता है और कार्य आपका इंतज़ार करता है। मॉडल, सेशन या मशीन बदलने से गिनती रीसेट नहीं होती, और हर दोबारा प्रयास में बताना होता है कि क्या बदला।

02 लेजर

एक रिकॉर्ड, जिसमें हर एजेंट लिखता है।

हर एजेंट एक ही कार्य लेजर को पढ़ता है और उसी में लिखता है: एक लोकल SQLite फ़ाइल। यही एकमात्र रिकॉर्ड है कि हर कार्य किसके पास है, क्या दावा किया गया और परीक्षण ने क्या दिखाया।

कार्य: लक्ष्य और स्वीकृति कमांड, काम शुरू होने से पहले लिखे गए।
स्वामित्व: हर कार्य का मौजूदा मालिक, उसकी लीज़ और fence token के साथ।
प्रयास: हर कार्य के लिए गिने जाते हैं, सभी एजेंटों, मॉडलों और मशीनों को मिलाकर।
दावे: एजेंट की यह रिपोर्ट कि काम पूरा हो गया, नतीजों से अलग रखी जाती है।
जाँच रिकॉर्ड: हर स्वीकृति रन, उस commit और working tree से बँधा हुआ जिस पर वह चला।
बदलाव: बदली गई स्वीकृति कमांड पुराने और नए संस्करण के साथ दर्ज की जाती है; ओवरराइड भी दर्ज किया जाता है।

दावे से कार्य बंद क्यों नहीं होता

कार्य बंद करने का गेट एक पास हुए जाँच रिकॉर्ड पर टिका है, प्रमाण के किसी एक वाक्य पर नहीं। रिकॉर्ड में वह commit दर्ज होता है जिस पर रन हुआ, और ट्रैक किए गए working tree का एक digest। अगर रन के बाद इनमें से कोई भी बदल गया हो, उदाहरण के लिए परीक्षण पास होने के बाद कोई फ़ाइल संपादित की गई हो, तो जाँच दोबारा चलने तक कार्य बंद करना अस्वीकार रहता है। कोई व्यक्ति इस गेट को ओवरराइड कर सकता है, और यह ओवरराइड भी दर्ज होता है।

स्मृति

निर्णय और सबक Markdown नोट्स होते हैं, जिनमें स्रोत और दायरा लिखा होता है। एक लोकल इंडेक्स उन्हें ऑफ़लाइन खोजता है, और एक hook किसी एजेंट के कुछ करने से पहले मेल खाने वाले नोट्स उसके सामने रख देता है। नोट्स सादे Markdown में हैं, इसलिए आप उन्हें Obsidian में खोल सकते हैं।

03 आइसोलेशन

हर प्रयास अपनी अलग कॉपी में।

हर प्रयास अपने git worktree में, अपनी ब्रांच पर काम करता है। दो वर्कर कभी एक ही tree साझा नहीं करते।
वर्कर अपनी स्वीकृति कमांड दोबारा नहीं लिख सकता। इसे केवल मैनेजर बदल सकता है, और केवल कार्य बंद होने से पहले; हर बदलाव में पुराना और नया संस्करण दोनों रखे जाते हैं।
काम आपकी main ब्रांच तक तभी पहुँचता है जब जाँच पास हो जाए, और merge के बाद स्वीकृति कमांड एक बार और चलती है।
force push हर भूमिका के लिए अस्वीकार किए जाते हैं।
ये नियम कोड के रूप में चलते हैं, मॉडल को कॉल करने से पहले और बाद में। ये प्रॉम्प्ट नहीं हैं, इसलिए कोई एजेंट बातों से इन्हें पार नहीं कर सकता।

04 एजेंट

वही एजेंट जिन्हें आप पहले से इस्तेमाल करते हैं।

RADAR Claude Code, Codex CLI, OMP और Hermes Agent को चलाता है, आपके कंप्यूटर पर या आपके अपने Linux सर्वरों पर। यह उनकी जगह नहीं लेता: काम अब भी वही करते हैं।

Claude Code
Codex CLI
OMP
Hermes Agent

एक अनुबंध: वही नियम, वही लेजर, वही जाँच गेट और वही प्रयास सीमाएँ चारों पर लागू होती हैं।
मैनेजर: जिस एजेंट से आप बात करते हैं, वही प्रबंधन करता है: वह कार्य खोलता है, उन्हें वर्करों को सौंपता है और किसी कार्य को केवल पास हुए जाँच रिकॉर्ड के साथ बंद करता है।
वर्कर: वर्कर अपने-अपने worktree में काम करते हैं। वे कार्य बंद नहीं कर सकते और अपनी स्वीकृति कमांड नहीं बदल सकते।

05 लोकल फ़र्स्ट

लोकल फ़र्स्ट।

RADAR को न खाते की ज़रूरत है, न क्लाउड की।

आपकी मशीन पर: लेजर, स्मृति नोट्स, worktree और हर जाँच रन, आपके कंप्यूटर पर या आपके अपने Linux सर्वरों पर।
नेटवर्क की ज़रूरत: आपके एजेंट, जो आज की तरह ही अपने-अपने प्रदाताओं से बात करते हैं। बाकी हर बाहरी सेवा वैकल्पिक है और तब तक बंद रहती है जब तक आप उसे चालू न करें।
आवश्यकताएँ: Windows या Linux (macOS अभी समर्थित नहीं है), Python 3.12 या नया संस्करण, और Git। RADAR केवल Python स्टैंडर्ड लाइब्रेरी का उपयोग करता है।
लागत: इसका अपना कोई बिल नहीं। एजेंट उन्हीं खातों का उपयोग करते रहते हैं जिनसे आप उनमें साइन इन करते हैं। सशुल्क API का उपयोग तभी होता है जब आप प्रदाता और बजट तय करें।
इंस्टॉल: अपने कोडिंग एजेंट को रिपॉज़िटरी का लिंक दें और कहें “इसे इंस्टॉल करो”। वह आपके कंप्यूटर की जाँच करता है, कोई भी कमी वाली चीज़ इंस्टॉल करने से पहले पूछता है, RADAR को एक वर्चुअल एनवायरनमेंट में इंस्टॉल करता है और बताता है कि radar init और radar doctor क्या कहते हैं।

06 कमांड

कमांड की एक छोटी सूची।

वे कमांड जिनका आप सबसे पहले इस्तेमाल करेंगे। प्लेसहोल्डर एंगल ब्रैकेट में हैं।

कमांड	यह क्या करता है
`radar init`	RADAR का होम और लेजर सेट अप करता है।
`radar doctor`	इंस्टॉल की जाँच करता है और ऐसी वैकल्पिक सेवाओं की सूची देता है जो अभी कॉन्फ़िगर नहीं हैं।
`radar task new --project P --goal "…" --accept "<command>"`	एक कार्य उसकी स्वीकृति कमांड के साथ खोलता है।
`radar dispatch <task>`	कार्य किसी एजेंट को सौंपता है, जो अपने worktree में काम करता है।
`radar status`	पूरा सिस्टम दिखाता है।
`radar verify <task>`	मौजूदा रिविज़न पर स्वीकृति कमांड दोबारा चलाता है।
`radar task done <task> --evidence "<verification report>"`	कार्य बंद करता है। जाँच पास होने तक अस्वीकार किया जाता है।
`radar collect`	पूरा हुआ काम इकट्ठा करता है।
`radar integrate`	जाँचा हुआ काम main में merge करता है।
`radar stop`	काम को रोककर रखता है और STOP सेट करता है।
`radar go`	STOP हटाता है और बताता है कि क्या आगे चल सकता है।
`radar memory search --local "<words>"`	स्मृति नोट्स को ऑफ़लाइन खोजता है।
`radar uiradar web`	कॉकपिट को टर्मिनल या ब्राउज़र में खोलता है।
`radar help --all`	हर कमांड की सूची देता है। radar <command> -h विवरण देता है।

07 यह क्या नहीं करता

RADAR क्या नहीं करता।

यह आपके एजेंटों की जगह नहीं लेता। कोड अब भी वही लिखते हैं; RADAR उन्हें एक रिकॉर्ड, एक ऐसी जाँच जिसे वे छोड़ नहीं सकते, और एक स्मृति देता है।
यह आपके परीक्षण नहीं लिखता। कोई जाँच उतनी ही अच्छी होती है जितना उसका परीक्षण; RADAR काम शुरू होने से पहले परीक्षण को स्पष्ट रूप से लिखवाता है, ताकि कोई व्यक्ति उसे पढ़ सके।
यह बिना परीक्षण वाले काम को बंद नहीं करता। जिस कार्य में चलाने योग्य स्वीकृति कमांड नहीं है, उसे खोलते समय ही अस्वीकार कर दिया जाता है।
यह आपके एजेंटों को ऑफ़लाइन नहीं रखता। वे आज की तरह ही अपने-अपने प्रदाताओं से बात करते रहते हैं।
ओपन संस्करण व्यक्तिगत डेवलपर्स के लिए है, टीमों के लिए नहीं; कंपनी संस्करण विकास में है।

08 स्थिति

शुरुआती एक्सेस में

अभी शुरुआती एक्सेस। सार्वजनिक रिलीज़ पर ओपन सोर्स।

RADAR शुरुआती एक्सेस में है। सार्वजनिक रिलीज़ पर इसे Apache-2.0 लाइसेंस के तहत ओपन सोर्स के रूप में प्रकाशित किया जाएगा। जुड़ने के लिए हमें लिखें।

शुरुआती एक्सेस से जुड़ें RADAR पर वापस जाएँ