2.7 KiB
2.7 KiB
Agendas
Este diretório reúne agendas de discussão arquitetural para itens pendentes ou frágeis do runtime.
Objetivo:
- explicitar a dor real do sistema;
- delimitar o que precisa ser decidido antes de codar;
- servir de base para futuras PRs de implementação JVM-grade.
As agendas atuais são:
001-system-run-cart.md002-packed-cartridge-loader-pmc.md003-vm-owned-byte-buffer-abi.md004-syscall-fault-classification.md005-runtime-edge-test-plan.md009-filesystem-surface-and-semantics.md010-input-intrinsics-surface.md011-input-frame-semantics-and-portability.md
Sequenciamento Recomendado
Ordem sugerida para discussão e futura execução:
007-single-canonical-architecture.md008-hardware-specs-reorganization.md006-break-monolith-runtime.md003-vm-owned-byte-buffer-abi.md004-syscall-fault-classification.md009-filesystem-surface-and-semantics.md010-input-intrinsics-surface.md011-input-frame-semantics-and-portability.md005-runtime-edge-test-plan.md001-system-run-cart.md002-packed-cartridge-loader-pmc.md
Justificativa curta:
007vem primeiro porque elimina ambiguidade sobre qual documento manda.008vem em seguida porque reorganiza o terreno documental onde specs e arquitetura se apoiam.006entra depois porque refactor estrutural grande sem documentação estável tende a cristalizar decisões erradas.003fecha o contrato base para trafego de bytes VM-owned.004fecha a taxonomia de falhas quefse outras bordas vao reutilizar.009usa003e004para fechar o dominio de filesystem sem texto improvisado.010e011isolam o dominio maior de input fora de syscall, tratandopadetouchcomo superfícies centrais,buttoncomo parte depad, e explicitando a migracao da leitura de input para intrinsics.005fecha a barra de qualidade antes das implementações mais arriscadas.001e002dependem mais fortemente de contrato de sistema, ABI e documentação estáveis.
Dependências principais:
008depende de007006depende de007009depende de003e004010depende de007011depende de010001depende de007,003,004,005e deve alinhar com009quando usarfs002depende de007e deve ser alinhada com a reorganização documental de008
Regra de uso:
- se a implementação exigir decisão estrutural, ela deve nascer daqui antes de virar PR de código;
- se uma agenda já estiver resolvida, a PR derivada deve citar explicitamente qual decisão foi tomada;
- se a agenda revelar ambiguidade demais, ela não deve ser convertida em PR até o alvo ficar preciso.