Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.
Tools/Spec Introspection/get_spec_version

get_spec_version

Spec-level metadata for compatibility checks: `upg_version`, `markdown_format_version`, and canonical counts (entity types, edge types, atomic domains, super-domain regions). Pin against the version pair; counts are informational. Pass `changelog: true` to fold in the spec CHANGELOG (a `whats_new` surface); `since` (a version) returns only newer entries.

Spec Introspectionatomic (read-only)

Arguments

changelogbooleanoptional

When true, include a `changelog` array parsed from the spec CHANGELOG.md.

sincestringoptional

With changelog: return only entries strictly newer than this version (e.g. "0.17.0").

Returns

Shape
{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }

Examples

Live call against the Notion example graph.

Output

{
  "upg_version": "0.7.3",
  "markdown_format_version": "0.1",
  "entity_count": 312,
  "edge_count": 946,
  "domain_count": 36,
  "region_count": 10
}

See Also