Skip to content
Tools/Spec Introspection/list_lifecycles

list_lifecycles

List lifecycle definitions from `UPG_LIFECYCLES`. Response includes `free_types` (`UPG_LIFECYCLE_FREE_TYPES`: static types with no phase progression) and `planned_types` (`UPG_LIFECYCLE_PLANNED_TYPES`: lifecycle planned but not yet authored). Filters: `entity_type` (exact-match), `lifecycle_only` (when true, omits the free/planned lists).

Spec Introspectionatomic (read-only)

Arguments

entity_typestringoptional

Exact-match entity type name (e.g. "feature", "hypothesis"). Returns at most one lifecycle.

lifecycle_onlybooleanoptional

When true, omit free_types and planned_types from response.

Returns

Shape
{ lifecycles, total, free_types: string[], planned_types: string[] }

Examples

Live call against the Notion example graph.

Output

{
  "total": 188,
  "lifecycles": [
    {
      "entity_type": "product",
      "initial_phase": "concept",
      "terminal_phases": [
        "sunset"
      ],
      "phases": [
        {
          "id": "concept",
          "label": "Concept",
          "description": "Napkin idea. Problem shape and solution sketch, pre-validation.",
          "transitions_to": [
            "validation",
            "build",
            "beta",
            "launch",
            "growth",
            "mature",
            "sunset"
          ]
        },
        {
          "id": "validation",
          "label": "Validation",
          "description": "Testing demand. User conversations and experiments pressure-test assumptions before build commits.",
          "transitions_to": [
            "build",
            "beta",
            "launch",
            "growth",
            "mature",
            "sunset"
          ]
        },
        {
          "id": "build",
          "label": "Build",
          "description": "Actively developing v1. Core functionality is being authored, pre-user.",
          "transitions_to": [
            "beta",
            "launch",
            "growth",
            "mature",
            "sunset"
          ]
        },
        {
          "id": "beta",
          "label": "Beta",
          "description": "Early users, iterating. Feature-complete enough to learn from,
… (truncated)

See Also