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

# Skyrim Creation Kit Agent یہ ریپوزٹری *The Elder Scrolls V: Skyrim Special Edition* اور *Anniversary Edition* کے لیے AI کی مدد سے موڈ تصنیف کرنے والے ایجنٹ کی تیاری کے لیے تحقیقی اور انجینئرنگ آرٹیفیکٹس پر مشتمل ہے۔ یہ پروجیکٹ حفاظت کو مقدم رکھنے والے طریقوں پر توجہ مرکوز کرتا ہے، جو اعلیٰ سطح کے موڈنگ ارادے کو ٹائپ شدہ، قابلِ واپسی، اور ثبوت کے ساتھ آپریشنز میں تبدیل کرتا ہے۔ ## بنیادی فلسفہ یہ نظام چار اصولوں پر کام کرتا ہے: 1. **AI فیصلہ کرتا ہے کہ کیا کرنا ہے**: LLM/پلانر مطلوبہ آپریشن کا تعین کرتا ہے۔ 2. **ڈیٹرمنسٹک سافٹ ویئر فیصلہ کرتا ہے کہ کیسے کرنا ہے**: ٹائپ شدہ ورکرز اعمال کو انجام دیتے ہیں۔ 3. **ویلیڈیٹرز فیصلہ کرتے ہیں کہ کام ہوا یا نہیں**: خودکار جانچ سالمیت کو یقینی بناتی ہے۔ 4. **انسان فیصلہ کرتا ہے کہ قبول کرنا ہے یا نہیں**: اطلاق سے قبل حتمی منظوری ضروری ہے۔ ہدف مصنوع ایک ہائبرڈ آرکسٹریٹر ہے جہاں بنیادی راستہ ہیڈ لیس اور ڈیٹرمنسٹک ہے۔ Creation Kit کو بنیادی نظام کے بجائے ایک محدود صلاحیت کے طور پر دیکھا جاتا ہے۔ ## موجودہ حیثیت **تحقیق + تصدیق شدہ مصنوعی پروف آف کانسیپٹ۔** یہ ابھی تک عمومی مقصد کا موڈ تصنیف کرنے والا ایجنٹ نہیں ہے، اور نہ ہی یہ فی الحال Creation Kit کو براہ راست خودکار بناتا ہے۔ موجودہ Gate-1 فیصلہ "VIABLE WITH LIMITATIONS" ہے۔ اگرچہ زیادہ تر ریکارڈ سطح کے آپریشنز ممکنہ طور پر Creation Kit سے بچ سکتے ہیں، کئی شعبے غیر حل شدہ ہیں (مثلاً FaceGen، navmeshes، پیچیدہ quest semantics)۔ ### حیثیت کی اصطلاحات - `VERIFICADO`: براہ راست ثبوت یا قابلِ تولید ٹیسٹ سے تائید شدہ۔ - `PASS`: تجربہ انجام دیا گیا اور متعین گیٹس پاس کیے۔ - `NO VERIFICADO`: ممکنہ مگر یہاں دوبارہ تولید نہیں ہوا۔ - `HIPOTESIS`: تجویز کردہ تجربہ یا ڈیزائن دعویٰ۔ - `EXPERIMENTAL`: صرف ایک تجربے کے طور پر نافذ شدہ۔ - `BLOQUEADO`: دستیاب ماحول میں آگے نہیں بڑھ سکتے۔ - `DESCARTADO`: واضح طور پر مسترد شدہ۔ - `LEGAL_REVIEW_REQUIRED`: تکنیکی راستہ موجود ہے، مگر لائسنسنگ/EULA کے مضمرات غیر حل شدہ ہیں۔ ## آرکیٹیکچر تجویز کردہ مصنوع کی شکل ایک **ہائبرڈ آرکسٹریٹر + ہیڈ لیس-فرسٹ بنیادی راستہ** ہے: ```text User Intent ↓ Intent normalizer ↓ Planner / LLM ↓ Typed ModPlan ↓ Policy / safety engine ↓ Capability router ├─ Headless plugin worker ├─ Papyrus worker ├─ xEdit validator └─ Creation Kit worker [disabled until independently verified] ↓ Candidate workspace ↓ Validator ↓ Human approval ``` پلانر کو صوابدیدی shell کمانڈز یا GUI آٹومیشن primitives موصول نہیں ہونے چاہئیں۔ آپریشنز کو ان کی قسم کی بنیاد پر مخصوص ورکرز تک پہنچایا جاتا ہے۔ ## تصدیق شدہ نفاذ: POC-002 `research/poc_002/` پہلا قابلِ عمل پروف آف کانسیپٹ ہے: - صرف مصنوعی TES4 fixtures استعمال کرتا ہے۔ - بند operation enums کے ساتھ سخت parser نافذ کرتا ہے۔ - path containment کے ساتھ صرف candidate workspaces کو نافذ کرتا ہے۔ - fail-closed orchestration اور no-overwrite receipts کو یقینی بناتا ہے۔ - اصل فائلوں کے لیے SHA-256 invariants برقرار رکھتا ہے۔ - 44 خودکار ٹیسٹ شامل ہیں (ابتدائی بنیاد: 43؛ +1 adversarial regression)۔ POC-002 چلانے کے لیے: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` نوٹ: یہ صوابدیدی حقیقی Skyrim plugins، Creation Kit runtime behavior، xEdit، PapyrusCompiler، Mutagen، یا in-game درستگی کے ساتھ مطابقت ثابت نہیں کرتا۔ ## Discovery Desk Research UI یہ ریپوزٹری ایک چھوٹی Next.js + Drizzle/PostgreSQL تحقیقی ایپ محفوظ رکھتی ہے جس کا نام "Discovery Desk" ہے۔ - `src/app/`، `src/db/`، اور `src/lib/research/` اس UI سے تعلق رکھتے ہیں۔ - یہ مستقبل کے تصنیفی ایجنٹ کا runtime **نہیں** ہے۔ - ترقی کے لیے `DATABASE_URL` environment variable درکار ہے (دیکھیں `.env.example`)۔ اگر variable موجود نہ ہو تو build process فوری ناکام ہو جاتا ہے، مگر CI کے لیے live PostgreSQL سرور کی ضرورت نہیں کیونکہ connection pool lazy ہے۔ ## حفاظتی قواعد - صارف کی plugin کی واحد کاپی کبھی تبدیل نہ کریں۔ - اصل فائلیں ناقابلِ تبدیل inputs ہیں؛ تحریر candidates میں جاتی ہے۔ - AI سے تیار کردہ پلانز میں کوئی صوابدیدی shell کمانڈز نہیں۔ - بنیادی راستے کے طور پر coordinate-click GUI آٹومیشن نہیں۔ - تکمیل کا ثبوت غائب ہونا ناکامی ہے، کامیابی نہیں۔ - Bethesda game/editor binaries، vanilla plugins، یا vanilla Papyrus sources کبھی commit نہ کریں۔ - Process isolation ایک تکنیکی حد ہے، خودکار لائسنسنگ نتیجہ نہیں۔ ## لائسنسنگ - **ریپوزٹری کے مصنف کردہ بنیادی کوڈ**: MIT License۔ - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only۔ مشترکہ کاموں کے لیے GPL تعمیل درکار ہے۔ - **xEdit**: MPL-2.0 upstream۔ بیرونی execution کے لیے، کبھی vendored نہیں۔ - **CKPE**: LGPLv3 کوڈ کے علاوہ Creation Kit EULA/legal overlay۔ حیثیت: `LEGAL_REVIEW_REQUIRED`۔ - **Creation Kit، PapyrusCompiler، vanilla assets**: ملکیتی صارف کی نصب کردہ اجزاء۔ کبھی دوبارہ تقسیم نہیں۔ Third-party npm packages اور OFL fonts کے الگ notices ہیں۔ درآمد شدہ تحقیقی ZIPs کی provenance غیر حل شدہ ہے۔ ## Sky-Claw سے تعلق یہ ایک الگ ریپوزٹری اور تحقیقی ٹریک ہے۔ یہ بعد میں ایک دستاویزی پروٹوکول کے ذریعے Sky-Claw کے ساتھ ضم ہو سکتی ہے مگر اسے آزادانہ طور پر قابلِ جانچ رہنا چاہیے اور Sky-Claw internals کو اپنی حفاظتی حد نہیں ماننا چاہیے۔ ## دستبرداری Bethesda Game Studios، ZeniMax Media، Valve، Nexus Mods، یا third-party tool authors سے غیر وابستہ۔