Adopt

5 surfaces
Tools/Spec Introspection/list_type_migrations

list_type_migrations

List every type-rename migration from `UPG_MIGRATIONS` (version-scoped registry of deprecated `from` → canonical `to` renames, e.g. `pain_point` → `need`, `hypothesis` → `hypothesis_claim`). Each row: `{ from, to, since }` where `since` is the spec version that introduced it. Optional `from_type` exact-matches `from`.

Spec Introspectionatomic (read-only)

Arguments

from_typestringoptional

Exact-match filter on the deprecated type name (e.g. "pain_point", "hypothesis").

Returns

Shape
{ migrations: [{ from, to, since }], total: number }

Examples

Live call against the Notion example graph.

Output

{
  "migrations": [
    {
      "from": "story_statement",
      "to": "user_story",
      "since": "0.7.0"
    },
    {
      "from": "hypothesis_claim",
      "to": "hypothesis",
      "since": "0.4.0"
    },
    {
      "from": "hypothesis_evidence",
      "to": "evidence",
      "since": "0.4.0"
    },
    {
      "from": "story_task",
      "to": "task",
      "since": "0.4.0"
    },
    {
      "from": "hypothesis",
      "to": "hypothesis_claim",
      "since": "0.2.8"
    },
    {
      "from": "pain_point",
      "to": "need",
      "since": "0.1.0"
    },
    {
      "from": "user_need",
      "to": "need",
      "since": "0.1.0"
    },
    {
      "from": "research_insight",
      "to": "insight",
      "since": "0.1.0"
    },
    {
      "from": "finding",
      "to": "insight",
      "since": "0.1.0"
    },
    {
      "from": "ux_insight",
      "to": "insight",
      "since": "0.1.0"
    },
    {
      "from": "highlight",
      "to": "observation",
      "since": "0.1.0"
    },
    {
      "from": "kpi",
      "to": "metric",
      "since": "0.1.0"
    },
    {
      "from": "north_star_metric",
      "to": "metric",
      "since": "0.1.0"
    },
    {
      "from": "input_metric",
      "to": "metric",
      "since": "0.1.0"
    },
    {
      "from": "metric_definition",
      "to": "metric",
      "since": "0.1.0"
    },
    {
      "from": "ab_test",
… (truncated)

See Also