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

Adrastea ایک MIT لائسنس یافتہ پایتھون پروجیکٹ (3.10+) ہے جو آٹونومس ٹاسک آرکیسٹریشن کے لیے "سمبائیوٹک ڈویل انجین" آرکیٹیکچر کا تصور پیش کرتا ہے۔ اس کا مرکزی خیال کام کو قابلِ پیش گوئی ایگزیکیشن تہہ اور منطق کی تہہ کے درمیان تقسیم کرنا ہے، جو صرف تب مداخلت کرتی ہے جب کچھ غلط ہو جائے۔ **سسٹم Alpha — فیصلہ کن ایگزیکشن انجین** Alpha کے طور پر بیان کیا جاتا ہے جو پہلے شروع ہوتا ہے۔ یہ لائف سائیکل اور بوٹ اسٹریپ کو سنوارتا ہے، پھر Beta کو سپاون کرنے سے پہلے اپنے ماحول کو تصدیق اور مستحکم کرتا ہے۔ اس کی ذمہ داریوں میں مقامی اسکرپٹس، بائنریز اور ٹاسک تعریفات کو بھیجنے والا ایک ٹاسک شیڈیولر شامل ہے، نیز ایک لوکل پروگرام رنر جو معیاری I/O، ایرر لاگنگ اور پروسس لائف ٹائم کو منتظم بناتا ہے جس میں قابلِ بحالی ایگزیکشن پر زور دیا گیا ہے۔ ایک RL پلانر ٹاسک ترتیبات کی رہنمائی سکورنگ فنکشنز کے ذریعے کرتا ہے جو لیٹنسی، ایکزٹ کوڈز، ریسورس استعمال اور آؤٹ پٹ درستگی جیسے نتائج سے منسلک ہیں، اور تاریخ اور ٹیون شدہ وزن کی بنیاد پر ایگزیکشن برانچز منتخب کرنے کے لیے پیٹھ فائنڈنگ ہیورسٹکس استعمال کرتا ہے۔ Alpha مقامی انفرانس رئٹائم (Ollama `http://127.0.0.1:11434` پر) سے بھی جڑا ہوا ہے تاکہ آفس لائن، کم اوور ہیڈ آپریشنز جیسے پارسنگ، فارمیٹ استخراج اور بنیادی ٹیکسٹ تجزیہ انجام دیے جا سکیں۔ **سسٹم Beta — احتمالی فیصلہ اور منطق انجین** Beta Alpha کے استحکام کے بعد سپاون ہوتا ہے اور غیر فیصلہ کن مسائل کے لیے فیصلے کی تہہ کے طور پر کام کرتا ہے۔ یہ Alpha کی ٹیلی میٹری، ہیلتھ میٹرکس اور ٹاسک کی پیش رفت کی نگرانی کرتا ہے، اور جب Alpha کسی ناقابلِ علاج ایکسیپشن، ماحولیاتی انحراف، بار بار ناکامی کی حالتوں یا ایگزیکشن لوپ سے جڑتا ہے تو قدم اٹھاتا ہے۔ Beta Alpha کے RL پلانر میں استعمال ہونے والے ریوارڈ اور پینلٹی وزن کی ٹیوننگ کی بھی ذمہ دار ہے، مؤثر طریقے سے ایگزیکشن کو زیادہ پیداواری راستوں کی طرف موڑ دیتا ہے۔ Beta چار بتائی گئی حالتوں کے ساتھ ایک آٹونومس لوپ چلاتا ہے: آئیڈل/مشاہدہ (غیر فعال نگرانی)، ٹرائیج اور انسٹک (بلکنگ شرائط کا تشخص)، آپٹمائز (مکمل ہونے والے ایگزیکشن راستوں سے اضافت کو ہٹانا)، اور ڈسکور اور انوویشن (نئے ٹاسک ترتیبات اور اہداف کی فرضیہ سازی)۔ یہ بیرونی ٹولز اور لائیو سیاق و سباق کے لیے MCP سرورز کے ساتھ مربوط ہوتا ہے، اور گہری منطق، حکمت عملی فیصلوں، کوڈ جنریشن اور ٹربل شوٹنگ کے لیے فرنٹیئر یا بیرونی LLMs سے رجوع کر سکتا ہے۔ **آئی پی سی کے ذریعے پروسیس رابطہ** Alpha اور Beta ہم وقت پروسیسس کے طور پر چلتے ہیں اور ڈومین ساکٹس، نیمڈ پایپس یا میسج بس جیسے کم لیٹنسی بائی ڈائریکشنل چینل پر کمپیکٹ JSON یا پروٹوکول بفر انویلیپس منتقل کرتے ہیں۔ دستاویز کردہ کنٹرول سگنلز میں `SIG_SPAWN`، `SIG_HEARTBEAT`، `SIG_SLEEP`، `SIG_WAKE`، `SIG_TELEMETRY`، `SIG_STUCK`، `SIG_INTERRUPT`، `SIG_DISPATCH`، `SIG_MUTATE` اور `SIG_TUNE_WEIGHTS` شامل ہیں۔ یہ مل کر پروسیس بوٹ اسٹریپ، لائیونیس پنگ، سلپ/ویک ٹرانزیشنز، آؤٹ پٹ رپورٹنگ، اسٹک اسٹیٹ نوٹیفیکیشن، ٹاسک ایبورشن، کوئو انجیکشن، فلائٹ میں پیرامیٹر میوٹیشن اور RL وزن اپڈیٹس کو کور کرتے ہیں۔ **کیپ علیپ اور لمبے سلپ موڈ** ایک `KeepAliveProcess` کوآرڈینیٹر سسٹم کو طویل عرصے تک سونے دیتا ہے تاکہ CPU، میموری اور ٹوکن استعمال کو کم کیا جا سکے جبکہ Alpha کا IPC TCP سرور `127.0.0.1:8765` پر، کلینٹ چینلز اور `DIRECTIVES.txt` واچرز فعال رہیں۔ ہیٹ بیٹ، ویکی، سلپ اور ڈسپیچ کے لیے سگنل راؤٹنگ تیزی سے ردعمل ظاہر کرنے کے لیے ہے، بیگزائیک Beta سبرو سیسز اور ٹاسک رنرز کو سپروائزڈ رکھا جاتا ہے اور اگر وہ بغیر توقع کے ختم ہو جائیں تو دوبارہ زندہ کیا جاتا ہے، اور آنے والے ڈائریکٹوز یا ڈسپیچ سگنل سلپ ٹائمر کا انتظار کرنے کے بجائے سسٹم کو فوراً جاگاتے ہیں۔ **CLI** ریڈمی میں `python -m adrastea.cli keepalive --sleep-interval 300`، `ping`، `sleep --duration 600` اور `wake` جیسے کمینڈز کی دستاویز کی گئی ہیں۔ بیان کردہ ضروریات میں مقامی Ollama سرور (ایسے ماڈلز کے ساتھ جیسے `qwen3-coder:30b` یا ہلکے انسٹرکشن ماڈلز)، MCP کلینٹ ترتیب، PowerShell، Bash، Python یا Node جیسے مقامی ایگزیکشن رئٹائم، اور ایک ایسنکروس کراس پروسیس ٹرانسپورٹ شامل ہے۔ نوٹ کریں کہ ریڈمی آرکیٹیکچرل نیت کی وضاحت کرتا ہے اور "بنیادی" کیپ علیپ الفاظ شامل کرتا ہے؛ کوئی بینچ مارک یا کارکردگی کے اعداد و شمار فراہم نہیں کیے گئے ہیں، اس لیے بیان کردہ رویوں کو پروجیکٹ کے ڈیزائن اہداف کے طور پر سمجھا جانا چاہیے نہ کہ ناپے ہوئے نتائج کے طور پر۔ شراکت کا خیر مقدم `main` کے خلاف فورک، فیچر برانچ اور پل ریکویسٹ کے ذریعے کیا جاتا ہے۔