Adopt

5 surfaces
Tools/Spec Introspection/list_entity_types

list_entity_types

List canonical entity types from `UPG_ENTITY_META` (source of truth for ontology evolution). Every active, deprecated, or removed type with its immutable `type_id`, maturity tier, and version metadata. Paginated (default 50, max 200). Filters AND together and apply before pagination: `domain` (atomic-domain id), `maturity` (`draft` / `proposed` / `stable` / `deprecated` / `removed`), `deprecated` (boolean shortcut). Each row carries the full `EntityTypeMeta` plus resolved `domain_id` (null if no atomic-domain mapping).

Spec Introspectionatomic (read-only)

Arguments

domainstringoptional

Exact-match atomic-domain id (e.g. "user", "market_intelligence").

maturitystringoptional

Exact-match UPGEntityTypeMaturity.

draftproposedstabledeprecatedremoved
deprecatedbooleanoptional

true → only deprecated types; false → exclude deprecated and removed types (the active set). Composes with maturity via AND.

limitnumberoptional

Page size (default 50, max 200).

cursorstringoptional

Opaque pagination cursor. Pass next_cursor from a previous response.

Returns

Shape
{ total, count, next_cursor?, types: Array<EntityTypeMeta & { domain_id: string | null }> }

Examples

Live call against the Notion example graph.

Output

{
  "total": 349,
  "count": 50,
  "types": [
    {
      "name": "product",
      "type_id": "ent_001",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "outcome",
      "type_id": "ent_002",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "kpi",
      "type_id": "ent_003",
      "maturity": "deprecated",
      "since": "0.1.0",
      "deprecated_in": "0.1.0",
      "replacement": "metric",
      "domain_id": null
    },
    {
      "name": "objective",
      "type_id": "ent_004",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "key_result",
      "type_id": "ent_005",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "metric",
      "type_id": "ent_006",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "metric_quality_assessment",
      "type_id": "ent_339",
      "maturity": "proposed",
      "since": "0.2.2",
      "domain_id": "strategy"
    },
    {
      "name": "vision",
      "type_id": "ent_007",
      "maturity": "stable",
      "since": "0.1.0",
      "domain_id": "strategy"
    },
    {
      "name": "mission",
      "type_id": "ent_008",
      "maturity": "stable",
… (truncated)

See Also