Patching Standards
Active Evaluation FINOS Labs This material is provisional and has not been published as a formal FINOS standard.
Home / Standards / REL-003
REL-003

Backpatch Version Metadata

Patched releases use SemVer metadata in the form `+backpatch.NNN`.

Status
Draft
Category
Release Process
Applies to
Patch providers, Enterprise recipients

Requirement

Patch providers SHOULD release patched artifacts using SemVer build metadata in the form:

<UPSTREAM_VERSION>+backpatch.NNN

NNN MUST be monotonically increasing for the same upstream version line.

Rationale

This form preserves the upstream version while making the patched artifact distinguishable. It also works well with build tools whose dynamic resolution behavior uses lexicographic ordering.

Examples

5.3.39+backpatch.001
5.3.39+backpatch.002

Observed OSERA examples

Public OSERA repositories currently include release tags such as:

  • backpatch-spring-framework: v5.3.39+backpatch.001
  • backpatch-gson: v2.8.8+backpatch.001
  • backpatch-activemq: v5.14.5+backpatch.001