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

magus ایک بلڈ سسٹم اور ٹاسک آرکیسٹریٹر ہے جو پولیگلاٹ مونوریپوز کے لیے ڈیزائن کیا گیا ہے۔ یہ ایک واحد اسٹیٹک طور پر لنک شدہ Go بائنری کے طور پر آتا ہے جس میں انسٹال کرنے کے لیے کوئی دوسرا ٹول چین نہیں ہے۔ اہداف Buzz میں لکھے جاتے ہیں، جو بائنری میں سرایت شدہ ایک چھوٹی ٹائپ شدہ اسکرپٹنگ زبان ہے، اور انہیں `magusfile.buzz` میں ایکسپورٹ شدہ فنکشنز کے طور پر ڈکلیئر کیا جاتا ہے۔ اہم خصوصیات میں شامل ہیں: - **متاثرہ سیٹس**: پروجیکٹس اور فائل لیول ان پٹ ڈکلیئریشنز کا ایک ڈیپنڈنسی گراف `magus affected <target>` کو صرف ان پروجیکٹس کو چلانے دیتا ہے جن تک کوئی تبدیلی پہنچ سکتی ہے، ڈیپنڈنسی ترتیب میں۔ یہ CI کے کام کو صرف اس تک محدود کرتا ہے جسے ایک ڈف واقعی چھوتا ہے۔ - **مواد سے پتہ چلنے والی کیشنگ**: ہر ہدف اپنے ان پٹس اور آؤٹ پٹس ڈکلیئر کرتا ہے۔ magus ان پٹس کو ہیش کرتا ہے اور جب وہی کام دوبارہ درخواست کیا جاتا ہے تو محفوظ شدہ آؤٹ پٹس (SHA-256) کو دوبارہ چلاتا ہے، بائٹ بہ بائٹ یکساں نتائج پیدا کرتا ہے۔ - **نالج گراف**: ڈکلیئر شدہ ذرائع (magusfile، docs، SCIP انڈیکس، git ہسٹری، CODEOWNERS) سے بنایا گیا، نہ کہ کسی بیرونی انڈیکسر سے اخذ کیا گیا۔ یہ `magus query "kind=target lint"`، `magus explain <node>`، اور `magus refs <symbol>` جیسے سوالات کے جوابات دیتا ہے۔ گراف بلڈز کے لیے سورس آف ٹروتھ ہونے کا ایک ضمنی نتیجہ ہے۔ - **ایک ذخیرہ الفاظ**: اہداف، اسپیلز (زبان کے اڈاپٹرز)، چارمز (`rw` جیسے موڈیفائرز برائے ریڈ-رائٹ)، اور اوپس (ٹول کی درخواستیں) ایک بار نامزد کیے جاتے ہیں اور CLI، کنفگ، اور گراف میں دوبارہ استعمال ہوتے ہیں۔ - **ٹرمینل UI**: ٹرمینل کے نچلے حصے میں ایک پن شدہ پروگریس بینڈ جو اسکرول بیک کو صاف نہیں کرتا، پروجیکٹ کے لحاظ سے گروپ بند ناکامی کے درختوں اور گراف-سرچ پکر کے ساتھ۔ تمام سطحیں ٹرمینل کے بغیر سادہ متن میں تبدیل ہو جاتی ہیں۔ - **براؤزر کنسول**: اختیاری ریڈ-اونلی ویب ایپس (ڈیش بورڈ، گراف ایکسپلورر، لاگ ویور، ایکٹیویٹی ٹریل، ڈف) جو ڈیمون لوپ بیک پر پیش کرتا ہے، بائنری میں کوئی سرایت شدہ UI نہیں۔ ڈیٹا کبھی مشین نہیں چھوڑتا۔ - **ایجنٹ انٹیگریشن**: Codex اور Claude Code کے لیے انسٹال کے قابل اسکلز، نیز ایک کمٹ شدہ `MAGUS.md` روٹنگ انڈیکس، AI ایجنٹس کو گراف سے سوال کرنے اور اہداف کو ڈیٹرمینیٹک طریقے سے چلانے دیتے ہیں۔ آرکیٹیکچر: ایک ڈیمون (`magus server start`) مقامی CLI ڈسپیچ کے لیے ایک Unix ساکٹ اور MCP، ریڈ-اونلی API، اور Connect سروسز کے لیے ایک HTTP سرور ظاہر کرتا ہے، سب ایک گارڈ چین (DNS-ری بائنڈ چیک، بیئرر ٹوکن، CORS) کے پیچھے۔ ہیلتھ اینڈ پوائنٹس غیر محفوظ ہیں۔ ایک ٹائم باکسڈ LAN لسنر ایک ریڈ-اونلی کنسول فون تک شیئر کر سکتا ہے۔ غیر اہداف: کوئی ریموٹ ایگزیکیوشن نہیں، کوئی ٹول چین مینجمنٹ نہیں، کوئی ہرمیٹک سینڈ باکس نہیں (ڈیفالٹ طور پر بند، macOS پر کوئی کرنل لیئر نہیں)، کوئی کنٹینر آئسولیشن نہیں، اور ایک چھوٹا ایکو سسٹم (نیا پروجیکٹ، زیادہ تر ایک شخص کا کام)۔ شروع کرنا: ایک curl اسکرپٹ کے ذریعے انسٹال کریں (چلانے سے پہلے جائزہ لیں)، پھر بلڈ، ٹیسٹ، لنٹ وغیرہ کے لیے ایکسپورٹ شدہ فنکشنز کے ساتھ ایک `magusfile.buzz` لکھیں۔ `magus ls`، `magus run test`، `magus affected ci`، اور `magus query` جیسے کمانڈز فوری جوابات فراہم کرتے ہیں۔