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

لوکی موڈ ایک خودمختار، مقامی طور پر چلنے والی سافٹ ویئر فیکٹری ہے جو AI ایجنٹ کے تکمیل کے دعووں کی تصدیق کے لیے ڈیزائن کی گئی ہے، بجائے اس کے کہ 'مکمل' حیثیت کو سطحی طور پر قبول کرے۔ بنیادی ورک فلو ان پٹس کو قبول کرتا ہے جن میں پروڈکٹ ریکوائرمنٹ دستاویزات، GitHub ایشوز، OpenAPI تفصیلات، یا ایک لائن کے مختصر ٹاسک بریفز شامل ہیں۔ جب کوئی ان پٹ دیا جاتا ہے، تو نظام سب سے پہلے درخواست کردہ کام کے لیے ایک باقاعدہ ڈیلیوری کنٹریکٹ (قبولیت کے معیار) اخذ کرتا ہے؛ اگر کنٹریکٹ قابل اعتماد طریقے سے اخذ نہ کیا جا سکے، تو یہ بغیر رہنمائی کے اندازوں کے بجائے ایک وضاحتی سوال پوچھنے کے لیے رک جاتا ہے۔ کام کنٹریکٹ کے مطابق ایک منظم Reason, Act, Reflect, Verify لوپ کے ذریعے بنایا جاتا ہے، اور اختتام پر ایک Evidence Receipt پیش کرتا ہے جو واضح طور پر دستاویز کرتا ہے کہ تعمیر کے عمل کے دوران کیا ثابت ہوا اور کیا غیر ثابت رہا۔ ایک کلیدی جزو، loki-seal، ایک Claude Code Stop hook کے طور پر کام کرتا ہے: جب بھی کوئی منسلک AI ایجنٹ کام کو مکمل نشان زد کرنے کی کوشش کرتا ہے، ہک ہدف ریپوزٹری کا حقیقی ٹیسٹ سوٹ چلاتا ہے۔ یہ تکمیل کو روکتا ہے اگر نئے ٹیسٹ ناکامیاں پائی جائیں، یا اگر موجودہ ٹیسٹس یا CI کنفیگریشن حذف، چھوڑے، یا جان بوجھ کر کمزور کیے گئے ہوں۔ ہک ہر اسٹاپ کوشش پر ایک واضح Seal فیصلہ جاری کرتا ہے: یا تو ایک PASS نتیجہ کے ساتھ ایک باقاعدہ رسید، یا مسترد ہونے کی دستاویزی وجہ کے ساتھ ایک بلاک۔ نظام بڑے AI کوڈنگ ٹولز کے ساتھ مربوط ہے، جس میں Claude Code کے لیے مکمل سپورٹ، نیز Cline، OpenAI Codex CLI، Aider، اور OpenCode کے ساتھ مطابقت شامل ہے۔ یہ مکمل طور پر صارف کی مقامی مشین پر ان کی اپنی موجودہ LLM API کیز کا استعمال کرتے ہوئے چلتا ہے، بغیر کسی لازمی ہوسٹڈ سروس کی ضرورت کے۔ اس سے پہلے کہ کوئی تعمیر مکمل نشان زد ہو، ایک بلٹ ان ریویو کونسل قابل ترتیب پول سے ماہر جائزہ لینے والوں کا انتخاب کرتی ہے، جائزہ لینے والے کے انتخاب کو فوکس کلیدی لفظ کی مماثلت سے اسکور کیا جاتا ہے۔ ایک بنڈل MCP سرور stdio کے ذریعے 36 ٹولز کو بے نقاب کرتا ہے تاکہ ایجنٹ کی صلاحیتوں کو بڑھایا جا سکے۔ تنصیب کے اختیارات میں عالمی npm یا bun پیکیج انسٹالز شامل ہیں، پہلی بار استعمال کرنے والوں کے لیے ایک رہنمائی شدہ کوئیک اسٹارٹ فلو کے ساتھ۔ صارفین براہ راست مقامی PRD فائل سے، یا لنک شدہ GitHub ریپوزٹری ایشو سے تعمیرات شروع کر سکتے ہیں۔ ایک زیرو کی ری پلے ٹور دستیاب ہے تاکہ API رسائی کی ضرورت کے بغیر Evidence Receipt فلو کا مظاہرہ کیا جا سکے، اور ایک ریڈ اونلی براؤن فیلڈ موڈ موجودہ ریپوزٹریز کے ساتھ استعمال کی حمایت کرتا ہے۔ ایک آپٹ ان پیش نظارہ Loki 10 انجن ماحولیاتی متغیر کنفیگریشن کے ذریعے دستیاب ہے۔ اضافی دستاویزات متبادل تنصیب کے طریقوں (Bun, npm, Homebrew, Docker)، CLI حوالہ، کنفیگریشن کے اختیارات، نظام کی ساخت، کوالٹی گیٹس، میموری کی خصوصیات، ڈیش بورڈ کی فعالیت، اور ملتے جلتے ڈویلپمنٹ ٹولز سے موازنہ کا احاطہ کرتی ہیں۔ پروجیکٹ BUSL-1.1 لائسنس کے تحت ایک npm پیکیج کے طور پر شائع کیا گیا ہے۔