{"openapi":"3.1.0","info":{"title":"Semantic Version Compare and Release Guard API","version":"1.0.0","description":"Inspect, compare, sort, select, and apply explicit policy to caller-supplied strict Semantic Versioning 2.0.0 values, or calculate a non-publishing release candidate. The API never queries a package registry or repository, resolves dependencies, verifies compatibility, changes a file or tag, or publishes a release."},"paths":{"/marketplace/rapid/semver/v1/inspect":{"post":{"tags":["Semantic Version Inspect"],"summary":"Inspect Semantic Version","operationId":"inspectSemanticVersion","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverVersionRequest"},"examples":{"example":{"summary":"Inspect Semantic Version","value":{"version":"2.4.0-rc.1+build.7"}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverInspectResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/semver/v1/compare":{"post":{"tags":["Semantic Version Compare"],"summary":"Compare Semantic Versions","operationId":"compareSemanticVersions","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverCompareRequest"},"examples":{"example":{"summary":"Compare Semantic Versions","value":{"left":"2.4.0-rc.1","right":"2.4.0"}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverCompareResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/semver/v1/sort":{"post":{"tags":["Semantic Version Sort"],"summary":"Sort Semantic Versions","operationId":"sortSemanticVersions","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverSortRequest"},"examples":{"example":{"summary":"Sort Semantic Versions","value":{"versions":["2.4.0","2.4.0-rc.1","1.9.3","2.4.0+build.7"],"direction":"DESC"}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverSortResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/semver/v1/bump":{"post":{"tags":["Version Candidate"],"summary":"Build Version Candidate","operationId":"bumpSemanticVersion","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverBumpRequest"},"examples":{"example":{"summary":"Build Version Candidate","value":{"version":"2.4.0","release":"PREMINOR","prerelease_identifier":"rc"}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverBumpResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/semver/v1/select":{"post":{"tags":["Version Selection"],"summary":"Select Matching Version","operationId":"selectSemanticVersion","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverSelectRequest"},"examples":{"example":{"summary":"Select Matching Version","value":{"versions":["1.9.3","2.0.0-rc.1","2.0.0","2.4.1","3.0.0"],"constraints":[{"operator":"GTE","version":"2.0.0"},{"operator":"LT","version":"3.0.0"}],"constraint_mode":"ALL","selection":"HIGHEST","include_prerelease":false}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverSelectResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/semver/v1/policy-check":{"post":{"tags":["Semantic Version Policy"],"summary":"Check Version Policy","operationId":"checkSemanticVersionPolicy","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverPolicyRequest"},"examples":{"example":{"summary":"Check Version Policy","value":{"version":"2.4.1","minimum_version":"2.0.0","maximum_version":"2.9.99","allow_major_zero":false,"allow_prerelease":false,"allow_build_metadata":true,"allowed_majors":[2]}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemverPolicyResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SemverBumpRequest":{"properties":{"version":{"type":"string","maxLength":256,"minLength":1,"title":"Version"},"release":{"type":"string","enum":["MAJOR","MINOR","PATCH","PREMAJOR","PREMINOR","PREPATCH","PRERELEASE"],"title":"Release"},"prerelease_identifier":{"type":"string","maxLength":64,"minLength":1,"title":"Prerelease Identifier","default":"rc"}},"additionalProperties":false,"type":"object","required":["version","release"],"title":"SemverBumpRequest"},"SemverBumpResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"current":{"type":"string","title":"Current"},"candidate":{"type":"string","title":"Candidate"},"release":{"type":"string","title":"Release"},"candidate_executable":{"type":"boolean","const":false,"title":"Candidate Executable","default":false}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","current","candidate","release"],"title":"SemverBumpResult"},"SemverComparator":{"properties":{"operator":{"type":"string","enum":["EQ","NE","GT","GTE","LT","LTE"],"title":"Operator"},"version":{"type":"string","maxLength":256,"minLength":1,"title":"Version"}},"additionalProperties":false,"type":"object","required":["operator","version"],"title":"SemverComparator"},"SemverCompareRequest":{"properties":{"left":{"type":"string","maxLength":256,"minLength":1,"title":"Left"},"right":{"type":"string","maxLength":256,"minLength":1,"title":"Right"}},"additionalProperties":false,"type":"object","required":["left","right"],"title":"SemverCompareRequest"},"SemverCompareResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"left_normalized":{"type":"string","title":"Left Normalized"},"right_normalized":{"type":"string","title":"Right Normalized"},"relation":{"type":"string","enum":["LT","EQ","GT"],"title":"Relation"},"precedence_equal":{"type":"boolean","title":"Precedence Equal"},"identity_equal":{"type":"boolean","title":"Identity Equal"},"build_metadata_ignored_for_precedence":{"type":"boolean","title":"Build Metadata Ignored For Precedence"}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","left_normalized","right_normalized","relation","precedence_equal","identity_equal","build_metadata_ignored_for_precedence"],"title":"SemverCompareResult"},"SemverFinding":{"properties":{"code":{"type":"string","title":"Code"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"title":"Severity"},"message":{"type":"string","title":"Message"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"next_action":{"type":"string","title":"Next Action"}},"additionalProperties":false,"type":"object","required":["code","severity","message","next_action"],"title":"SemverFinding"},"SemverInspectResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"normalized":{"type":"string","title":"Normalized"},"major":{"type":"integer","title":"Major"},"minor":{"type":"integer","title":"Minor"},"patch":{"type":"integer","title":"Patch"},"prerelease":{"items":{"type":"string"},"type":"array","title":"Prerelease"},"build":{"items":{"type":"string"},"type":"array","title":"Build"},"stable":{"type":"boolean","title":"Stable"},"major_zero":{"type":"boolean","title":"Major Zero"}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","normalized","major","minor","patch","prerelease","build","stable","major_zero"],"title":"SemverInspectResult"},"SemverPolicyRequest":{"properties":{"version":{"type":"string","maxLength":256,"minLength":1,"title":"Version"},"minimum_version":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Minimum Version"},"maximum_version":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Maximum Version"},"allow_major_zero":{"type":"boolean","title":"Allow Major Zero","default":true},"allow_prerelease":{"type":"boolean","title":"Allow Prerelease","default":false},"allow_build_metadata":{"type":"boolean","title":"Allow Build Metadata","default":true},"allowed_majors":{"items":{"type":"integer"},"type":"array","maxItems":128,"title":"Allowed Majors"},"blocked_prerelease_identifiers":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Blocked Prerelease Identifiers"}},"additionalProperties":false,"type":"object","required":["version"],"title":"SemverPolicyRequest"},"SemverPolicyResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"normalized":{"type":"string","title":"Normalized"},"allowed":{"type":"boolean","title":"Allowed"},"stable":{"type":"boolean","title":"Stable"},"major":{"type":"integer","title":"Major"},"prerelease_identifiers":{"items":{"type":"string"},"type":"array","title":"Prerelease Identifiers"},"build_identifiers":{"items":{"type":"string"},"type":"array","title":"Build Identifiers"}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","normalized","allowed","stable","major","prerelease_identifiers","build_identifiers"],"title":"SemverPolicyResult"},"SemverSelectRequest":{"properties":{"versions":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Versions"},"constraints":{"items":{"$ref":"#/components/schemas/SemverComparator"},"type":"array","maxItems":32,"title":"Constraints"},"constraint_mode":{"type":"string","enum":["ALL","ANY"],"title":"Constraint Mode","default":"ALL"},"selection":{"type":"string","enum":["HIGHEST","LOWEST","ALL"],"title":"Selection","default":"HIGHEST"},"include_prerelease":{"type":"boolean","title":"Include Prerelease","default":false}},"additionalProperties":false,"type":"object","required":["versions"],"title":"SemverSelectRequest"},"SemverSelectResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"matching_versions":{"items":{"type":"string"},"type":"array","title":"Matching Versions"},"selected_versions":{"items":{"type":"string"},"type":"array","title":"Selected Versions"},"excluded_prerelease_versions":{"items":{"type":"string"},"type":"array","title":"Excluded Prerelease Versions"},"rejected_versions":{"items":{"type":"string"},"type":"array","title":"Rejected Versions"},"constraint_mode":{"type":"string","enum":["ALL","ANY"],"title":"Constraint Mode"},"selection":{"type":"string","enum":["HIGHEST","LOWEST","ALL"],"title":"Selection"}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","matching_versions","selected_versions","excluded_prerelease_versions","rejected_versions","constraint_mode","selection"],"title":"SemverSelectResult"},"SemverSortRequest":{"properties":{"versions":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Versions"},"direction":{"type":"string","enum":["ASC","DESC"],"title":"Direction","default":"ASC"},"deduplicate_exact":{"type":"boolean","title":"Deduplicate Exact","default":false}},"additionalProperties":false,"type":"object","required":["versions"],"title":"SemverSortRequest"},"SemverSortResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"findings":{"items":{"$ref":"#/components/schemas/SemverFinding"},"type":"array","title":"Findings"},"ruleset_version":{"type":"string","const":"SEMVER_2_0_0","title":"Ruleset Version","default":"SEMVER_2_0_0"},"scope":{"type":"string","const":"CALLER_SUPPLIED_VERSIONS_ONLY","title":"Scope","default":"CALLER_SUPPLIED_VERSIONS_ONLY"},"registry_queried":{"type":"boolean","const":false,"title":"Registry Queried","default":false},"repository_queried":{"type":"boolean","const":false,"title":"Repository Queried","default":false},"release_published":{"type":"boolean","const":false,"title":"Release Published","default":false},"compatibility_verified":{"type":"boolean","const":false,"title":"Compatibility Verified","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"next_action":{"type":"string","title":"Next Action"},"direction":{"type":"string","enum":["ASC","DESC"],"title":"Direction"},"versions":{"items":{"type":"string"},"type":"array","title":"Versions"},"exact_duplicates_removed":{"type":"integer","title":"Exact Duplicates Removed"},"precedence_tie_groups":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Precedence Tie Groups"}},"additionalProperties":false,"type":"object","required":["decision","findings","next_action","direction","versions","exact_duplicates_removed","precedence_tie_groups"],"title":"SemverSortResult"},"SemverVersionRequest":{"properties":{"version":{"type":"string","maxLength":256,"minLength":1,"title":"Version"}},"additionalProperties":false,"type":"object","required":["version"],"title":"SemverVersionRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Semantic Version Inspect","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."},{"name":"Semantic Version Compare","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."},{"name":"Semantic Version Sort","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."},{"name":"Version Candidate","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."},{"name":"Version Selection","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."},{"name":"Semantic Version Policy","description":"A bounded, stateless Semantic Versioning 2.0.0 preflight for release agents, dependency workflows, CI/CD systems, and developer tooling."}],"servers":[{"url":"https://api-production-9502.up.railway.app"}]}