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

T3X হলো একটি ভার্সন কন্ট্রোল সিস্টেম যা কোডের পরিবর্তে স্ট্রাকচার্ড স্টেটের জন্য ডিজাইন করা হয়েছে। এটি একটি কন্ট্রোল প্লেন হিসেবে কাজ করে যা মানুষ এবং AI এজেন্টদের স্ট্রাকচার্ড আর্টিফ্যাক্টে (সাধারণত YAML) পরিবর্তন প্রস্তাব করতে, ভ্যালিডেট করতে, রিভিউ করতে এবং কমিট করতে দেয়, পাশাপাশি সম্পূর্ণ প্রোভেন্যান্স এবং রিভার্সিবল হিস্ট্রি বজায় রাখে। মূল ধারণাটি হলো প্রতিটি স্টেট ট্রানজিশন পূর্ববর্তী স্টেট, প্রস্তাবিত ডিফ (diff), চেক, যৌক্তিকতা, অভিনেতা এবং প্রমাণ রেকর্ড করে, যা একটি অডিটেবল ট্রেইল তৈরি করে। T3X মূল সোর্স অফ ট্রুথ না হারিয়ে স্ট্রাকচার্ড স্টেটকে মানুষের পাঠযোগ্য ডকুমেন্টে (যেমন, টেকনিক্যাল PRDs) রেন্ডার করতে পারে। মূল সক্ষমতাগুলি: - **কমিট করার আগে রিভিউ**: কোনো হিস্ট্রি এগিয়ে যাওয়ার আগে সঠিক ডিফ (diff) পরিদর্শন করুন। - **ডিটারমিনিস্টিক ট্রানজিশন**: YOps ইঞ্জিনের মাধ্যমে অর্ডারড এবং ফেইল-ফাস্ট অপারেশন প্রয়োগ করুন। - **অ্যাটাচড চেকস**: ভ্যালিডেশনের জন্য YSchema এবং এক্সটার্নাল চেক ব্যবহার করুন যা ব্যর্থতা গোপন করে না। - **প্রোভেন্যান্স-রিচ ডিসিশন**: প্রতিটি পরিবর্তন সোর্স, যৌক্তিকতা, অভিনেতা এবং প্রমাণকে একত্রে যুক্ত করে। - **রিভার্সিবল হিস্ট্রি**: পূর্ববর্তী পরিবর্তনগুলি মুছে না ফেলে স্ট্রাকচার্ড স্টেট তুলনা, ব্রাঞ্চ, মার্জ এবং রিভার্ট করুন। - **মানুষ এবং এজেন্টের জন্য ইউনিফাইড পাথ**: এজেন্টের প্রস্তাবগুলো মানুষের পরিবর্তনের মতোই একই রিভিউ প্রক্রিয়ার মধ্য দিয়ে যায়। প্রজেক্টটি পাবলিক আলফাতে (v1.0.0) রয়েছে। এর প্রকাশিত npm সারফেস চারটি প্যাকেজ অন্তর্ভুক্ত করে: - `@t3x-dev/local` – লঞ্চারের মাধ্যমে লোকালি T3X চালান। - `@t3x-dev/yops` – ডিক্লারেটিভ YAML অপারেশন প্রয়োগ করুন। - `@t3x-dev/transition` – প্রোটোকল অবজেক্ট এবং কমিট ইন্টিগ্রিটি যাচাই করুন। - `@t3x-dev/yschema` – স্ট্রাকচার্ড স্টেট ভ্যালিডেট করুন এবং ফিক্স তৈরি করুন। WebUI, API, CLI, MCP ইন্টিগ্রেশন, রানার এবং স্টোরেজ অভ্যন্তরীণ বা প্রিভিউ পর্যায়ে রয়েছে এবং পরিবর্তন হতে পারে। কুইকস্টার্ট অপশন: - লোকাল ইভালুয়েশন: `npx -p @t3x-dev/local t3x-local` - সোর্স থেকে ডেভেলপমেন্ট: রিপোজিটরি ক্লোন করুন, `pnpm install` চালান, তারপর `pnpm dev:api` এবং `pnpm dev:webui` চালান (Node.js 20+ এবং pnpm 10+ প্রয়োজন)। - Docker-এর মাধ্যমে সেলফ-হোস্টেড: `.env.example` ফাইলটি `.env` হিসেবে কপি করুন এবং `docker compose up -d --build` চালান। সিস্টেমটি Apache 2.0 লাইসেন্সের অধীনে। আরও বিস্তারিত https://docs.t3x.dev-এ পাওয়া যাবে, যার মধ্যে ডেপ্লয়মেন্ট, সীমাবদ্ধতা, স্ট্যাবিলিটি, সিকিউরিটি এবং কন্ট্রিবিউটিং সংক্রান্ত গাইড রয়েছে।