Skip to content

T001: S3-based distributed task coordination#8

Merged
grobomo merged 1 commit intomainfrom
004-T001-distributed-claims
Apr 4, 2026
Merged

T001: S3-based distributed task coordination#8
grobomo merged 1 commit intomainfrom
004-T001-distributed-claims

Conversation

@grobomo
Copy link
Copy Markdown
Owner

@grobomo grobomo commented Apr 4, 2026

Summary

  • distributed_claims.py: S3 backend for multi-machine task and spec claims
  • Race detection, heartbeat/lease expiry, metrics aggregation
  • 13/13 E2E tests pass against live S3 (hackathon26-state bucket)

Features

  • Task claims — claim/release tasks via S3 objects with lease timeout
  • Spec claims — exclusive spec generation rights per feature
  • Race detection — logs when two instances claim within configurable window (default 5s)
  • Heartbeat — instances refresh lease, stale claims auto-expire (default 10min)
  • Metrics — contention rate, completion time, per-instance activity via JSONL

Test plan

  • 13/13 E2E tests: claim, duplicate claim blocked, release, not-owner blocked, spec claim/release, heartbeat refresh, lease expiry after timeout, metrics aggregation

- distributed_claims.py: S3 backend for multi-machine task claims
- Spec claims: exclusive spec generation rights per feature
- Race detection: logs when two instances claim within 5s window
- Heartbeat/lease expiry: configurable timeout (default 10min)
- Metrics: contention rate, completion time, instance tracking
- 13/13 E2E tests pass against live S3
@grobomo grobomo merged commit 65e73be into main Apr 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant