diff --git a/RI/docs/AS-BUILT.en-us.md b/RI/docs/AS-BUILT.en-us.md index f054016..f93a7c3 100644 --- a/RI/docs/AS-BUILT.en-us.md +++ b/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 diff --git a/RI/docs/AS-BUILT.md b/RI/docs/AS-BUILT.md index 7c742ce..232f206 100644 --- a/RI/docs/AS-BUILT.md +++ b/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 diff --git a/RI/docs/interfaces/audit-events.en-us.md b/RI/docs/interfaces/audit-events.en-us.md index 5e37b65..8cddc3c 100644 --- a/RI/docs/interfaces/audit-events.en-us.md +++ b/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` | diff --git a/RI/docs/interfaces/audit-events.md b/RI/docs/interfaces/audit-events.md index 37a1392..8554df7 100644 --- a/RI/docs/interfaces/audit-events.md +++ b/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` | diff --git a/RI/services/example_mcp_servers/sales_domain/server.py b/RI/services/example_mcp_servers/sales_domain/server.py index 96d6d1b..f655e39 100644 --- a/RI/services/example_mcp_servers/sales_domain/server.py +++ b/RI/services/example_mcp_servers/sales_domain/server.py @@ -3,9 +3,9 @@ Read-only tools (risk tier R1, see README.md §17): customer.search, customer.get, order.get, inventory.check. Write tools (R2): quote.create, quote.update. Backed by static mock data -- this server is deliberately -"dumb": it never authorizes anything (see `docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md`). -Authorization happens exclusively upstream, in the Gateway/PEP (EP-05) -before a call ever reaches this process. +"dumb": it never authorizes anything (see +`docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md`). Authorization happens +exclusively upstream, in the Gateway/PEP (EP-05) before a call ever reaches this process. Run directly for local development: diff --git a/RI/src/emcp_bus/audit/models.py b/RI/src/emcp_bus/audit/models.py index 7f0fd79..4259cd7 100644 --- a/RI/src/emcp_bus/audit/models.py +++ b/RI/src/emcp_bus/audit/models.py @@ -3,7 +3,7 @@ Adopts the IC/NOC/GRL taxonomy from the Agent Platform OCI reference (ADR-022, docs/research/hoshikawa-agent-platform-oci.md) as the `EventEnvelope.category` classification, rather than inventing a parallel -one: IC (Interação de Cliente/negócio-jornada), NOC (operacional/erro), GRL +one: IC (Indicador de Controle/negócio-jornada), NOC (operacional/erro), GRL (guardrail/governança). `decision_id`/`policy_decision_id`/`entitlement_version` (ADR-017, EP-08-T03) travel as first-class correlation fields on every event, not as opaque payload keys, so a consumer can join events across the chain @@ -27,7 +27,7 @@ class EventCategory(StrEnum): """README.md §27 event classes, mapped onto the Hoshikawa IC/NOC/GRL vocabulary.""" IC = "ic" - """Interação de Cliente / negócio-jornada: the call progressed normally + """Indicador de Controle / negócio-jornada: the call progressed normally (e.g. `client_authenticated`, `tool_call_allowed`).""" NOC = "noc" diff --git a/docs/adr/ADR-001-teto-de-privilegio-do-agente.md b/docs/adr/ADR-001-teto-de-privilegio-do-agente.md index b87720c..9142353 100644 --- a/docs/adr/ADR-001-teto-de-privilegio-do-agente.md +++ b/docs/adr/ADR-001-teto-de-privilegio-do-agente.md @@ -1,7 +1,7 @@ # ADR-001: Fronteira de MaximumEntitlement no MCP Client **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-002-enforcement-no-gateway.md b/docs/adr/ADR-002-enforcement-no-gateway.md index 75d6096..e41dfd5 100644 --- a/docs/adr/ADR-002-enforcement-no-gateway.md +++ b/docs/adr/ADR-002-enforcement-no-gateway.md @@ -1,7 +1,7 @@ # ADR-002: MCP Gateway como PEP unico **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-003-reautorizacao-de-tools-call.md b/docs/adr/ADR-003-reautorizacao-de-tools-call.md index df5f7b1..fb73566 100644 --- a/docs/adr/ADR-003-reautorizacao-de-tools-call.md +++ b/docs/adr/ADR-003-reautorizacao-de-tools-call.md @@ -1,7 +1,7 @@ # ADR-003: Reautorizacao independente em tools/call **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-004-contexto-nunca-eleva-privilegio.md b/docs/adr/ADR-004-contexto-nunca-eleva-privilegio.md index a70ceed..b6e9883 100644 --- a/docs/adr/ADR-004-contexto-nunca-eleva-privilegio.md +++ b/docs/adr/ADR-004-contexto-nunca-eleva-privilegio.md @@ -1,7 +1,7 @@ # ADR-004: Contexto agentico nunca eleva privilegio **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-005-cache-privado-de-tools-list.md b/docs/adr/ADR-005-cache-privado-de-tools-list.md index 999a884..9e00a61 100644 --- a/docs/adr/ADR-005-cache-privado-de-tools-list.md +++ b/docs/adr/ADR-005-cache-privado-de-tools-list.md @@ -1,7 +1,7 @@ # ADR-005: Cache privado de tools/list **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-006-sem-token-passthrough.md b/docs/adr/ADR-006-sem-token-passthrough.md index ad9abf6..305a687 100644 --- a/docs/adr/ADR-006-sem-token-passthrough.md +++ b/docs/adr/ADR-006-sem-token-passthrough.md @@ -1,7 +1,7 @@ # ADR-006: Proibicao de token passthrough **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-007-backend-nao-exposto-diretamente.md b/docs/adr/ADR-007-backend-nao-exposto-diretamente.md index d5cb119..a513642 100644 --- a/docs/adr/ADR-007-backend-nao-exposto-diretamente.md +++ b/docs/adr/ADR-007-backend-nao-exposto-diretamente.md @@ -1,7 +1,7 @@ # ADR-007: Backend nunca exposto diretamente ao client **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-008-segmentacao-por-dominio-e-risco.md b/docs/adr/ADR-008-segmentacao-por-dominio-e-risco.md index 5e336df..aab8452 100644 --- a/docs/adr/ADR-008-segmentacao-por-dominio-e-risco.md +++ b/docs/adr/ADR-008-segmentacao-por-dominio-e-risco.md @@ -1,7 +1,7 @@ # ADR-008: Segmentacao de clients por dominio e risk tier **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-009-risk-tiers-de-capabilities.md b/docs/adr/ADR-009-risk-tiers-de-capabilities.md index 5585ff7..564e338 100644 --- a/docs/adr/ADR-009-risk-tiers-de-capabilities.md +++ b/docs/adr/ADR-009-risk-tiers-de-capabilities.md @@ -1,7 +1,7 @@ # ADR-009: Risk tiers R0-R4 para capabilities **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-010-governanca-do-registry.md b/docs/adr/ADR-010-governanca-do-registry.md index a38c0f8..53821eb 100644 --- a/docs/adr/ADR-010-governanca-do-registry.md +++ b/docs/adr/ADR-010-governanca-do-registry.md @@ -1,7 +1,7 @@ # ADR-010: Governanca do Global Capability Registry **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-011-pipeline-de-publicacao.md b/docs/adr/ADR-011-pipeline-de-publicacao.md index 08a9a4d..3af8443 100644 --- a/docs/adr/ADR-011-pipeline-de-publicacao.md +++ b/docs/adr/ADR-011-pipeline-de-publicacao.md @@ -1,7 +1,7 @@ # ADR-011: Pipeline obrigatorio de publicacao de capabilities **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-012-entitlement-manager-como-autoridade.md b/docs/adr/ADR-012-entitlement-manager-como-autoridade.md index e11c367..a26dec4 100644 --- a/docs/adr/ADR-012-entitlement-manager-como-autoridade.md +++ b/docs/adr/ADR-012-entitlement-manager-como-autoridade.md @@ -1,7 +1,7 @@ # ADR-012: Entitlement Manager como autoridade unica de MaximumEntitlement **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-013-contrato-de-profile-intelligence.md b/docs/adr/ADR-013-contrato-de-profile-intelligence.md index 9758bf2..4141393 100644 --- a/docs/adr/ADR-013-contrato-de-profile-intelligence.md +++ b/docs/adr/ADR-013-contrato-de-profile-intelligence.md @@ -1,7 +1,7 @@ # ADR-013: Contrato plugavel de Profile Intelligence **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-014-perfil-nunca-amplia-entitlement.md b/docs/adr/ADR-014-perfil-nunca-amplia-entitlement.md index e596b07..e62cc6b 100644 --- a/docs/adr/ADR-014-perfil-nunca-amplia-entitlement.md +++ b/docs/adr/ADR-014-perfil-nunca-amplia-entitlement.md @@ -1,7 +1,7 @@ # ADR-014: Perfil nunca amplia entitlement **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-015-nba-nao-e-autorizacao.md b/docs/adr/ADR-015-nba-nao-e-autorizacao.md index 246717a..f34c198 100644 --- a/docs/adr/ADR-015-nba-nao-e-autorizacao.md +++ b/docs/adr/ADR-015-nba-nao-e-autorizacao.md @@ -1,7 +1,7 @@ # ADR-015: NBA como decisao de orquestracao, nao de autorizacao **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-016-contrato-de-dispatch-handoff.md b/docs/adr/ADR-016-contrato-de-dispatch-handoff.md index 0cca1d4..9822c91 100644 --- a/docs/adr/ADR-016-contrato-de-dispatch-handoff.md +++ b/docs/adr/ADR-016-contrato-de-dispatch-handoff.md @@ -1,7 +1,7 @@ # ADR-016: Contrato de dispatch/handoff do Agent Runtime **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-017-correlacao-ponta-a-ponta.md b/docs/adr/ADR-017-correlacao-ponta-a-ponta.md index d86179a..70b5e20 100644 --- a/docs/adr/ADR-017-correlacao-ponta-a-ponta.md +++ b/docs/adr/ADR-017-correlacao-ponta-a-ponta.md @@ -1,7 +1,7 @@ # ADR-017: Correlacao ponta a ponta via IDs versionados **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-018-stack-de-implementacao.md b/docs/adr/ADR-018-stack-de-implementacao.md index 5fe3255..4c7a3fa 100644 --- a/docs/adr/ADR-018-stack-de-implementacao.md +++ b/docs/adr/ADR-018-stack-de-implementacao.md @@ -1,7 +1,7 @@ # ADR-018: Stack de implementacao da RI **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-019-identity-extension.md b/docs/adr/ADR-019-identity-extension.md index da6d215..b33d922 100644 --- a/docs/adr/ADR-019-identity-extension.md +++ b/docs/adr/ADR-019-identity-extension.md @@ -1,10 +1,9 @@ # ADR-019: MCP Client identity -- production extension point (mTLS / workload identity) **Status:** Documented (spike), not implemented in the RI (EP-01-T04, `could`). -**Related:** this ADR is the canonical record of this decision -- no longer generated from -`docs/RI-PLANNING.md` (removed from the repository after M4 completed; history preserved in -git). See `RI/docs/AS-BUILT.md` and `RI/docs/interfaces/identity-oidc.md` for implementation and -validation context. Also relevant: README.md §19, RF-02, Axiom 2. +**Related:** this ADR is the canonical record of this decision. See `RI/docs/AS-BUILT.md` and +`RI/docs/interfaces/identity-oidc.md` for implementation and validation context. Also relevant: +README.md §19, RF-02, Axiom 2. ## Context diff --git a/docs/adr/ADR-020-downstream-identity.md b/docs/adr/ADR-020-downstream-identity.md index 834f2a4..e78c683 100644 --- a/docs/adr/ADR-020-downstream-identity.md +++ b/docs/adr/ADR-020-downstream-identity.md @@ -1,7 +1,7 @@ # ADR-020: Downstream identity: token exchange ou service account isolado **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-021-escopo-langgraph-langfuse.md b/docs/adr/ADR-021-escopo-langgraph-langfuse.md index c5b1b8b..450cfa7 100644 --- a/docs/adr/ADR-021-escopo-langgraph-langfuse.md +++ b/docs/adr/ADR-021-escopo-langgraph-langfuse.md @@ -1,7 +1,7 @@ # ADR-021: Escopo de LangGraph e Langfuse na RI **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-022-referencia-hoshikawa-agent-platform-oci.md b/docs/adr/ADR-022-referencia-hoshikawa-agent-platform-oci.md index 9ec2400..5c45131 100644 --- a/docs/adr/ADR-022-referencia-hoshikawa-agent-platform-oci.md +++ b/docs/adr/ADR-022-referencia-hoshikawa-agent-platform-oci.md @@ -1,7 +1,7 @@ # ADR-022: Referencia operacional: Agent Platform OCI (Hoshikawa) **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md b/docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md index b7a558b..52f0014 100644 --- a/docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md +++ b/docs/adr/ADR-023-autorizacao-nunca-vem-do-payload.md @@ -1,7 +1,7 @@ # ADR-023: Autorizacao de tools nunca vem de campo declarado no payload **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-024-posicionamento-multiagente.md b/docs/adr/ADR-024-posicionamento-multiagente.md index 3b81f06..76a7c2b 100644 --- a/docs/adr/ADR-024-posicionamento-multiagente.md +++ b/docs/adr/ADR-024-posicionamento-multiagente.md @@ -1,7 +1,7 @@ # ADR-024: Posicionamento do E-MCP-BUS frente a plataformas multiagente externas **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto diff --git a/docs/adr/ADR-025-engine-do-pdp.md b/docs/adr/ADR-025-engine-do-pdp.md index d06e658..5589117 100644 --- a/docs/adr/ADR-025-engine-do-pdp.md +++ b/docs/adr/ADR-025-engine-do-pdp.md @@ -1,7 +1,7 @@ # ADR-025: OPA/Rego como engine do PDP **Status:** Aceito. -**Fonte:** este ADR é o registro canônico desta decisão — não é mais gerado a partir de `docs/RI-PLANNING.md` (removido do repositório após a conclusão do marco M4; histórico preservado no git). Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. +**Fonte:** este ADR é o registro canônico desta decisão. Para contexto de implementação e validação, ver `RI/docs/AS-BUILT.md` e, quando aplicável, o contrato relevante em `RI/docs/interfaces/`. ## Contexto