blueprint-platform/docs/consumption/semantic-versioning-policy.md

698 B

Semantic Versioning Policy

Default Policy

  • Patch: backward-compatible fixes.
  • Minor: backward-compatible contract additions.
  • Major: breaking contract changes.

Stable Baseline Policy

  • Stable decoupling baseline starts at 0.2.0.
  • All blueprint package outputs in the same release wave must share the same version.
  • Breaking changes after baseline require major or minor strategy review before publication.

Contract Compatibility

  • Module package contracts are represented as descriptors implementing IBlueprintPackageContract.
  • Consumer-impacting contract changes require version policy review before publish.
  • Blueprint package contracts must remain identity-agnostic.