init

2026-08-26 09:56:43 +08:00
parent 2b4974b561
commit 8e02a316fa
93 changed files with 21749 additions and 0 deletions
@@ -0,0 +1,19 @@
+# run/spool
+
+Local durable queues live here.
+
+Required spool areas:
+
+- `logs`: unacknowledged log segments.
+- `jobs`: accepted job journal for duplicate detection and reconciliation.
+- `artifacts`: incomplete artifact transfer state.
+
+Spool pressure must be visible in run capacity reports.
+
+## Channel Isolation
+
+- Log and artifact retry state are stored in separate spool areas and are acknowledged independently.
+- Acknowledging a log batch must not scan, remove, or block on artifact chunks.
+- Acknowledging an artifact chunk must not scan, remove, or block on log batches.
+- Control heartbeat and job ack/result payloads remain metadata-only; they must never carry spool file paths, artifact chunks, log entries, raw credentials, direct sockets, or large inline bodies.
+- Artifact transfer backlog is lower priority than log flush, job lifecycle calls, and control heartbeat.