first commit

docs/AJUSTES_IC_NOC_GRL_OCI_OPENAI.md

@@ -0,0 +1,39 @@
+# Ajustes IC/NOC/GRL e LLM_PROVIDER=oci_openai
+
+Esta versão corrige dois pontos do runtime nativo do backoffice:
+
+1. **IC/NOC/GRL padronizados pelo framework**
+   - O workflow nativo agora emite eventos pelo `AgentObserver` do framework.
+   - Eventos legados `AGA.*`, `NOC.*` e `GRL.*` capturados dos nós originais são reemitidos pela ponte `_bridge_legacy_ics`.
+   - O runtime emite explicitamente eventos de início, conclusão e falha do workflow.
+   - Os guardrails emitem GRL explícitos para input, output supervisor e output guardrails.
+
+2. **Suporte ao `LLM_PROVIDER=oci_openai`**
+   - `src/core/config.py` agora aceita `oci_openai` no validador local usado pelos nós do backoffice original.
+   - `.env.example` usa `LLM_PROVIDER=oci_openai` por padrão e documenta as variáveis esperadas para OCI/OpenAI-compatible.
+
+## Eventos adicionados no workflow nativo
+
+- `IC.BACKOFFICE_WORKFLOW_STARTED`
+- `IC.BACKOFFICE_WORKFLOW_COMPLETED`
+- `IC.BACKOFFICE_NODE_STARTED`
+- `IC.BACKOFFICE_NODE_COMPLETED`
+- `NOC.001` workflow started
+- `NOC.006` workflow completed
+- `NOC.009` workflow/node failed
+- `GRL.001` input guardrails started
+- `GRL.002` input guardrails completed
+- `GRL.003` input blocked
+- `GRL.004` output supervisor started
+- `GRL.005` output supervisor completed
+- `GRL.006` output supervisor blocked/handover
+- `GRL.007` output guardrails started
+- `GRL.008` output guardrails completed
+- `GRL.009` output blocked/sanitized
+
+## Arquivos alterados
+
+- `app/workflows/backoffice_native_runtime.py`
+- `src/core/config.py`
+- `.env.example`
+- `tools/validate_parity.py`