# Actores y superficies de Objective Guard

## Actores

### ACT-01 — Agente de programación

- [Inferencia] Edita archivos, ejecuta herramientas, consume hallazgos y corrige violaciones.
- [Inferencia] Puede iniciar una sesión, solicitar explicación o presentar evidencia.
- [Ambigüedad] El primer harness soportado se decidirá al implementar el hook.

### ACT-02 — Desarrollador supervisor

- [Inferencia] Declara o confirma objetivos y criterios.
- [Inferencia] Aprueba excepciones o expansiones sensibles.
- [Inferencia] Inspecciona resultados finales y reproduce hallazgos.

### ACT-03 — Responsable de módulo

- [Inferencia] Mantiene políticas locales, contratos públicos y comandos focalizados.
- [Inferencia] Define zonas sensibles sin describir exhaustivamente todo el módulo.

### ACT-04 — Equipo de plataforma

- [Inferencia] Instala hooks, integra CI y controla permisos, timeouts y políticas globales.
- [Inferencia] Revisa errores del runtime y calidad de detectores.

### ACT-05 — Investigador o evaluador

- [Inferencia] Consume eventos pasivos, construye datasets y valida señales estadísticas.
- [Inferencia] No modifica umbrales después de observar el conjunto confirmatorio.

## Superficies

### SUP-01 — Hook por edición

- Actor principal: ACT-01.
- Momento: después de escribir o editar un archivo.
- Entrada: archivo, contenido y diff contra baseline.
- Salida: delta compacto de hallazgos nuevos.
- Confianza: [Inferencia] definida por el MVP; no implementada.

### SUP-02 — CLI local

- Actores: ACT-01, ACT-02 y ACT-04.
- Operaciones previstas: check, detalle de hallazgo, estado, sesión y modo final.
- Salidas: texto presupuestado o JSON estable.
- Confianza: [Inferencia].

### SUP-03 — Contrato de sesión

- Actores: ACT-01 y ACT-02.
- Contenido: tipo, objetivo, criterios, scope, zonas sensibles e invariantes.
- Confianza: [Inferencia]; formato externo todavía [Ambigüedad].

### SUP-04 — Integración CI

- Actores: ACT-04 y ACT-02.
- Entrada: commit, contrato y políticas versionadas.
- Salida: veredicto reproducible y artefacto de evidencia.
- Confianza: [Inferencia].

### SUP-05 — Almacenamiento local

- Actores: todos indirectamente.
- Contenido: fingerprints, sesiones, caché, evidencia y eventos JSONL.
- Confianza: [Inferencia].

### SUP-06 — Reporte científico offline

- Actor principal: ACT-05.
- Entrada: eventos anonimizados o locales y labels del benchmark.
- Salida: calibración, comparación con baselines y falsación.
- Confianza: [Inferencia].

### SUP-07 — Guard documental

- Actor principal: ACT-04.
- Comando: `node scripts/validate-docs.mjs`.
- Salida: `PASS` o `BLOCK` con incumplimientos estructurales.
- Confianza: [Hecho] respaldado por `scripts/validate-docs.mjs`.

## Relaciones

```text
ACT-01 → SUP-01/SUP-02/SUP-03
ACT-02 → SUP-02/SUP-03/SUP-04
ACT-03 → políticas consumidas por SUP-01/SUP-04
ACT-04 → instala y gobierna SUP-01/SUP-04/SUP-05
ACT-05 → consume SUP-05 mediante SUP-06
```

## Ambigüedades

- [Ambigüedad] No se definió una UI gráfica.
- [Ambigüedad] No se eligió protocolo estándar de integración con todos los agentes.
- [Ambigüedad] No se decidió si las aprobaciones viven en un archivo, servicio o plataforma externa.