24 lines
888 B
Markdown
24 lines
888 B
Markdown
# AGENTS.md for run
|
|
|
|
This file applies to `run/`.
|
|
|
|
## Channel Rules
|
|
|
|
Do not rebuild the old all-in-one WebSocket model. Keep these workloads separate:
|
|
|
|
- Control: hello, heartbeat, version, capabilities, capacity.
|
|
- Job: claim, ack, progress, result, cancel, reconcile.
|
|
- Logs: local spool, batch upload, sequence acknowledgement, retry.
|
|
- Artifacts: chunks, checksums, resume, throttling.
|
|
- Game client bridge: optional in-game command/snapshot channel.
|
|
|
|
Artifact transfer must not block control heartbeats, job result reporting, or log upload.
|
|
|
|
## Structure Rules
|
|
|
|
Protocol structs live in `protocol/`. Local runtime types live in `runtime/` or `domain/`. Shared helpers live in `shared/` only when needed by multiple packages.
|
|
|
|
## Safety Rules
|
|
|
|
Run must enforce scoped paths and never expose raw host paths, local secrets, or unrestricted command execution to platform_web or plugins.
|