Sobre el proyecto

T3X es un sistema de control de versiones diseñado para el estado estructurado en lugar del código. Actúa como un plano de control que permite a personas y agentes de IA proponer, validar, revisar y confirmar cambios en artefactos estructurados (típicamente YAML) mientras mantiene trazabilidad completa e historial reversible. La idea central es que cada transición de estado registra el estado previo, el diff propuesto, verificaciones, justificación, agente y evidencia, produciendo un rastro auditable. T3X puede renderizar el estado estructurado en documentos legibles por humanos (por ejemplo, PRDs técnicos) sin perder la fuente de verdad subyacente. Capacidades clave: - **Revisión antes de confirmar**: Inspecciona diffs exactos antes de que avance cualquier historial. - **Transiciones deterministas**: Aplica operaciones ordenadas y fail-fast mediante el motor YOps. - **Verificaciones adjuntas**: Usa YSchema para validación y verificaciones externas sin ocultar fallos. - **Decisiones con alta trazabilidad**: Cada cambio vincula fuente, justificación, agente y evidencia. - **Historial reversible**: Compara, ramifica, fusiona y revierte el estado estructurado sin borrar cambios previos. - **Ruta unificada para humanos y agentes**: Las propuestas de agentes pasan por el mismo proceso de revisión que los cambios humanos. El proyecto está en alpha pública (v1.0.0). Su superficie npm publicada incluye cuatro paquetes: - `@t3x-dev/local` – ejecuta T3X localmente mediante un launcher. - `@t3x-dev/yops` – aplica operaciones declarativas en YAML. - `@t3x-dev/transition` – verifica objetos del protocolo e integridad de commits. - `@t3x-dev/yschema` – valida el estado estructurado y produce correcciones. La WebUI, API, CLI, integraciones MCP, runner y almacenamiento siguen siendo internos o de vista previa y pueden cambiar. Opciones de inicio rápido: - Evaluación local: `npx -p @t3x-dev/local t3x-local` - Desarrollo desde el código fuente: clona el repositorio, ejecuta `pnpm install`, luego `pnpm dev:api` y `pnpm dev:webui` (requiere Node.js 20+ y pnpm 10+). - Autoalojamiento con Docker: copia `.env.example` a `.env` y ejecuta `docker compose up -d --build`. El sistema está licenciado bajo Apache 2.0. Más detalles están disponibles en la [documentación](https://docs.t3x.dev), incluyendo guías sobre despliegue, limitaciones, estabilidad, seguridad y contribución.