منصوبے کے بارے میں

Orbi ایک خودکار نظام ہے جو GitHub Issues کو ٹیگ شدہ ریلیز میں تبدیل کرتا ہے۔ یہ ایک Issueclaim کرتا ہے، اسے الگ تھلگ ورک ٹری میں تیار کرتا ہے، ایک آزاد جائزہ سیشن چلاتا ہے، صرف جائزہ شدہ head کو مرج کرتا ہے، اور ریلیز Issue کے ذریعے ٹیگ شائع کرتا ہے۔ GitHub Issues واحد اسٹیٹ اسٹور کے طور پر کام کرتے ہیں—کوئی ڈیٹا بیس، قطار، یا ڈیمون نہیں۔ اہم خصوصیات: - **GitHub Issues کے ذریعے ٹاسک پول**: `ai-ready` لیبل کام بھیجتا ہے؛ ڈیلیوری ریکارڈز (کمنٹس، PRs، CI) بطور ڈیفالٹ مکمل ہوتے ہیں۔ - **مکمل خودکار**: ایک صارف شیڈولر ٹائمر (لینکس پر systemd، macOS پر launchd) ہر 5 منٹ میں ایک ٹک متحرک کرتا ہے؛ کوئی دستی اسٹیٹس کمانڈز کی ضرورت نہیں۔ - **آزاد جائزہ + مرج گیٹس**: PR کھلنے کے بعد، ایک آزاد جائزہ سیشن نتائج کو ٹھیک کرتا ہے؛ صرف جائزہ شدہ head ہی مرج ہو سکتا ہے، اور AI کبھی بھی محفوظ برانچز کو مرج یا پش نہیں کرتا۔ - **فوری ناکامی**: کمانڈ کی غلطیاں فوراً ناکام ہوتی ہیں، ثبوت لاگ کرتی ہیں، اور انسانی فیصلے کے لیے Issue کو `ai-blocked` نشان زد کرتی ہیں۔ - **شروع سے آخر تک قابل مشاہدہ**: ہر لاگ اور GitHub کمنٹ ایک ہی `run_id` رکھتا ہے تاکہ مکمل ٹائم لائن دوبارہ بنائی جا سکے۔ ورک فلو: GitHub Issue (ai-ready) → Claim (برانچ + ورک ٹری) → Pi ڈیولپمنٹ (منصوبہ، نفاذ، ٹیسٹ، تصدیق) → Commit ڈیلیوری → رنر کلوز آؤٹ (سنک، پش، PR بنائیں) → آزاد جائزہ → مرج گیٹ → مرج۔ CLI کمانڈز میں `orbi add` (کام بھیجیں)، `status` (قطار دیکھیں)، `session` (Pi سیشن کی پیروی کریں)، `install-units` (شیڈولر یونٹس انسٹال کریں)، اور `doctor` (صرف پڑھنے والی تشخیص) شامل ہیں۔ انسٹالیشن کے لیے Python ≥ 3.14، `uv`، `pi` (ایک پرووائیڈر کے ساتھ)، GitHub CLI ≥ 2.94، اور لینکس 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) کے تحت fair-code لائسنس یافتہ ہے: ذاتی اور اندرونی کمپنی کے استعمال کے لیے مفت، غیر تجارتی مقاصد کے لیے قابل اشتراک، لیکن تجارتی اجازت صرف اس صورت میں درکار ہے جب Orbi خود فروخت کیا جائے (مثلاً بطور سروس ہوسٹ کرنا)۔