عن المشروع

T3X هو نظام تحكم للتحكم بالحالة الهيكلية بدلاً من الكود. يتيح للناس ووكلاء الذكاء الاصطناعي اقتراح التحوّلات والتحقق منها ومراجعتها والتزامها على النصوص الهيكلية (عادةً YAML) مع الحفاظ على إثبات كامل وسجل قابل للعكس. الفكرة الأساسية هي أن كل انتقال حالة يسجل الحالة السابقة والفرق المقترح والتحقاقات والسبب والفعل والدليل، منتجة مساراً قابلاً للمراجعة. يمكن لـ T3X عرض الحالة الهيكلية كوثائق قابلة للقراءة البشرية (مثل مستندات PRD التقنية) دون فقدان مصدر الحقيقة الأساسي. القدرة الرئيسية: - **المراجعة قبل الالتزام**: فحص الفروق الدقيقة قبل أي تقدم في السجل. - **الانتقالات الحتمية**: تطبيق عمليات مرتبة سريعة الفشل عبر محرك YOps. - **تحقق ملاصق**: استخدام YSchema للتحقق من الصحة والتحقق الخارجي دون إخفاء الفشل. - **قرارات غنية بالإثبات**: تربط كل تغيير المصدر والسبب والفعل والدليل. - **سجل عكوس**: قارن وفروع وأدمج وأعد الحالة الهيكلية دون مسح التغييرات السابقة. - **مسار موحد للبشر والوكلاء**: تخضع مقترحات الوكيل لنفس عملية المراجعة كتغييرات البشر. المشروع في طور المعاينة العامة (الإصدار v1.0.0). سطحه المعلن يشمل أربعة حزم: - `@t3x-dev/local` – قم بتشغيل T3X محلياً عبر مشغّل. - `@t3x-dev/yops` – طبّق عمليات YAML إعلانية. - `@t3x-dev/transition` – تحقّق من صحة الأشياء البروتوكولية والتزام السلامة. - `@t3x-dev/yschema` – تحقّق من صحة الحالة الهيكلية وأنتج الإصلاحات. واجهة الويب وواجهة البرمجة 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)، بما في ذلك أدلة النشر والقيود والاستقرار والأمن والمساهمة.