Skip to content
Tools/Spec Introspection/list_benchmarks

list_benchmarks

Return one of four canonical benchmark catalogs (the data behind `get_graph_digest` health logic). Required `kind` selects the source: `count` → `UPG_COUNT_BENCHMARKS` (per-entity-type ranges across the 9-stage journey); `relationship` → `UPG_RELATIONSHIP_BENCHMARKS` (parent → child minimum counts per stage); `ratio` → `UPG_RATIO_BENCHMARKS` (expected ratios between entity-type counts); `domain_activation` → `UPG_DOMAIN_ACTIVATION` (when each atomic domain is expected to activate). Optional filters AND together: `stage` (`UPGProductStage`), `domain` (atomic-domain id). Non-paginated.

Spec Introspectionatomic (read-only)

Arguments

kindstringrequired

Required. Which benchmark catalog to return.

countrelationshipratiodomain_activation
stagestringoptional

Optional UPGProductStage filter. Semantics depend on kind (see tool description).

conceptvalidationbuildbetalaunchgrowthmaturemaintenancesunset
domainstringoptional

Optional atomic-domain id filter. Semantics depend on kind (see tool description).

Returns

Shape
{ kind, total, count, benchmarks:... }

Examples

Live call against the Notion example graph.

Input

{
  "kind": "count"
}

Output

{
  "kind": "count",
  "total": 47,
  "count": 47,
  "benchmarks": [
    {
      "type": "product",
      "domain": "strategy",
      "concept": {
        "min": 1,
        "max": 1
      },
      "validation": {
        "min": 1,
        "max": 1
      },
      "build": {
        "min": 1,
        "max": 1
      },
      "beta": {
        "min": 1,
        "max": 1
      },
      "launch": {
        "min": 1,
        "max": 1
      },
      "growth": {
        "min": 1,
        "max": 1
      },
      "mature": {
        "min": 1,
        "max": 3
      },
      "maintenance": {
        "min": 1,
        "max": 3
      },
      "sunset": {
        "min": 1,
        "max": 1
      },
      "source": {
        "kind": "fundamental"
      },
      "rationale": "Every graph needs exactly one product (or one per product area at scale)."
    },
    {
      "type": "outcome",
      "domain": "strategy",
      "concept": {
        "min": 1,
        "max": 3
      },
      "validation": {
        "min": 2,
        "max": 4
      },
      "build": {
        "min": 2,
        "max": 5
      },
      "beta": {
        "min": 3,
        "max": 7
      },
      "launch": {
        "min": 2,
        "max": 5
      },
      "growth": {
        "min": 3,
        "max": 8
      },
      "mature": {
        "min": 5,
        "max": 15
      },
      "maintenance": {
        "min": 5,
… (truncated)

See Also