lineage

Read the namespace-scoped discriminator graph.

EXPERIMENTAL. Namespace-scoped discriminator graph read — the strand-world successor to cross-service-components. Lists catalog components (optionally filtered to one namespace) with the lineage mode and payload boundaries of each component’s latest scan, plus the projected strand edges touching the scope. Evaluates one on-demand roll-up per scanned code component per request; a scope spanning more components than the server’s bound is rejected with 422 rather than degrading into a timeout. detailLevel=fields adds each code component’s payload groups with their field-mapping rows and each boundary’s field names, and each data store’s registry schema, from the same roll-ups the summary already evaluates. A scanned code component carries the approval folded into that latest discriminator projection at either detail level. That body grows with the namespace; send Accept: application/octet-stream to receive it gzipped, as with cross-service-components.

GET

experimental

discriminator_graph

curl --request GET \
  --url https://{hostname}.gable.ai/v0/experimental/discriminator_graph \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://{hostname}.gable.ai/v0/experimental/discriminator_graph', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{hostname}.gable.ai/v0/experimental/discriminator_graph",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{hostname}.gable.ai/v0/experimental/discriminator_graph"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{hostname}.gable.ai/v0/experimental/discriminator_graph")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "components": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "CODE",
      "name": "<string>",
      "lineageMode": "DISCRIMINATOR",
      "codeIngressPointCount": 1,
      "codeEgressPointCount": 1,
      "boundaries": [
        {
          "id": "<string>",
          "name": "<string>",
          "side": "ingress",
          "fields": [
            "<string>"
          ]
        }
      ],
      "friendlyName": "<string>",
      "namespace": "<string>",
      "latestVersionId": "<string>",
      "approval": {
        "status": "UNAPPROVED",
        "approvalEventId": "<string>",
        "approvedAt": "2023-11-07T05:31:56Z",
        "approvedBy": {
          "userId": "<string>",
          "email": "<string>",
          "name": "<string>"
        },
        "note": "<string>"
      },
      "payloadGroups": [
        {
          "groupId": "0a1b2c3d4e5f6070",
          "coordinates": {},
          "origin": "SCAN",
          "suppressed": true,
          "display": {
            "ingress": {
              "name": "<string>",
              "qualifiedName": "<string>",
              "site": "<string>"
            },
            "egress": {
              "name": "<string>",
              "qualifiedName": "<string>",
              "site": "<string>"
            },
            "label": "<string>"
          },
          "fieldMappings": [
            {
              "ingressField": "<string>",
              "egressField": "<string>",
              "origin": "SCAN",
              "suppressed": true,
              "fieldMappingKind": "DataFlow"
            }
          ]
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "<string>",
            "type": "<string>"
          }
        ]
      }
    }
  ],
  "edges": [
    {
      "edgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "state": "connected",
      "origin": "SCANNER",
      "source": {
        "componentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "level": "payload",
        "ancestors": [
          {
            "level": "payload",
            "coordinates": {}
          }
        ],
        "coordinates": {}
      },
      "destination": {
        "componentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "level": "payload",
        "ancestors": [
          {
            "level": "payload",
            "coordinates": {}
          }
        ],
        "coordinates": {}
      },
      "fieldMappings": [
        {
          "sourceFieldPath": "<string>",
          "destinationFieldPath": "<string>",
          "notes": "<string>",
          "dataStoreEvidence": [
            {
              "derivation": "direct",
              "projectionLabel": "<string>",
              "applicationFieldPath": "<string>"
            }
          ]
        }
      ],
      "sourceGroupId": "<string>",
      "destinationGroupId": "<string>",
      "note": "<string>",
      "sourceDisplay": {
        "componentName": "<string>",
        "componentType": "CODE",
        "payloadLabel": "<string>"
      },
      "destinationDisplay": {
        "componentName": "<string>",
        "componentType": "CODE",
        "payloadLabel": "<string>"
      }
    }
  ],
  "invalidEventCount": 123,
  "unreadableComponentIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

Authorizations

X-API-KEY

string

header

required

Query Parameters

namespace

string

Filter to one namespace. When omitted, the whole catalog is in scope (still subject to the component-count bound).

detailLevel

enum<string>

default:summary

summary (default) returns identity, lineage mode, boundaries and edges. fields additionally populates boundaries[].fields, payloadGroups on scanned code components, and schema on data stores.

Available options:

summary,

fields

Response

The discriminator graph for the requested scope.

