इस प्रोजेक्ट के बारे में

Orbi एक स्वचालित प्रणाली है जो GitHub Issues को टैग किए गए रिलीज़ में बदलती है। यह एक Issue को क्लेम करती है, उसे एक अलग वर्कट्री में विकसित करती है, एक स्वतंत्र समीक्षा सत्र चलाती है, केवल समीक्षा किए गए हेड को मर्ज करती है, और एक रिलीज़ Issue के माध्यम से टैग प्रकाशित करती है। GitHub Issues एकमात्र स्टेट स्टोर के रूप में काम करते हैं—कोई डेटाबेस, क्यू या डेमन नहीं। मुख्य विशेषताएँ: - **GitHub Issues के माध्यम से टास्क पूल**: `ai-ready` लेबल काम भेजता है; डिलीवरी रिकॉर्ड (कमेंट, PR, CI) डिफ़ॉल्ट रूप से पूर्ण होते हैं। - **पूरी तरह स्वचालित**: एक उपयोगकर्ता शेड्यूलर टाइमर (Linux पर systemd, macOS पर launchd) हर 5 मिनट में एक टिक ट्रिगर करता है; किसी मैनुअल स्टेटस कमांड की आवश्यकता नहीं। - **स्वतंत्र समीक्षा + मर्ज गेट्स**: PR खुलने के बाद, एक स्वतंत्र समीक्षा सत्र निष्कर्षों को ठीक करता है; केवल समीक्षा किए गए हेड को ही मर्ज किया जा सकता है, और AI कभी भी संरक्षित ब्रांच को मर्ज या पुश नहीं करता। - **फेल फास्ट**: कमांड त्रुटियाँ तुरंत विफल होती हैं, साक्ष्य लॉग करती हैं, और मानव निर्णय के लिए Issue को `ai-blocked` चिह्नित करती हैं। - **एंड टू एंड अवलोकन योग्य**: प्रत्येक लॉग और GitHub कमेंट में पूरी टाइमलाइन पुनर्निर्माण के लिए समान `run_id` होता है। वर्कफ़्लो: GitHub Issue (ai-ready) → क्लेम (ब्रांच + वर्कट्री) → Pi विकास (योजना, कार्यान्वयन, परीक्षण, सत्यापन) → कमिट डिलीवरी → रनर क्लोज़आउट (सिंक, पुश, PR बनाएँ) → स्वतंत्र समीक्षा → मर्ज गेट → मर्ज। CLI कमांड में `orbi add` (काम भेजें), `status` (क्यू देखें), `session` (Pi सत्र का पालन करें), `install-units` (शेड्यूलर यूनिट इंस्टॉल करें), और `doctor` (रीड-ओनली डायग्नोस्टिक्स) शामिल हैं। इंस्टॉलेशन के लिए Python ≥ 3.14, `uv`, `pi` (एक प्रोवाइडर के साथ), GitHub CLI ≥ 2.94, और एक Linux systemd उपयोगकर्ता सत्र या macOS launchd GUI सत्र आवश्यक है। क्विक स्टार्ट: क्लोन करें, `uv tool install --force --reinstall --editable --python python3 .` के साथ इंस्टॉल करें, उदाहरण कॉन्फ़िग कॉपी करें, `orbi setup` चलाएँ, फिर मैनुअल टिक के लिए `python3 -m orbi.runner` चलाएँ, और स्वास्थ्य सत्यापित करने के लिए `orbi doctor` चलाएँ। दस्तावेज़ीकरण में शुरुआत करना, सेटअप, वर्कफ़्लो, संचालन, परीक्षण और योगदान शामिल हैं। यह प्रोजेक्ट Sustainable Use License (v1.0) के तहत फेयर-कोड लाइसेंस प्राप्त है: व्यक्तिगत और आंतरिक कंपनी उपयोग के लिए मुफ़्त, गैर-व्यावसायिक उद्देश्यों के लिए साझा करने योग्य, लेकिन व्यावसायिक प्राधिकरण केवल तब आवश्यक है जब Orbi को ही बेचा जाए (जैसे, सेवा के रूप में होस्ट करना)।