Guardian

README excerpt

# Guardian

Guardian é um MVP de proteção contextual e letramento digital para crianças e adolescentes. Ele interpreta o contexto recente da atividade, aplica uma política familiar determinística, registra evidência mínima e devolve a decisão final de desbloqueio ao responsável.

Este repositório implementa um vertical slice executável e reproduzível:

```text
fixture de conversa → avaliação de risco → política familiar → bloqueio
→ incidente → explicação da criança → decisão do responsável → desbloqueio
```

O modo padrão **não controla o sistema operacional**. Ele simula o estado de bloqueio para que a demo seja segura em qualquer plataforma. O encerramento real de um aplicativo macOS é separado e precisa ser habilitado explicitamente.

## O que está implementado

- Risk engine com contratos validados e contexto temporal.
- Casos reproduzíveis de contato perigoso, conteúdo adulto, discurso de ódio e aula de biologia segura.
- Policy Engine determinístico; o classificador não escolhe a ação no dispositivo.
- FastAPI com SQLite, deduplicação, políticas, telemetria, incidentes e relatório diário.
- Upload de evidência limitado a 4 MB e servido sem cache público.
- Ciclo `BLOCKED → UNLOCK_REQUESTED → UNLOCKED | KEPT_BLOCKED`.
- Fila persistente de comandos e confirmação pelo agente.
- Dashboard responsivo do responsável, tela da criança e editor de políticas.
- Agente em modo de demo e adaptadores macOS mínimos.
- Helper Swift com ScreenCaptureKit, metadados de janela, OCR loca