The namespace-scoped discriminator graph: every catalog component in scope with its lineage capability and boundaries, plus the projected strand edges touching the scope. The invariant that matters: boundaries and edges are the identical schemas the per-component discriminator_data read returns, so a consumer of one read renders the other without translation.

components

object[]

required

Show child attributes

edges

object[]

required

Projected strand edges with at least one endpoint among components, in the same shape as the component edges read, including endpoint display identity where the registry record was readable. Edges whose latest lifecycle event is a deletion appear with state deleted (audit channel), exactly as the component read reports them.

Show child attributes

invalidEventCount

integer

required

Count of stored edge lifecycle events whose persisted payload could not be interpreted.

unreadableComponentIds

string<uuid>[]

Code components whose latest scan could not be evaluated: strand artifacts the engine could not read (a scan older than the pinned engine's format), a roll-up exceeding a discriminator resource bound, or a load still running when the read's time budget ran out. They are reported as NO_STRAND_DATA and their edges as pending rather than failing the whole read. A rescan fixes the first two (a smaller one, for an oversized scan); a later read may evaluate the last once its roll-up is cached. Absent when every component evaluated.

⌘I

Read the namespace-scoped discriminator graph.

curl --request GET \
  --url https://{hostname}.gable.ai/v0/experimental/discriminator_graph \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://{hostname}.gable.ai/v0/experimental/discriminator_graph', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{hostname}.gable.ai/v0/experimental/discriminator_graph",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{hostname}.gable.ai/v0/experimental/discriminator_graph"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{hostname}.gable.ai/v0/experimental/discriminator_graph")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "components": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "CODE",
      "name": "<string>",
      "lineageMode": "DISCRIMINATOR",
      "codeIngressPointCount": 1,
      "codeEgressPointCount": 1,
      "boundaries": [
        {
          "id": "<string>",
          "name": "<string>",
          "side": "ingress",
          "fields": [
            "<string>"
          ]
        }
      ],
      "friendlyName": "<string>",
      "namespace": "<string>",
      "latestVersionId": "<string>",
      "approval": {
        "status": "UNAPPROVED",
        "approvalEventId": "<string>",
        "approvedAt": "2023-11-07T05:31:56Z",
        "approvedBy": {
          "userId": "<string>",
          "email": "<string>",
          "name": "<string>"
        },
        "note": "<string>"
      },
      "payloadGroups": [
        {
          "groupId": "0a1b2c3d4e5f6070",
          "coordinates": {},
          "origin": "SCAN",
          "suppressed": true,
          "display": {
            "ingress": {
              "name": "<string>",
              "qualifiedName": "<string>",
              "site": "<string>"
            },
            "egress": {
              "name": "<string>",
              "qualifiedName": "<string>",
              "site": "<string>"
            },
            "label": "<string>"
          },
          "fieldMappings": [
            {
              "ingressField": "<string>",
              "egressField": "<string>",
              "origin": "SCAN",
              "suppressed": true,
              "fieldMappingKind": "DataFlow"
            }
          ]
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "<string>",
            "type": "<string>"
          }
        ]
      }
    }
  ],
  "edges": [
    {
      "edgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "state": "connected",
      "origin": "SCANNER",
      "source": {
        "componentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "level": "payload",
        "ancestors": [
          {
            "level": "payload",
            "coordinates": {}
          }
        ],
        "coordinates": {}
      },
      "destination": {
        "componentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "level": "payload",
        "ancestors": [
          {
            "level": "payload",
            "coordinates": {}
          }
        ],
        "coordinates": {}
      },
      "fieldMappings": [
        {
          "sourceFieldPath": "<string>",
          "destinationFieldPath": "<string>",
          "notes": "<string>",
          "dataStoreEvidence": [
            {
              "derivation": "direct",
              "projectionLabel": "<string>",
              "applicationFieldPath": "<string>"
            }
          ]
        }
      ],
      "sourceGroupId": "<string>",
      "destinationGroupId": "<string>",
      "note": "<string>",
      "sourceDisplay": {
        "componentName": "<string>",
        "componentType": "CODE",
        "payloadLabel": "<string>"
      },
      "destinationDisplay": {
        "componentName": "<string>",
        "componentType": "CODE",
        "payloadLabel": "<string>"
      }
    }
  ],
  "invalidEventCount": 123,
  "unreadableComponentIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

{
  "message": "<string>",
  "id": 123,
  "title": "<string>"
}

Introduction

Gable

Read the namespace-scoped discriminator graph.

Authorizations

Query Parameters

Response