Revision class

A specific iteration of an item in the Kumiho system.

Revisions are immutable snapshots of an item at a point in time. Each revision can have multiple artifacts (file references), tags for categorization, and edges to other revisions for dependency tracking. The class presents these capabilities through first-class Dart models so the API surface remains stable even if the underlying protobuf schema evolves.

final revision = await kumiho.getRevision('kref://project/models/hero.model?r=1');

// Add artifacts
await revision.createArtifact('mesh', '/assets/hero.fbx');
await revision.createArtifact('textures', '/assets/hero_tex.zip');

// Tag the revision
await revision.tag('approved');

// Create edges to dependencies
final texture = await kumiho.getRevision('kref://project/tex/skin.texture?r=3');
await revision.createEdge(texture, EdgeType.dependsOn);