Skip to content

Sync response paging and metrics are still coarse #177

Description

@flyingrobots

Migrated from Method backlog

GitHub Issues are now the live work tracker. Repository docs remain Method evidence.

Field Value
Source backlog docs/method/backlog/bad-code/HEX_sync-response-paging-and-metrics.md
Archived source docs/archive/backlog/github-issue-migration-2026-06-01/docs/method/backlog/bad-code/HEX_sync-response-paging-and-metrics.md
Original lane bad-code
Original id HEX_sync-response-paging-and-metrics
Original legend HEX
Original feature sync-trust-security
Original release home v19.0.0

Original backlog card

Sync response paging and metrics are still coarse

Effort: M

What's Wrong

Cycle 0139-sync-rate-limiting bounded request admission per key id, but
processSyncRequest can still produce large patch responses for broad or
empty frontiers. Operators also lack first-class latency and payload-size
metrics for sync responses.

This is not the same release blocker as missing rate limiting: the endpoint
now has an auth admission budget. The remaining concern is response shaping
and observability under legitimate sync workloads.

Suggested Fix

Add an explicit response paging contract for sync responses, with a maximum
patches-per-response budget and continuation token or cursor. Emit sync
latency and payload-size metrics through a logging or metrics port so
operators can see large frontier catches before they become incidents.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:syncPrimary work area: sync.feature:sync-trust-securityMethod feature sync-trust-security.legend:hexMethod legend hex.priority:laterDeferred or speculative work.release-home:v19.0.0Method release home v19.0.0.status:availableOpen and available for prioritization; not blocked or actively in progress.type:debtDebt, rot, or structural risk.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions