revisão e complementação da documentação do projeto

RI/docs/AS-BUILT.en-us.md

@@ -11,10 +11,9 @@ the RI, see [`How-To.md`](How-To.md). For those who will **evaluate/adapt** the
 scenario, see [`Assumptions.md`](Assumptions.md) and
 [`Production-Recommendations.md`](Production-Recommendations.md).
 
-This document succeeds the planning backlog `docs/RI-PLANNING.md` (removed from the repository
-after the completion of milestone M4, with history preserved in git) — the factual information
-from that backlog that is still relevant to whoever uses the finished product was migrated here,
-to `Assumptions.md`, and to `Production-Recommendations.md`.
+Individual architectural decisions are recorded in [`../../docs/adr/`](../../docs/adr/)
+(ADR-001 through ADR-025); the assumptions and reasoning behind them are synthesized in
+[`Assumptions.md`](Assumptions.md).
 
 ## Status
 
@@ -31,8 +30,8 @@ Registry.
 ## Epic index
 
 Every `EP-XX-TXX` that appears in comments/docstrings in the source code references one of these
-epics. This table is what replaces `docs/RI-PLANNING.md` §8.6 as the context source for those
-references.
+epics. This table is the authoritative reference for these labels — consult it whenever a
+comment/docstring cites an `EP-XX-TXX` without further context.
 
 | Epic | Title | Main module/test |
 |---|---|---|
@@ -167,7 +166,7 @@ exchange).
 ### Auditing, correlation and observability (EP-08)
 
 **Responsibility:** `audit/models.py` defines `EventEnvelope` with a 3-category taxonomy adopted
-from the Agent Platform OCI reference (ADR-022): **IC** (Client Interaction/business journey,
+from the Agent Platform OCI reference (ADR-022): **IC** (Control Indicator/business journey,
 e.g. `client_authenticated`, `tool_call_allowed`), **NOC** (operational/availability error, e.g.
 `pdp_unavailable`), **GRL** (guardrail/governance, e.g. `tool_call_denied`,
 `tools_list_filtered`, `bypass_attempt_detected`). Every event recursively sanitizes any key

RI/docs/AS-BUILT.md

@@ -9,10 +9,9 @@ Público-alvo: quem vai **integrar com ou estender** a RI. Para quem vai **rodar
 [`How-To.md`](How-To.md). Para quem vai **avaliar/adaptar** a RI para um cenário real, ver
 [`Assumptions.md`](Assumptions.md) e [`Production-Recommendations.md`](Production-Recommendations.md).
 
-Este documento sucede o backlog de planejamento `docs/RI-PLANNING.md` (removido do
-repositório após a conclusão do marco M4, com histórico preservado no git) — a informação
-factual desse backlog que ainda é relevante para quem usa o produto acabado foi migrada para
-cá, para `Assumptions.md` e para `Production-Recommendations.md`.
+Decisões arquiteturais individuais estão registradas em [`../../docs/adr/`](../../docs/adr/)
+(ADR-001 a ADR-025); as premissas e razões por trás delas estão sintetizadas em
+[`Assumptions.md`](Assumptions.md).
 
 ## Status
 
@@ -29,8 +28,8 @@ real para o Registry.
 ## Índice de épicos
 
 Cada `EP-XX-TXX` que aparece em comentários/docstrings do código-fonte referencia um destes
-épicos. Esta tabela é o que substitui `docs/RI-PLANNING.md` §8.6 como fonte de contexto para
-essas referências.
+épicos. Esta tabela é a referência autoritativa para essas siglas — consulte-a sempre que um
+comentário/docstring citar um `EP-XX-TXX` sem contexto adicional.
 
 | Épico | Título | Módulo/teste principal |
 |---|---|---|
@@ -164,7 +163,7 @@ backend. 7 testes (4 unit com `httpx.MockTransport`, 3 e2e contra Keycloak real,
 ### Auditoria, correlação e observabilidade (EP-08)
 
 **Responsabilidade:** `audit/models.py` define `EventEnvelope` com uma taxonomia de 3 categorias
-adotada da referência Agent Platform OCI (ADR-022): **IC** (Interação de Cliente/negócio-jornada,
+adotada da referência Agent Platform OCI (ADR-022): **IC** (Indicador de Controle/negócio-jornada,
 ex. `client_authenticated`, `tool_call_allowed`), **NOC** (operacional/erro de disponibilidade,
 ex. `pdp_unavailable`), **GRL** (guardrail/governança, ex. `tool_call_denied`,
 `tools_list_filtered`, `bypass_attempt_detected`). Todo evento sanitiza recursivamente qualquer

RI/docs/interfaces/audit-events.en-us.md

@@ -48,7 +48,7 @@ rather than a taxonomy of its own:
 
 | Category | Meaning | `event_type` examples |
 |---|---|---|
-| `ic` | Customer Interaction / business journey — the call progressed normally | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
+| `ic` | Control Indicator / business journey — the call progressed normally | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
 | `noc` | Operational/error — an availability failure, not a policy decision | `pdp_unavailable`, `backend_credential_unavailable` |
 | `grl` | Guardrail/governance — an entitlement/policy boundary was applied or tested | `tool_call_denied`, `tools_list_filtered`, `tool_call_require_approval`, `approval_granted`, `bypass_attempt_detected`, `journey_ended_after_denial` |
 

RI/docs/interfaces/audit-events.md

@@ -48,7 +48,7 @@ em vez de uma taxonomia própria:
 
 | Categoria | Significado | Exemplos de `event_type` |
 |---|---|---|
-| `ic` | Interação de Cliente / negócio-jornada — a chamada progrediu normalmente | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
+| `ic` | Indicador de Controle / negócio-jornada — a chamada progrediu normalmente | `client_authenticated`, `tool_call_allowed`, `agent_turn_completed`, `nba_recalculated` |
 | `noc` | Operacional/erro — falha de disponibilidade, não uma decisão de política | `pdp_unavailable`, `backend_credential_unavailable` |
 | `grl` | Guardrail/governança — uma fronteira de entitlement/política foi aplicada ou testada | `tool_call_denied`, `tools_list_filtered`, `tool_call_require_approval`, `approval_granted`, `bypass_attempt_detected`, `journey_ended_after_denial` |