zlh-grind/Codex/Agent/DECISIONS.md

26 lines
1.5 KiB
Markdown

# Agent - Decisions
## Settled
- semantic readiness is real workload readiness, not mere process liveness.
- readiness-aware start/restart behavior should not be bypassed.
- guarded mutating operations should remain serialized.
- local Minecraft backups are an agent responsibility.
- PBS / platform backups are a separate durability/disaster-recovery layer.
- do not conflate app-aware rollback backups with infra/offsite backup strategy.
## Dev container / code-server
- requested code-server is desired Agent state for dev containers, not only a manual endpoint action.
- if `enable_code_server` is true or `addons` includes `codeserver`, dev provisioning should ensure code-server is installed, running, and verifiable.
- manual code-server start/stop/restart endpoints remain operational controls, but initial provisioning should not require a separate manual start call.
- code-server install/config and service start should remain separate paths: manual start must not rerun the installer script.
- code-server config should omit empty `proxy-domain`; an empty value causes code-server to exit on startup.
## Backup-specific
- current local game backup scope is Minecraft only.
- pre-restore checkpoint is the first restore-safety hardening step.
- remote/offsite syncing should not be added to agent if that responsibility belongs to PBS/platform.
## Tracking rule
- when Agent work completes, remove it from `OPEN_ITEMS.md`
- if it changes long-lived runtime/recovery assumptions, update `CURRENT_STATE.md` or this file