2.8 KiB
2.8 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-vm-owned-builtins-protocol-and-system-services.md002-filesystem-surface-and-semantics.md003-filesystem-fault-semantics.md004-gfx-fault-semantics-and-command-contract.md005-audio-fault-semantics-and-surface.md006-asset-fault-semantics-and-surface.md007-runtime-edge-test-plan.md008-packed-cartridge-loader-pmc.md009-system-run-cart.md010-system-fault-semantics-and-control-surface.md
Sequenciamento Recomendado
Ordem sugerida para discussão e futura execução:
001-vm-owned-builtins-protocol-and-system-services.md002-filesystem-surface-and-semantics.md003-filesystem-fault-semantics.md004-gfx-fault-semantics-and-command-contract.md005-audio-fault-semantics-and-surface.md006-asset-fault-semantics-and-surface.md007-runtime-edge-test-plan.md008-packed-cartridge-loader-pmc.md009-system-run-cart.md010-system-fault-semantics-and-control-surface.md
Justificativa curta:
001vem primeiro para fechar o protocolo VM-owned stateful que destrava extensoes como random/window resources sem mexer em syscall host-backed.002e003ficam na sequencia para fecharfscom superficie e fault semantics consistentes.004,005e006consolidam fault semantics por dominio com base na decisao004.007vem depois para transformar as decisoes em cobertura de regressao na borda do runtime.008e importante, mas nao bloqueia bytecode/backend agora.009e010ficam no fim porquerun_cartnao e objetivo do ciclo atual.
Dependências principais:
001deve alinhar com16/16a, alem das decisoes003,004e005002depende das decisoes003e004003depende das decisoes003,004e da002004depende da decisao004005depende da decisao004006depende da decisao004007depende da estabilizacao minima das agendas de superficie/fault por dominio008depende de contrato fechado de13-cartridge.md+ comportamento equivalente ao loader de diretorio009depende das decisoes003,004,005e deve alinhar com002quando usarfs010depende da decisao004e da009
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.