prometeu-runtime/docs/runtime/agendas/016-filesystem-fault-semantics.md

48 lines
1.3 KiB
Markdown

# Agenda - Filesystem Fault Semantics
## Problema
O dominio `fs` certamente precisara de politica de fault propria, mas ainda depende de duas discussoes anteriores:
- a decisao `003` sobre transporte de bytes;
- a agenda `009` sobre superficie e semantica funcional de filesystem.
Discutir fault semantics antes disso tende a cristalizar classificacao em cima de uma API que ainda pode mudar.
## Alvo da Discussao
Fechar a politica de fault de `fs` somente depois da agenda `009`.
## O Que Precisa Ser Definido
1. Fronteira entre `status` e `Trap` em `fs`.
2. Politica para:
- handle invalido;
- path invalido;
- arquivo ausente;
- permissao negada;
- EOF;
- escrita parcial;
- storage full;
- mount indisponivel.
3. Integracao com o protocolo de bytes da decisao `003`.
4. Shape final de retorno das operacoes de `fs`.
## Dependencias
- `../decisions/003-vm-owned-byte-transfer-protocol.md`
- `../decisions/004-host-fault-taxonomy.md`
- `009-filesystem-surface-and-semantics.md`
## Regra de Sequenciamento
Esta agenda nao deve ser discutida antes da `009`.
## Critério de Saida Desta Agenda
Pode virar PR quando houver decisao escrita sobre:
- matriz de `status`/`Trap`/`Panic` para `fs`;
- integracao final com `read`/`write`;
- relacao entre semantica funcional de `fs` e fault semantics.