Struct SemanticVersioningEngine 

pub struct SemanticVersioningEngine {
    pub artifacts: HashMap<String, VersionedArtifact>,
    pub compatibility_rules: CompatibilityMatrix,
}

Manages versioned artifacts with SemVer-based change detection, compatibility analysis, and migration-path computation.

Fields

artifacts: HashMap<String, VersionedArtifact>

Registered artifacts keyed by their ID.

compatibility_rules: CompatibilityMatrix

Rules governing cross-version compatibility.

Implementations

impl SemanticVersioningEngine

pub fn new() -> Self

Create a new engine with sensible default compatibility rules:

• Same major (distance 0) → CompatibilityLevel::FullyCompatible.
• Adjacent major (distance 1) → CompatibilityLevel::BackwardCompatible.
• All other pairs → CompatibilityLevel::Incompatible.

Rules are pre-populated for majors 0..=9.

pub fn register_artifact( &mut self, artifact: VersionedArtifact, ) -> Result<(), SemVerError>

Register a new artifact.

Returns SemVerError::ArtifactAlreadyExists if an artifact with the same ID is already registered.

pub fn publish_change( &mut self, artifact_id: &str, change_type: ChangeType, description: String, now: u64, ) -> Result<SemVer, SemVerError>

Apply a change to an artifact, auto-bumping its version according to ChangeType::required_bump, appending a ChangeRecord, and returning the new version.

Returns SemVerError::ArtifactNotFound when artifact_id is unknown.

pub fn get_version(&self, artifact_id: &str) -> Option<&SemVer>

Return the current version of an artifact, or None if not found.

pub fn version_history(&self, artifact_id: &str) -> Vec<&ChangeRecord>

Return all changelog entries for an artifact in registration order.

pub fn check_compatibility( &self, from_id: &str, to_id: &str, ) -> Result<CompatibilityLevel, SemVerError>

Determine the compatibility level between the current versions of two artifacts.

Returns errors when either artifact ID is unknown.

pub fn find_breaking_changes( &self, artifact_id: &str, since: &SemVer, ) -> Vec<&ChangeRecord>

Return all changelog entries with ChangeType::Breaking whose version is strictly greater than since.

pub fn migration_path(&self, from: &SemVer, to: &SemVer) -> Vec<SemVer>

Compute a migration path between two SemVer values.

Rules:

• Same version → [from]
• Same major, different minor → [from, intermediate, to] where intermediate is (from.major, to.minor, 0) (i.e. from’s major with to’s minor bumped in).
• Adjacent major (|delta| == 1) → [from, to]
• Otherwise → [] (incompatible gap, no path)

pub fn artifacts_at_version(&self, version: &SemVer) -> Vec<&str>

Return the IDs of all artifacts whose current version equals version.

pub fn stats(&self) -> VersioningStats

Compute aggregate statistics over all registered artifacts.

Trait Implementations

impl Default for SemanticVersioningEngine

fn default() -> Self

Returns the “default value” for a type.