first commit

2026-07-11 14:56:10 +08:00
commit 7e05d0a4e7
660 changed files with 78119 additions and 0 deletions
@@ -0,0 +1,23 @@
+# 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.