Asagiri
Conceptos

Motor de confianza y verificación

Puntuación de confianza local, comprobaciones estructuradas y gates bloqueantes antes de entregar.

Motor de confianza y verificación

spec-my-B — capa de validación determinista entre la implementación del agente y una entrega lista para merge.

Principios

  • Sin confianza implícita — cada puntuación se basa en checks, contratos, flows o evidencias.
  • Confianza ≠ corrección — puntuaciones altas indican cobertura, no garantía (ADR-021).
  • Checks componibles — runners especializados agregados en seis dimensiones.
  • Riesgo visible — blast radius, riesgo residual y huecos en los informes.

Pipeline

implementación
  → checks de verificación (internal/trust/checks/)
  → puntuación de confianza (6 dimensiones)
  → gates de verificación (config verification:)
  → revisión / continuación del work

Seis dimensiones de confianza

DimensiónMide
ArquitecturaContratos, capas, dependencias, blast radius
ImplementaciónTests, calidad del diff, estabilidad estimada
Integridad de flowsEstados, transiciones, permisos, acciones
ObservabilidadLogs, métricas, trazas, dashboards
SeguridadAuth, permisos, secretos, rutas destructivas
RegresiónFlows impactados, cobertura, deps críticas

Artefactos

Cada ejecución escribe en .asagiri/trust/<trust-id>/:

  • report.md / report.json — resumen humano y máquina
  • replay.yaml — manifiesto para asa trust replay <id>

CLI

ComandoPropósito
asa verify trustPipeline completo sobre un flow de producto
asa trust gatesPerfil de gates activo y pass/fail
asa trust replayReejecutar desde manifiesto guardado
asa work --strict-trustBloquear work si fallan los gates tras implementar

Configuración

Umbrales en verification dentro de .asagiri/config.yaml.

Código

internal/trust/
  engine.go
  report.go
  gates.go
  checks/
  confidence/
  replay/

Usa assets de producto (flows, contracts) y grafos de análisis cuando existen.