Paquete de evidencia

Un artefacto local por sesion — veredicto, archivos tocados, comandos corridos, tests, tokens — y como llega a un PR.

Objetivo#

Tener un artefacto por sesion que responda "que se entrego, y como se que es seguro" sin releer la transcripcion: el veredicto del sellado, las notas del guard, que archivos cambiaron, que comandos corrieron, que tests corrieron y su linea de salida, y el uso medido de tokens. Solo lectura, armado con datos que el sellado ya escribio — nunca una segunda fuente de verdad, y nunca contenido de archivos ni un diff.

Pasos#

  1. Despues de que una sesion sella, lee su paquete:

    orch evidence <session>            # bundle.md, resumido
orch evidence <session> --json     # bundle.json, sin tope

    Ambos viven en disco en <data>/evidence/<session>/{bundle.md,bundle.json}. La herramienta MCP evidence_bundle {session} (solo Chair) devuelve el mismo markdown.

  2. Lee los campos: status, guardrails + guardrail_notes, files_changed, commands_run, tests (cmd + exit_line), usage (tokens por CLI, cost_usd cuando se conoce), review (el veredicto de revision cruzada — ver Revision cruzada entre proveedores — "none" hasta que un revisor corre), y handoff (el ultimo mensaje del worker a su Chair).

  3. Promover una sesion agrega automaticamente un resumen con tope (1536 bytes) a la respuesta de worktree_promote — nada que activar. Con gh en el PATH y pr: true, ese mismo resumen pasa a formar parte del body del PR; pon evidence.attach_to_pr: false en orch.yaml para promover sin el (la respuesta de promote sigue llevando el resumen de todas formas).

Que nunca contiene#

Contenido de archivos mas alla de la lista de archivos cambiados, y ningun diff. bundle.md tiene un tope de 4 KB y muestra a lo sumo 40 comandos / 20 tests, recortado con una nota; bundle.json nunca tiene tope, para herramientas que quieran la lista completa.

Relacionado#