Skip to content

Guarantee durable settlement recovery - #91

Merged
amavashev merged 3 commits into
mainfrom
agent/recovery-conformance-hardening
Jul 29, 2026
Merged

Guarantee durable settlement recovery#91
amavashev merged 3 commits into
mainfrom
agent/recovery-conformance-hardening

Conversation

@amavashev

@amavashev amavashev commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • writes pending commit and expiry-event fallback state atomically before the first settlement request
  • recovers expired reservations through POST /v1/events and replays unresolved settlement across restart with the same idempotency key
  • accepts only exact, schema-valid HTTP 200 commit and HTTP 201 event responses as terminal success
  • quarantines corrupt, structurally invalid, and unsupported-version journal records while continuing valid replay
  • replaces collision-prone legacy journal filenames with the shared full-SHA-256 identity and safe migration
  • proves lost-response, restart, rate-limit, key-rotation, concurrent-replay, heartbeat, and known-actual-boundary behavior with exact native tests
  • pins CI and publishing to the reviewed protocol profile 0.3 commit

Context

Ports the durable journal and expiry-event recovery guarantees already present in other SDKs and implements the contract in runcycles/cycles-protocol#149.

Validation

  • full Python 3.10 and 3.12 lint/test jobs pass
  • source MyPy and Ruff checks pass
  • complete 12-scenario recovery conformance matrix passes
  • all latest-head PR checks pass

@amavashev
amavashev marked this pull request as ready for review July 29, 2026 12:27
@amavashev
amavashev merged commit e749fd3 into main Jul 29, 2026
8 checks passed
@amavashev
amavashev deleted the agent/recovery-conformance-hardening branch July 29, 2026 14:03
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