60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
# PR-05.0.6 - Host Binding Key Interning and Capability Identity
|
|
|
|
## Briefing
|
|
|
|
A validacao de host admission ainda usa chave composta em string (`module|method|version`) para deduplicacao e consistencia.
|
|
|
|
Esta PR troca chave textual por identidade internada de binding host e prepara capacidade para validacoes mais seguras.
|
|
|
|
## Motivation
|
|
|
|
### Dor que esta PR resolve
|
|
|
|
1. Concatenacao textual para chave critica de ABI e fragil.
|
|
2. Risco de bug por normalizacao inconsistente de partes da chave.
|
|
3. Menor clareza para evoluir validacao de capabilities por dominio tipado.
|
|
|
|
## Target
|
|
|
|
Internar identidade canonica de host binding em tabela dedicada e usar ID no validador de host admission.
|
|
|
|
## Scope
|
|
|
|
1. `PbsHostAdmissionValidator`.
|
|
2. Infra de tabela de binding host no core/frontend.
|
|
3. Ajustes em metadados reservados quando necessario.
|
|
|
|
## Non-Goals
|
|
|
|
1. Nao altera semantica de capability policy.
|
|
2. Nao altera contrato de host ABI no runtime.
|
|
|
|
## Method
|
|
|
|
### O que deve ser feito explicitamente
|
|
|
|
1. Introduzir valor canônico `HostBindingRef(module,name,version)` e tabela internada.
|
|
2. Substituir map com chave string por map com `HostBindingId` (ou `HostBindingRef` internado).
|
|
3. Manter normalizacao de capability separada da identidade de binding.
|
|
4. Preservar diagnosticos com referencias claras ao binding original.
|
|
|
|
## Acceptance Criteria
|
|
|
|
1. `PbsHostAdmissionValidator` nao usa mais chave formatada por string para binding.
|
|
2. Inconsistencia de capability para mesmo binding continua detectada de forma deterministica.
|
|
3. Nao ha regressao em cenarios conhecidos de host admission.
|
|
|
|
## Tests
|
|
|
|
1. Teste de deduplicacao de binding por identidade internada.
|
|
2. Teste de mismatch de capability para mesmo binding.
|
|
|
|
## Affected Documents
|
|
|
|
1. `docs/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md`
|
|
2. `docs/pbs/specs/13. Lowering IRBackend Specification.md`
|
|
|
|
## Open Questions
|
|
|
|
Sem bloqueios arquiteturais.
|