20 lines
881 B
Markdown
20 lines
881 B
Markdown
# 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.
|