Investigate GitHub's GraphQL API

[AlekSi]

For #45, we will need to start interacting with GitHub Projects (beta) via GraphQL API: https://docs.github.com/en/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects

First, let's try querying that API manually via gh tool.

Second, let's investigate what Go modules we should use for that API (probably https://github.com/shurcooL/githubv4?)

Lastly, let's add some code to conform-pr GitHub Action that queries project's iteration for PRs.

[rumyantseva]

Current state

WiP in a local branch - https://github.com/rumyantseva/github-actions/tree/issue-44-trying-graphql (there are some things to try/discuss)

[rumyantseva]

Main learnings

API

• There is no GraphQL API for GithubActions.
• Useful docs: everything starting from the ProjectNext prefix here. ProjectNext is used for new (beta) projects.
• If we are going to use GraphQL from GitHub CI, it might be important to keep in mind Rate Limit.

Objects and ids

• PR - PR_
• Issue - I_
• Project Next (new beta projects) - PN_
• Card on a board (project next item) - PNI_ (draft, issue or pull request)
• View in a project next - PNV_
• Field in a project next - PNF_
• Field values (in cards) - PNIFV_
• etc.

How to find PR id or Issue id from Card

It works through content:

{
	user(login: "rumyantseva") {
		
		projectNext(number: 1) {
			id 
			title
			
			items(first: 20) {
				totalCount
				nodes {
					id
					title
					type
					content {
						... on PullRequest  {
								id
						}
						
						... on Issue {
							id
						}
					}

...

				}
			}
		
		}
	}
}

How to find current status, sprint, etc

It is set in field values (PNIFV_) for cards (PNI_), but not for PR/Issue themselves.

How to find a PNI card by Issue id or PR id?

Through projectNextItems:

{
	node(id: "PR_kwDOGTO-Gs45XwlA") { 
		... on PullRequest  {
			
			title
			state
			id
			
			
			projectNextItems(first: 20) {
				totalCount
				nodes {
					id
					fieldValues(first: 20) {
						totalCount
						nodes {
							value
							projectField {
								name 
								settings 
							}
						}
					}
				}
				
			}
			
		}	
		
	}
}