Skip to content

Document staging wire schema v3 upgrade path #5263

Closed as not planned
Closed as not planned

Description

@linear-code

Gym #4128 moved the capture staging wire schema to version 3. Gym and every external-staging worker must upgrade together, including deployments using ordinary capture with fingerprint parent resolution. Version 2 admissions, staged rows, receipts and checkpoints are incompatible and no migration is provided.

Acceptance criteria

  • Upgrade runbook covering: finishing or retiring in-flight attempts, upgrading Gym and workers together, and not resuming persisted v2 data
  • Clear failure mode documented for a version mismatch (for example, invalid_manifest_row masking)
  • Linked from the model-call capture docs and the release notes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions