# Recorded GraphQL shapes
`project.json` follows GitHub's published `ProjectV2`, `ProjectV2Item`,
`ProjectV2ItemContent`, `ProjectV2ItemFieldSingleSelectValue`, and label-connection schema.
`dependencies.json` follows the published `Issue.blockedBy: IssueConnection` and
`Issue.blocking: IssueConnection` shapes, which provide both dependency directions.
The values are synthetic and stable; the object, union, and connection shapes are recorded from
the official GraphQL references at <https://docs.github.com/en/graphql/reference/projects> and
<https://docs.github.com/en/graphql/reference/issues>. Tests serve these files through an actual
loopback HTTP server and exercise request construction, authentication, parsing, and mapping.
`schema.graphql` is the authoritative contract subset: the read surface was obtained from
GitHub.com's GraphQL introspection endpoint on 2026-08-24, and the mutation inputs and payloads
were derived from GitHub's published Projects and Issues references on 2026-08-26. The
pinned-schema test validates every production operation's
selected fields, arguments, variable types, fragment type conditions, and fixture keys against it;
the credentialed live lane introspects the current mutation fields and input types as its mutation
freshness check, then exercises reads without changing the configured board.