prometeu-studio/docs/compiler/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md

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.