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 em16a.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 com06,16e16a, alem da decisao003002depende da decisao003e de16a003depende da decisao003, de16ae da002004depende de16a005depende de16a006depende de16a007depende da estabilizacao minima das agendas de superficie/fault por dominio008depende de contrato fechado de13-cartridge.md+ comportamento equivalente ao loader de diretorio009depende da decisao003, de16ae de06, e deve alinhar com002quando usarfs010depende de16ae 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.