Skip to content

feat(release): add lifecycle semver contract #309

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
davida-ps wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

feat(release): add lifecycle semver contract #309

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
269 changes: 269 additions & 0 deletions contracts/fixtures/lifecycle-semver-v1.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,269 @@
{
"contract": "clawsec.lifecycle-semver.fixtures/v1",
"valid_versions": [
{
"input": "0.0.0",
"core": ["0", "0", "0"],
"prerelease": [],
"build": []
},
{
"input": "0.1.0-beta.1",
"core": ["0", "1", "0"],
"prerelease": ["beta", "1"],
"build": []
},
{
"input": "1.2.3-01alpha.7+build.001.sha-1",
"core": ["1", "2", "3"],
"prerelease": ["01alpha", "7"],
"build": ["build", "001", "sha-1"]
},
{
"input": "18446744073709551616.99999999999999999999.0",
"core": ["18446744073709551616", "99999999999999999999", "0"],
"prerelease": [],
"build": []
},
{
"input": "1.0.0-x-y-z.--+meta",
"core": ["1", "0", "0"],
"prerelease": ["x-y-z", "--"],
"build": ["meta"]
}
],
"invalid_versions": [
"",
"1",
"1.2",
"1.2.3.4",
"01.2.3",
"1.02.3",
"1.2.03",
"1.2.3-",
"1.2.3-alpha..1",
"1.2.3-alpha_1",
"1.2.3-01",
"1.2.3+",
"1.2.3+build..1",
"v1.2.3",
" 1.2.3",
"1.2.3 ",
"1.2.3\n",
"1.2.3-β",
null,
123,
[],
{}
],
"precedence_chains": [
[
"1.0.0-alpha",
"1.0.0-alpha.1",
"1.0.0-alpha.beta",
"1.0.0-beta",
"1.0.0-beta.2",
"1.0.0-beta.11",
"1.0.0-rc.1",
"1.0.0"
],
[
"0.1.0-beta.1",
"0.1.0-beta.2",
"0.1.0-rc.1",
"0.1.0"
],
[
"1.99999999999999999999.0",
"2.0.0",
"18446744073709551615.0.0",
"18446744073709551616.0.0"
],
[
"1.0.0-99999999999999999999",
"1.0.0-100000000000000000000",
"1.0.0-alpha"
]
],
"equal_precedence": [
["1.0.0+build.1", "1.0.0+build.2"],
["1.0.0-alpha+one", "1.0.0-alpha+two"]
],
"package_tags": {
"valid": [
{
"input": "clawsec-core-openclaw-v0.1.0",
"package_name": "clawsec-core-openclaw",
"version": "0.1.0"
},
{
"input": "agent-v-tools-v1.2.3-rc.1",
"package_name": "agent-v-tools",
"version": "1.2.3-rc.1"
},
{
"input": "clawsec-v1.2.3+build.7",
"package_name": "clawsec",
"version": "1.2.3+build.7"
}
],
"invalid": [
"",
"clawsec-1.2.3",
"-v1.2.3",
"ClawSec-v1.2.3",
"clawsec--core-v1.2.3",
"clawsec-vv1.2.3",
"clawsec-v1.2",
"clawsec-v01.2.3",
null,
123
]
},
"format_tags": {
"valid": [
{
"package_name": "clawsec-core-hermes",
"version": "0.1.0-beta.1",
"expected": "clawsec-core-hermes-v0.1.0-beta.1"
},
{
"package_name": "agent-v-tools",
"version": "1.2.3+build.1",
"expected": "agent-v-tools-v1.2.3+build.1"
}
],
"invalid_package_names": ["", "ClawSec", "clawsec_kit", "-clawsec", "clawsec-", "clawsec--core", "clawsec\n"]
},
"classifications": [
{"version": "0.1.0-beta.0", "expected": "beta"},
{"version": "0.1.0-beta.12", "expected": "beta"},
{"version": "0.1.0-rc.1", "expected": "rc"},
{"version": "0.1.0", "expected": "final"},
{"version": "0.1.0+build.1", "expected": "final"},
{"version": "0.0.1-beta5", "expected": "legacy_prerelease"},
{"version": "0.1.0-rc1", "expected": "legacy_prerelease"},
{"version": "0.1.0-alpha.1", "expected": "legacy_prerelease"},
{"version": "0.1.0-preview", "expected": "legacy_prerelease"}
],
"publication_evaluations": [
{
"version": "0.1.0",
"lifecycle_class": "final",
"eligible": true,
"reason_code": "final_version_eligible_not_authorized"
},
{
"version": "0.1.0-beta.1",
"lifecycle_class": "beta",
"eligible": false,
"reason_code": "candidate_prerelease_lab_only"
},
{
"version": "0.1.0-rc.1",
"lifecycle_class": "rc",
"eligible": false,
"reason_code": "candidate_prerelease_lab_only"
},
{
"version": "0.1.0-beta5",
"lifecycle_class": "legacy_prerelease",
"eligible": false,
"reason_code": "legacy_prerelease_non_authorized"
},
{
"version": "0.1.0+build.1",
"lifecycle_class": "final",
"eligible": false,
"reason_code": "build_metadata_disallowed"
}
],
"lifecycle_bindings": {
"valid": [
{
"stage": "beta",
"artifactVersion": "0.1.0-beta.1",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": false
},
{
"stage": "rc",
"artifactVersion": "0.1.0-rc.2",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": false
},
{
"stage": "stable_intent",
"artifactVersion": "0.1.0",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": false
},
{
"stage": "stable",
"artifactVersion": "0.1.0",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": true
}
],
"invalid": [
{
"input": {
"stage": "beta",
"artifactVersion": "0.1.0-beta5",
"intendedVersion": "0.1.0"
},
"error": "canonical beta.N"
},
{
"input": {
"stage": "rc",
"artifactVersion": "0.1.0-rc.1",
"intendedVersion": "0.2.0"
},
"error": "same core version"
},
{
"input": {
"stage": "stable_intent",
"artifactVersion": "0.1.0-rc.1",
"intendedVersion": "0.1.0"
},
"error": "equal the final intendedVersion"
},
{
"input": {
"stage": "stable_intent",
"artifactVersion": "0.1.0",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": true
},
"error": "outside the active public catalog"
},
{
"input": {
"stage": "stable",
"artifactVersion": "0.1.0",
"intendedVersion": "0.1.0",
"activeCatalogAuthorized": false
},
"error": "active signed-catalog authorization"
},
{
"input": {
"stage": "stable",
"artifactVersion": "0.1.0+build.1",
"intendedVersion": "0.1.0"
},
"error": "must not contain build metadata"
},
{
"input": {
"stage": "preview",
"artifactVersion": "0.1.0-preview.1",
"intendedVersion": "0.1.0"
},
"error": "Unknown lifecycle stage"
}
]
}
}
63 changes: 63 additions & 0 deletions contracts/lifecycle-semver-v1.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
{
"contract": "clawsec.lifecycle-semver/v1",
"contract_version": 1,
"purpose": "Define strict SemVer syntax, package-qualified tags, lifecycle version classes, and publication eligibility without performing release or catalog writes.",
"semver": {
"standard": "Semantic Versioning 2.0.0",
"strict_input": true,
"numeric_representation": "unbounded decimal string",
"build_metadata_is_valid_syntax": true,
"build_metadata_affects_precedence": false,
"build_metadata_allowed_for_clawsec_publication_identity": false
},
"package_tag": {
"grammar": "<lowercase-kebab-package>-v<semver>",
"delimiter_rule": "Use the terminal -v suffix whose remainder is a valid SemVer version.",
"example": "clawsec-core-openclaw-v0.1.0"
},
"version_classes": {
"beta": "An exact -beta.N prerelease, where N is a canonical non-negative decimal identifier.",
"rc": "An exact -rc.N prerelease, where N is a canonical non-negative decimal identifier.",
"final": "A SemVer version with no prerelease identifiers; this does not itself prove stable status.",
"legacy_prerelease": "Any other valid SemVer prerelease, including beta5, rc1, alpha, and preview forms."
},
"lifecycle_stages": {
"beta": {
"artifact_version_class": "beta",
"distribution": "authenticated private lab only",
"active_catalog_authorized": false
},
"rc": {
"artifact_version_class": "rc",
"distribution": "authenticated private lab only",
"active_catalog_authorized": false
},
"stable_intent": {
"artifact_version_class": "final",
"artifact_version_equals_intended_version": true,
"distribution": "authenticated private lab only",
"active_catalog_authorized": false
},
"stable": {
"artifact_version_class": "final",
"artifact_version_equals_intended_version": true,
"requires_active_signed_catalog_authorization": true
}
},
"publication_policy": {
"syntactic_validity_implies_publication_eligibility": false,
"eligible_version_class": "final",
"eligibility_is_stable_authorization": false,
"reason_codes": [
"final_version_eligible_not_authorized",
"candidate_prerelease_lab_only",
"legacy_prerelease_non_authorized",
"build_metadata_disallowed"
]
},
"security_boundaries": [
"This contract performs no signature, catalog, cutover-policy, release, store, tag, or discovery verification.",
"A stable assertion requires an authorization decision supplied by a future verified active-catalog implementation.",
"A final-version artifact may be publication-eligible while remaining published-but-not-authorized and therefore not stable."
]
}
Loading
Loading