عن المشروع

Orbi نظام آلي يحوّل قضايا GitHub إلى إصدارات موسومة. يطالب النظام بالقضية، ويطورها في مساحة عمل معزولة، ويشغّل جلسة مراجعة مستقلة، ولا يدمج إلا الرأس الذي تمت مراجعته، ثم ينشر الوسم عبر قضية إصدار. تعمل قضايا GitHub كمخزن الحالة الوحيد—بدون قاعدة بيانات أو طابور انتظار أو شيطان تشغيل. الميزات الرئيسية: - **مجموعة المهام عبر قضايا GitHub**: يُرسل تسمية `ai-ready` العمل؛ وسجلات التسليم (التعليقات، طلبات السحب، CI) مكتملة افتراضياً. - **أتمتة كاملة**: مؤجد مستخدم (systemd على Linux، launchd على macOS) يشغّل نبضة كل 5 دقائق؛ لا حاجة لأوامر حالة يدوية. - **مراجعة مستقلة + بوابات الدمج**: بعد فتح طلب سحب، تصلح جلسة المراجعة المستقلة النتائج؛ يمكن فقط دمج الرأس المُراجع، ولا يقوم الذكاء الاصطناعي أبداً بالدمج أو الدفع إلى الفروع المحمية. - **فشل سريع**: أخطاء الأوامر تفشل فوراً، وتسجل الأدلة، وتضع علامة `ai-blocked` على القضية لقرار بشري. - **قابلية مراقبة من البداية للنهاية**: يحمل كل سجل وكل تعليق على GitHub نفس المعرف `run_id` لإعادة بناء الخط الزمني بالكامل. سير العمل: قضية GitHub (ai-ready) ← المطالبة (فرع + مساحة عمل) ← تطوير Pi (تخطيط، تنفيذ، اختبار، تحقق) ← تسليم الالتزامات ← إغلاق المشغل (مزامنة، دفع، إنشاء طلب سحب) ← مراجعة مستقلة ← بوابة الدمج ← الدمج. تشمل أوامر سطر الأوامر `orbi add` (إرسال العمل)، و`status` (عرض الطابور)، و`session` (متابعة جلسة Pi)، و`install-units` (تثبيت وحدات المؤجد)، و`doctor` (تشخيص للقراءة فقط). يتطلب التثبيت Python ≥ 3.14، و`uv`، و`pi` (مع مزود خدمة)، وGitHub CLI ≥ 2.94، وجلسة مستخدم systemd على Linux أو جلسة رسومية launchd على macOS. البدء السريع: استنساخ المشروع، والتثبيت باستخدام `uv tool install --force --reinstall --editable --python python3 .`، ونسخ ملف الإعداد النموذجي، وتشغيل `orbi setup`، ثم `python3 -m orbi.runner` لنبضة يدوية، وأخيراً `orbi doctor` للتحقق من الصحة. تغطي الوثائق البدء والإعداد وسير العمل والعمليات والاختبار والمساهمة. المشروع مرخص بموجب رخصة الاستخدام المستدام (v1.0): مجاني للاستخدام الشخصي والداخلي للشركة، وقابل للمشاركة للأغراض غير التجارية، لكن يتطلب إذناً تجارياً فقط إذا تم بيع Orbi نفسه (مثل استضافته كخدمة).