spec log spool batch uploads

2026-08-10 18:32:31 +08:00
parent ba2b1a9d9f
commit bd444f04b9
5 changed files with 114 additions and 0 deletions
@@ -0,0 +1,24 @@
+## Why
+
+Run currently persists and uploads one HTTP log batch for every captured output line. High-volume startup output can create thousands of pending requests faster than the five-second uploader window can acknowledge them, leaving the management terminal far behind the supervised process.
+
+## What Changes
+
+- Coalesce contiguous pending entries from the same Run log stream into bounded durable upload batches.
+- Drain available log backlog continuously within bounded upload work so current output reaches the platform promptly without blocking control, job, or artifact channels.
+- Preserve per-stream sequence continuity, checksums, retry retention, and acknowledgement semantics when a batch is rebuilt or retried.
+
+## Capabilities
+
+### New Capabilities
+
+- `run-log-batch-upload`: Run-side durable aggregation and bounded delivery of supervised-process log streams.
+
+### Modified Capabilities
+
+- None.
+
+## Impact
+
+- Affects `run/spool` pending-log representation and flush behavior, plus `run/runtime` process-log spooling and uploader scheduling.
+- Does not change platform API routes, browser contracts, game-specific lifecycle behavior, or artifact/control/job channels.