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

18 lines
659 B
Markdown

# 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.