Sobre o projeto

O T3X é um sistema de controle de versão projetado para estado estruturado, não para código. Atua como um plano de controle que permite que pessoas e agentes de IA proponham, validem, revisem e confirmem alterações em artefatos estruturados (tipicamente YAML), mantendo proveniência completa e histórico reversível. A ideia central é que cada transição de estado registra o estado anterior, o diff proposto, verificações, justificativa, autor e evidência, produzindo um rastro auditável. O T3X pode renderizar estado estruturado em documentos legíveis por humanos (por exemplo, PRDs técnicos) sem perder a fonte da verdade subjacente. Principais capacidades: - **Revisão antes do commit**: Inspeione diffs exatos antes que qualquer histórico avance. - **Transições determinísticas**: Aplique operações encadeadas e fail-fast através do mecanismo YOps. - **Verificações anexadas**: Use o YSchema para validação e verificações externas sem ocultar falhas. - **Decisões com riqueza de proveniência**: Cada alteração conecta fonte, justificativa, autor e evidência. - **Histórico reversível**: Compare, ramifique, mescle e reverter estado estruturado sem apagar alterações anteriores. - **Caminho unificado para humanos e agentes**: Propostas de agentes passam pelo mesmo processo de revisão que alterações humanas. O projeto está em alpha pública (v1.0.0). Sua superfície npm publicada inclui quatro pacotes: - `@t3x-dev/local` – execute o T3X localmente por meio de um launcher. - `@t3x-dev/yops` – aplique operações declarativas em YAML. - `@t3x-dev/transition` – verifique objetos de protocolo e integridade de commits. - `@t3x-dev/yschema` – valide estado estruturado e produza correções. A WebUI, API, CLI, integrações MCP, runner e armazenamento permanecem internos ou em preview e podem mudar. Opções de início rápido: - Avaliação local: `npx -p @t3x-dev/local t3x-local` - Desenvolvimento a partir do código-fonte: clone o repositório, execute `pnpm install`, depois `pnpm dev:api` e `pnpm dev:webui` (requer Node.js 20+ e pnpm 10+). - Auto-hospedagem via Docker: copie `.env.example` para `.env` e execute `docker compose up -d --build`. O sistema está licenciado sob Apache 2.0. Mais detalhes estão disponíveis na [documentação](https://docs.t3x.dev), incluindo guias sobre implantação, limitações, estabilidade, segurança e contribuição.