AgileWebs/building-block-catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
c7b0bc4061
building-block-catalog/docs/contracts/catalog-versioning-policy.md
José René White Enciso c149695569 feat(contracts): add transport-neutral catalog contracts 
- WHY: align catalog contracts with protocol-agnostic integration boundaries
- WHAT: add contract conventions, grpc adapter surfaces, and blueprint descriptor consumption
- RULE: enforce building-block to blueprint dependency direction
2026-02-22 03:28:32 -06:00

659 B
Raw Blame History

Catalog Versioning Policy

Policy

  • Prefer additive contract evolution to keep consumer compatibility.
  • Breaking changes require major version increments.
  • Deprecated members remain through one deprecation cycle.

Blueprint Compatibility

  • Package descriptor metadata is implemented via IBlueprintPackageContract from Core.Blueprint.Common.Contracts.
  • Catalog contracts consume Blueprint common contract primitives rather than redefining them.

Compatibility Notes

  • Consumers (furniture-dal, furniture-service, furniture-bff) update explicitly.
  • Protocol adapters remain edge concerns; catalog contracts remain transport-neutral.