Prepare Rakestrawhome catalog version two contract

This commit is contained in:
2026-09-22 12:11:24 +00:00
parent 2edad4f8e0
commit d664696142
3 changed files with 37 additions and 12 deletions

View File

@@ -17,11 +17,19 @@ of extracting a dependency.
## Compatibility
Catalog IDs are stable. New profiles are additive. Corrections are released as
compatible catalog updates when they preserve the profile contract; deprecated
profiles are announced before removal in a compatible-major release. Manifest
schema changes follow semantic-version compatibility rules and retain support
for compatible published catalog versions.
This compatibility policy applies to the `/v2` module. Catalog profiles track
upstream availability and may be added, removed, renamed, or modified without
deprecation or advance notice. Consumers that need a particular profile set
should use the catalog version selected by their Promptkit release.
Backend definitions, the exported Go API, and the catalog manifest schema do
not share that profile-data exception. Their compatibility follows the normal
semantic-versioning rules. Published v1 releases retain their historical
contract; this README does not retroactively alter it.
Catalog releases use dated versions in the form `v2.YYYYMMDD.N`. The date
identifies when the catalog snapshot was published in UTC; it does not certify
that a provider currently offers a model or endpoint named by the data.
## Validation and releases