À propos du projet

T3X est un système de contrôle de version conçu pour les états structurés plutôt que pour le code. Il agit comme un plan de contrôle qui permet aux personnes et aux agents IA de proposer, valider, réviser et valider des modifications d'artefacts structurés (généralement du YAML) tout en maintenant une traçabilité complète et un historique réversible. L'idée centrale est que chaque transition d'état enregistre l'état précédent, le diff proposé, les vérifications, la justification, l'acteur et les preuves, produisant une piste audit. T3X peut rendre l'état structuré en documents lisibles par les humains (par exemple, des PRD techniques) sans perdre la source de vérité sous-jacente. Capacités principales : - **Révision avant engagement** : Inspecter les diffs exacts avant toute avancée de l'historique. - **Transitions déterministes** : Appliquer des opérations ordonnées et rapides via le moteur YOps. - **Vérifications attachées** : Utiliser YSchema pour la validation et les vérifications externes sans masquer les échecs. - **Décisions riches en provenance** : Chaque modification relie la source, la justification, l'acteur et les preuves. - **Historique réversible** : Comparer, créer des branches, fusionner et annuler l'état structuré sans effacer les modifications antérieures. - **Chemin unifié pour humains et agents** : Les propositions des agents subissent le même processus de révision que les changements humains. Le projet est en alpha public (v1.0.0). Sa surface npm publiée inclut quatre packages : - `@t3x-dev/local` – exécuter T3X localement via un lanceur. - `@t3x-dev/yops` – appliquer des opérations YAML déclaratives. - `@t3x-dev/transition` – vérifier les objets protocolaires et l'intégrité des engagements. - `@t3x-dev/yschema` – valider l'état structuré et produire des correctifs. L'interface WebUI, l'API, le CLI, les intégrations MCP, le runner et le stockage restent internes ou en aperçu et peuvent évoluer. Options de démarrage rapide : - Évaluation locale : `npx -p @t3x-dev/local t3x-local` - Développement depuis les sources : clonez le dépôt, exécutez `pnpm install`, puis `pnpm dev:api` et `pnpm dev:webui` (nécessite Node.js 20+ et pnpm 10+). - Auto-hébergement via Docker : copiez `.env.example` vers `.env` et exécutez `docker compose up -d --build`. Le système est sous licence Apache 2.0. Plus de détails sont disponibles dans la [documentation](https://docs.t3x.dev), y compris des guides sur le déploiement, les limites, la stabilité, la sécurité et la contribution.