Witness

Los agentes de IA pueden actuar. Witness hace que su trabajo rinda cuentas.

Un modelo puede escribir código, llamar herramientas y entregar trabajo a otro modelo. Pero cuando el chat desaparece, ¿qué sobrevive?

Witness convierte el trabajo de los agentes en memoria de proyecto duradera e inspeccionable: decisiones, evidencia, resultados, registros, identidad e historial — expuesta a través de MCP.

El constructor puede decir «listo». Witness preserva lo que se decidió, lo que realmente sucedió y lo que el siguiente agente puede verificar.

Ejecuta la demo real · Explora la hoja de ruta · Instala v0.1.0

Related MCP server: Cruxible Core

El modo de fallo

Sin una capa de evidencia compartida, un sistema multiagente se convierte lentamente en una pila de transcripciones confiadas:

Planner:   “Build the release.”
Builder:   “Done.”
Validator: “Which bytes? Which requirements? Why this design?”
Next run:  “I have no context from the previous chat.”
Owner:     reconstructs everything by hand.

Con Witness, el objeto duradero no es la conversación. Es el estado del proyecto atestiguado.

Ve el sistema en movimiento

sequenceDiagram
    actor Owner
    participant Planner
    participant Builder
    participant Validator
    participant Witness
    participant NextAgent as Next agent / model

    Owner->>Planner: Ship a validated release
    Planner->>Witness: Record decision + acceptance rule
    Planner->>Builder: Build exact candidate
    Builder->>Witness: Record outcome + evidence references
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Verify or dispute result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Why + what happened + current evidence

El repositorio incluye un flujo MCP local real. Crea una base de datos temporal, utiliza identidades sintéticas firmadas separadas de constructor y validador, escribe una decisión y un resultado, mueve el resultado de recorded a verified y luego restaura el contexto del proyecto.

[1/3] Decision witnessed: builder cannot validate its own release
[2/3] Outcome verified by a distinct validator identity
[3/3] Project context restored from the database
WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

Clase de evidencia: flujo de producto local real. La demo ejercita el servidor MCP público real y la capa de persistencia con credenciales sintéticas. No es una captura de pantalla en la nube ni una respuesta simulada.

Ejecuta la demo real

git clone https://github.com/MaximilianoColoma/witness.git
cd witness
uv sync --locked
uv run python examples/coordinated_autonomy_demo.py

Lo que esto permite

Constructores que rinden cuentas

Un constructor puede producir trabajo mientras un agente diferente lo valida contra la decisión y la evidencia originales. La ejecución y la aceptación ya no tienen que vivir en el mismo contexto del modelo.

Continuidad independiente del modelo

Reemplaza el modelo, reinicia el proceso o reanuda la próxima semana. El siguiente agente puede recuperar un contexto de proyecto acotado en lugar de hacer ingeniería inversa de un chat antiguo.

Puertas de liberación sensibles a la evidencia

Las decisiones, los resultados, los recibos y las transiciones de estado se convierten en entradas consultables para CI, gobernanza de liberación, revisión de incidentes y aprobación humana.

Memoria con límites

Witness no es un volcado de transcripciones sin límites. El núcleo público almacena objetos de proyecto declarados, redacta PII compatible antes de la persistencia, utiliza lecturas acotadas y deniega autoridad no declarada.

Un rastro de auditoría que los agentes no pueden reescribir a la ligera

Las mutaciones del núcleo público y los eventos de auditoría se confirman juntos o no se confirman en absoluto. Los disparadores canónicos protegen el historial de operaciones de solo anexión contra actualización y eliminación.

Funciones soñadas

Estos son patrones habilitados, no orquestación incluida en v0.1.0:

• Fábricas de software autónomas donde cada liberación puede responder quién decidió, quién construyó, qué se probó y qué evidencia pasó.

• Continuidad entre modelos donde Claude, GPT, modelos locales y agentes especialistas pueden cambiar de asiento sin perder la verdad del proyecto.

• Organizaciones de agentes que se auto-mejoran donde los resultados verificados pueden alimentar posteriormente una capa de aprendizaje en lugar de desaparecer en el historial del chat.

• Autonomía legible por el propietario donde un humano puede preguntar «¿Por qué el sistema hizo esto?» y recibir la cadena de decisiones registrada.

• Memoria de incidentes que lleva la causa raíz y la prevención a la siguiente ejecución en lugar de redescubrir el mismo fallo.

• Prueba portátil donde un validador externo puede inspeccionar la evidencia liberada sin confiar en la narración del constructor.

Witness proporciona el sustrato de evidencia. Los agentes de programación, la generación de constructores, el aprendizaje automático y los puentes entre productos son capas separadas.

Construido ahora — y aún no

La versión 0.1.0 es una liberación pública validada. El servicio no está desplegado por este repositorio, y la publicación no es una afirmación de soporte de producción o impacto de usuario.

Superficie pública de MCP

Los contratos canónicos viven en spec/. FTS5 es búsqueda de texto local, no búsqueda semántica o vectorial.

Instalar y verificar

Requiere Python 3.11+ y uv.

./install.sh --manifest --json
./install.sh --target "$HOME/.local/share/witness" --non-interactive --json
uv sync --locked
uv run python -m pytest -q -p no:cacheprovider tests repair-tests
uv build

El instalador por etapas limpia las variables de entorno de Python heredadas, realiza una instalación bloqueada, escribe configuración/almacenamiento local acotado y ejecuta un doctor real de primer arranque de MCP.

Centro del proyecto

• Hoja de ruta del producto: ROADMAP.md

• Gobernanza y autoridad de liberación: GOVERNANCE.md

• Contribuciones y DCO: CONTRIBUTING.md

• Reporte de seguridad: SECURITY.md

• Límites de soporte: SUPPORT.md

• Nombres oficiales y bifurcaciones: TRADEMARKS.md

Licencia

Licenciado bajo la Apache License 2.0. Ver NOTICE. Apache-2.0 permite uso, modificación, redistribución y uso comercial; no otorga permiso para implicar estatus oficial del proyecto o respaldo de marca.