Module kinds 

Bundled document-kind specs and semver-prefix matching.

The binary ships a copy of every kind spec it knows about so that path kind and path query --kind work offline. BUNDLED_KINDS is the single source of truth for which (name, version) specs are baked in; the schema module (kind-aware validation) and the query layer both read it.

A meta.kind value is a semver-versioned URI of the form …/kinds/<name>/v<major>.<minor>.<patch>. A KindSelector matches a prefix of (name, major, minor, patch): a bare name matches any version, v1 matches v1.*.*, v1.0 matches v1.0.*, and a full triple matches exactly. Matching compares parsed integer tuples, so v1 matches v1.9.0 but keeps v10.0.0 separate.

Structs

BundledKind

A kind spec compiled into the binary.

KindSelector

A --kind / path kind selector: a name plus an optional version prefix.

Version

A parsed (major, minor, patch) version triple.

Constants

BUNDLED_KINDS

Every kind spec baked into the binary, oldest version first.

Functions

parse_kind_selector

Parse a selector. Accepts a bare name (agent-coding-session), a name + version prefix (agent-coding-session/v1, .../v1.0, .../v1.0.0, with the v optional), or a full meta.kind URI.

parse_kind_uri

Parse a full meta.kind URI into its (name, version).

resolve

Resolve a selector to the newest bundled kind spec it matches.