Expand description
Exact GraphQL query documents issued by this plugin.
Keeping the production documents here lets the pinned-schema test validate the same
bytes that are sent to GitHub, rather than a test-only copy which could drift
independently. [STATUS_OPTIONS_UPDATE] is the sole document that may rewrite a board
field, and its guarded caller always supplies the complete existing option set with ids.
Constants§
- ADD_
BLOCKED_ BY - Adds GitHub’s native issue blocked-by relationship.
- ADD_
BLOCKED_ BYS - Up to
WRITE_BATCHnative blocked-by relationships a copy adds to the issues it created, in one request. - ADD_
COMMENT - Adds one comment to an issue, signed as the account the token belongs to.
- ADD_
COMMENTS - Adds up to
COMMENT_BATCHcomments in one request, each asADD_COMMENTadds one, in order: whattask comment add-manysends. GitHub runs each alias on its own and answers one it refused at its own path, beside the others. - ADD_
COMMENT_ WHOLE ADD_COMMENT, selecting the whole issue commented on.- ADD_
RELATES_ TO - Up to
RELATION_BATCHrelates-torelations added in one request, eachrelate<n>sent only while$send<n>holds: what a link of a type a source mirrors natively writes beside its metadata. - ADD_
SUB_ ISSUE - Files one issue under another as a sub-issue, which is what project membership is.
- ADD_
TO_ BOARD - Puts an existing issue on the configured board.
- BOARD
- Reads the board’s fields and one page of its items.
- BOARD_
FIELDS - The board’s own id and field definitions, and not one of its items.
- BOARD_
WITH_ COMMENTS - A board page carrying each issue’s first comment page in the same request.
- CLEAR_
FIELD - Clears one project item’s value of one field, which is what a
nonepriority is. - CLEAR_
FIELD_ TOKEN CLEAR_FIELD, selecting the issue behind the board item cleared asUPDATE_ISSUE_TOKENselects the issue it updates.- CLEAR_
FIELD_ WHOLE CLEAR_FIELD, selecting the whole issue behind the board item cleared.- CLOSED_
ITEMS - Every closed item of the board, by the board’s own field filter — what
task status reconcilereads, and nothing else of the board. - CLOSE_
ISSUES - Closes up to
MUTATION_BATCHissues a copy created at a closing status, each with its ownstateInputand nothing else, once its option is selected. - COMMENT_
ISSUE - Which issue one comment is on, read before that comment is edited or removed.
- CREATED_
BOARD_ ITEMS - The board item of each issue a copy created, up to
COPY_DETAIL_BATCHat a time, with itsStatusas the board set it: whatcreateIssue’sprojectV2Idsfiles the issue as, which GitHub adds after answering the create, so its id comes from a read made once every create has been sent. - CREATE_
FIELD - Creates one field: a single-select one with its options, or a text one for a projected metadata value. Only the guarded field setup may use this document, and only for a field the board lacks.
- CREATE_
ISSUE - Creates one issue. Outside a copy it is created on no board, and
ADD_TO_BOARDfiles it; inside one, its input names the board inprojectV2Idsand its project inparentIssueId, so this one request files it under both — seeGitHubProjectsSource::create_filed_issue. - CREATE_
ISSUES - Creates up to
MUTATION_BATCHissues in one request, each filed on the board and under its project by the samecreateIssue— itsprojectV2IdsandparentIssueId— asCREATE_ISSUEcreates one. - CREATION_
CONTEXT - What creating an issue needs and has not read yet: the board’s own id and field
definitions, as
BOARD_FIELDSreads them, and the node id of the repository the issue is created in, asREPOSITORYreads it — in one request. - DELETE_
COMMENT - Removes one issue comment. Its payload carries nothing about the comment it removed.
- DELETE_
ISSUE - Deletes one issue, which takes its board item with it.
- DELETE_
ISSUES - Deletes up to
DELETE_BATCHissues in one request, each asDELETE_ISSUEdeletes one: what a write that created several issues and was refused part way sends to take them back. - DOCUMENTS
- Every document above, with what this source is doing when it sends one.
- DOCUMENT_
IN_ PROJECT - One document by its own node id, as
ISSUEreads one, with the project it is filed under and that project’s members beside it: the project issue whole, and a page of its sub-issues, each asSUB_ISSUEScarries one but with no page of what blocks it. - DRAFT
- One board draft by its own node id, with the board item it sits in.
- ISSUE
- One issue by its own node id, which is what a qualified id names here — with what a
write of it needs and the issue does not carry in
board_issue!: the field definitions of the boards it sits on, and the far ends of itsblockedBy. - ISSUES_
BY_ CREATION - One page of a repository’s issues, newest first, each with when it was created and its body: what a retried copy reads to find the issue its earlier attempt created, by the create key in that body’s metadata slot — never through search, whose index lags.
- ISSUES_
BY_ REFERENCE REFERENCE_BATCHissues at once, each by its repository and number — the one readtask status completemakes of a source, and nothing else of the board: noitems, no search and no project read.- ISSUE_
BOARD_ ITEMS - One issue’s board memberships alone, walked past the page a read of it carried.
- ISSUE_
COMMENTS - One task’s comments: a page of its issue’s own
commentsconnection. - ISSUE_
COPY_ DETAILS ISSUE_DETAILSas a copy reads the tasks it carries: each item with the first page of its comments and itsblockedBy— the edges a copy reads of every task next, whichISSUEcarries andISSUE_DETAILSdoes not —COPY_DETAIL_BATCHat a time, so a copy of a changed task costs this read and nothing else.- ISSUE_
DEPENDED_ ON_ BY - What depends on one issue:
ISSUE_DEPENDENCIESwith itsblockingalone. Nobody: the reverse of a recorded edge is derived from the far end, never written down here. - ISSUE_
DEPENDENCIES - Reads both dependency directions for one issue, with each far end’s own kind — and the issue’s own body, which is where an edge to another source is recorded, so that half of a dependency read needs no second read of the issue or of the board.
- ISSUE_
DEPENDS_ ON - What one item depends on:
ISSUE_DEPENDENCIESnarrowed toblockedBy, so a dependency read asks GitHub for the one direction it answers. The issue’sbodyrides along because its metadata slot is where an edge to another source is recorded — and a board draft’sbodytoo, with the one board item GitHub links a draft to and, aliasedboard, this board’s own id, so a draft’s recorded edges are read off this same answer and only when that item is this board’s: no draft read and no board read follow it. - ISSUE_
DETAIL - One issue by its own node id, with a page of its comments: what
task showand a comment listing read, in one request. - ISSUE_
DETAILS ISSUE_DETAILforDETAIL_BATCHitems at once, each by its own node id, as one fixed-size document of aliasednode(id:)fields.- ISSUE_
RELATIONS ISSUE_DETAILSwith each issue’s sub-issues in place of its comments: whattask relationsand a link write read ofDETAIL_BATCHtasks at once on a source reading sub-issues as children — each task whole, its parent and the ids of up to$firstof its children.- ORIGIN_
LOOKUP - Every carrier of one copy origin, by two reads in one request, and nothing else of the board.
- ORIGIN_
LOOKUPS - The first page of
ORIGIN_LOOKUPfor up toORIGIN_BATCHorigins a copy is about to look for, and everything creating an item then reads — the board’s own id and field definitions, asCREATION_CONTEXTreads them, and the node id and the numeric id of the repository an issue is created in — in one request. - ORIGIN_
LOOKUPS_ WITH_ MEMBERS ORIGIN_LOOKUPS, with a page of the members of the project$projectbeside it, each trimmed to what classifying it reads — its id, its parent, its body and its repository, and no connection under it.- PROJECT_
VISIBILITY - Whether the board’s Project is public — half of what decides whether a write here can
be read by anybody. Needs the
read:projectscope. - RELATES_
TO_ READS - What
DETAIL_BATCHissues relate to, one alias each: read after a relation write whose answer never arrived, so each relation is answered from what GitHub holds rather than sent again blindly. - REMOVE_
BLOCKED_ BY - Removes one native issue blocked-by relationship.
- REMOVE_
RELATES_ TO ADD_RELATES_TO’s removal: up toRELATION_BATCHrelates-torelations removed in one request.- REMOVE_
SUB_ ISSUE - Takes one issue back out of its parent.
- REPOSITORY
- Resolves the configured repository’s node id, which creating an issue requires.
- SEARCH_
BATCH - Up to
SEARCH_BATCHboard-scoped issue searches in one request, eachSEARCH_ISSUES’s connection in an aliaseds<n>field with its own query, page size and cursor, and beside them up toSEARCH_BATCH_ORIGINSorigin lookups’ board halves —ORIGIN_LOOKUP’sitemsfiltered by the origin field — in aliasedo<n>fields, each origin’s issue search in a search slot of its own. - SEARCH_
ISSUES - Every issue of one board, found by a search scoped to that board.
- SET_
PARENTS - Up to
RELATION_BATCHparent writes in one request:parent<n>anaddSubIssue(a re-parent carryingreplaceParent: true) andunparent<n>aremoveSubIssue, each sent only while its ownsend…<n>holds. GitHub runs each alias on its own and answers one it refused — a cycle, a depth or children limit — at its own path, beside the others. - STATUS_
OPTIONS_ SNAPSHOT - A fresh snapshot of the Status field and every board item’s assignment.
- STATUS_
OPTIONS_ UPDATE - Replaces a single-select field’s options. Only the guarded field setup — the
status-optionsandfieldsoperations — may use this document, because GitHub treats the input as the complete option list. - SUB_
ISSUES - One project’s tasks: the sub-issues of the issue that project is, each with a page of what blocks it.
- UPDATE_
COMMENT - Replaces the body of one issue comment.
- UPDATE_
COMMENT_ WHOLE UPDATE_COMMENT, selecting the whole issue the comment is on.- UPDATE_
DRAFT - Updates an existing draft’s user-visible fields.
- UPDATE_
FIELD - Updates a text or single-select value on one project item.
- UPDATE_
FIELDS - Writes up to six board fields and clears up to three in one ordered mutation: every
aliased field is included by its own boolean, as
FIELD_WRITE_SLOTSandFIELD_CLEAR_SLOTSname them, writes before clears. - UPDATE_
FIELD_ TOKEN UPDATE_FIELD, selecting the issue behind the board item written asUPDATE_ISSUE_TOKENselects the issue it updates.- UPDATE_
FIELD_ WHOLE UPDATE_FIELD, selecting the whole issue behind the board item written.- UPDATE_
ISSUE - Updates an issue’s visible fields and its open or closed state in one call.
- UPDATE_
ISSUES - Updates up to
MUTATION_BATCHexisting issues a copy rewrites, each with the members its ownUPDATE_ISSUEwould have sent, in one request. - UPDATE_
ISSUE_ TOKEN UPDATE_ISSUE, selecting what a read of the issue updated selects — every part of its change token, and no comment — inline, so its root fields are the plain document’s.- UPDATE_
ISSUE_ WHOLE UPDATE_ISSUE, selecting the whole issue updated.- USER_
IDS - The node id of one person by their login, as the aliased field
u0answering$login0: what an assignee write names a person by, sinceassigneeIdstakes node ids and a person is named by login. - WRITE_
FIELDS_ AND_ EDGES - A copy’s board field values and its blocked-by edges together, up to
WRITE_BATCHof the two kinds between them, in one ordered request: every field value its$sendField<n>sends, then every edge its$sendBlock<n>sends. What a copy sends when one request of its writes holds both kinds; one holding a single kind isWRITE_FIELD_VALUESorADD_BLOCKED_BYS. - WRITE_
FIELD_ VALUES - Up to
WRITE_BATCHboard field values a copy writes on the items it created, each on its own item, in one ordered request. - WRITE_
TASKS - Many tasks’ targeted updates, each as
UPDATE_FIELDSandUPDATE_ISSUEwrite one: up toTASK_FIELD_BATCHboard field values infield<n>,MUTATION_BATCHfield clears inclear<n>, and as manyupdateIssues inupdate<n>, each sent only while its ownsend…<n>holds.
Functions§
- inventoried
- The inventoried document
documentis an instance of:USER_IDSfor any lookupuser_idssized, anddocumentitself otherwise. - sized
- The document a request sending
documentwithvariablesreally sends:USER_IDSsized to the loginsvariablesbinds, and every other document as it is. - token_
twin - The document a targeted update sends in
document’s place, when it has one: the twin whose answer spells the change token of the issue written. - user_
ids USER_IDSforpeoplelogins —$login0to$login<people - 1>, each answered at its own alias — andUSER_IDSitself for one.- whole_
twin - The document sent in
document’s place while a write the store’s cache expects runs, when it has one. - with_
assignees documentas a source opted in to assignees sends it: [ASSIGNEES] selected wherever it reads an issue or a draft and in everycreateIssueandupdateIssueanswer, with the variable it pages by declared — orNonewhen it reads and writes neither, and is sent as written.- without_
assignees documentaswith_assigneesspelled it, back as the document it was written as — orNonefor a document it did not rewrite.