প্রকল্প সম্পর্কে

# 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 অটোমেশন প্রিমিটিভ দেওয়া যাবে না। অপারেশনগুলি টাইপের উপর ভিত্তি করে নির্দিষ্ট ওয়ার্কারদের কাছে রাউট করা হয়। ## যাচাইকৃত বাস্তবায়ন: POC-002 `research/poc_002/` হলো প্রথম কার্যকর প্রুফ অব কনসেপ্ট: - শুধুমাত্র সিন্থেটিক TES4 ফিক্সচার ব্যবহার করে। - বন্ধ operation enums সহ একটি কঠোর পার্সার বাস্তবায়ন করে। - path containment সহ candidate-only ওয়ার্কস্পেস প্রয়োগ করে। - fail-closed orchestration এবং no-overwrite receipts নিশ্চিত করে। - মূল ফাইলগুলির জন্য SHA-256 invariants বজায় রাখে। - ৪৪টি স্বয়ংক্রিয় পরীক্ষা অন্তর্ভুক্ত (প্রাথমিক বেসলাইন: ৪৩; +১ adversarial regression)। POC-002 চালাতে: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` দ্রষ্টব্য: এটি নির্বিচারে বাস্তব Skyrim প্লাগইন, Creation Kit রানটাইম আচরণ, xEdit, PapyrusCompiler, Mutagen, বা ইন-গেম সঠিকতার সাথে সামঞ্জস্য প্রমাণ করে না। ## Discovery Desk Research UI রিপোজিটরিতে "Discovery Desk" নামক একটি ছোট Next.js + Drizzle/PostgreSQL গবেষণা অ্যাপ সংরক্ষিত আছে। - `src/app/`, `src/db/`, এবং `src/lib/research/` এই UI-এর অন্তর্গত। - এটি ভবিষ্যতের লেখন এজেন্টের রানটাইম **নয়**। - ডেভেলপমেন্টের জন্য একটি `DATABASE_URL` পরিবেশ ভেরিয়েবল প্রয়োজন (`.env.example` দেখুন)। ভেরিয়েবল অনুপস্থিত থাকলে বিল্ড প্রক্রিয়া দ্রুত ব্যর্থ হয়, কিন্তু connection pool lazy হওয়ায় CI-এর জন্য কোনো লাইভ PostgreSQL সার্ভার প্রয়োজন নেই। ## নিরাপত্তা নিয়ম - ব্যবহারকারীর একটি প্লাগইনের একমাত্র কপি কখনও পরিবর্তন করবেন না। - মূল ফাইলগুলি অপরিবর্তনীয় ইনপুট; লেখাগুলি candidate-এ যায়। - AI-উৎপন্ন প্ল্যানে কোনো নির্বিচারে shell কমান্ড নয়। - প্রাথমিক পথ হিসেবে কোনো coordinate-click GUI অটোমেশন নয়। - সমাপ্তির প্রমাণ অনুপস্থিত থাকা ব্যর্থতা, সাফল্য নয়। - Bethesda গেম/এডিটর বাইনারি, vanilla প্লাগইন, বা vanilla Papyrus সোর্স কখনও কমিট করবেন না। - প্রসেস আইসোলেশন একটি প্রযুক্তিগত সীমানা, স্বয়ংক্রিয় লাইসেন্সিং সিদ্ধান্ত নয়। ## লাইসেন্সিং - **রিপোজিটরি-লিখিত মূল কোড**: MIT License। - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only। সম্মিলিত কাজের জন্য GPL সম্মতি প্রয়োজন। - **xEdit**: MPL-2.0 upstream। বাহ্যিক সম্পাদনের জন্য উদ্দিষ্ট, কখনও vendored নয়। - **CKPE**: LGPLv3 কোড প্লাস Creation Kit EULA/আইনি ওভারলে। স্ট্যাটাস: `LEGAL_REVIEW_REQUIRED`। - **Creation Kit, PapyrusCompiler, vanilla assets**: মালিকানাধীন ব্যবহারকারী-ইনস্টলড উপাদান। কখনও পুনর্বিতরণ করা হয় না। তৃতীয়-পক্ষের npm প্যাকেজ এবং OFL ফন্টের আলাদা নোটিশ রয়েছে। আমদানি করা গবেষণা ZIP-এর উৎস অমীমাংসিত। ## Sky-Claw-এর সাথে সম্পর্ক এটি একটি পৃথক রিপোজিটরি এবং গবেষণা ট্র্যাক। এটি পরে একটি নথিভুক্ত প্রোটোকলের মাধ্যমে Sky-Claw-এর সাথে সংহত হতে পারে, কিন্তু স্বাধীনভাবে পরীক্ষাযোগ্য থাকতে হবে এবং Sky-Claw-এর অভ্যন্তরীণ বিষয়কে তার নিরাপত্তা সীমানা হিসেবে ধরে নেওয়া যাবে না। ## দাবিত্যাগ Bethesda Game Studios, ZeniMax Media, Valve, Nexus Mods, বা তৃতীয়-পক্ষের টুল লেখকদের সাথে সম্পর্কহীন।