Creating repositories/branches/pull_requests about shortcut-client-js

[wmoline]

Hey again! We chatted in ZenDesk, but I wanted to make sure there was follow up here as well.

The VCS entities like repository, branch, commit, and pull request aren't currently publicly accessible. There's a significant amount of logic around what happens when those entities are associated with a Story; we might never expose those endpoints, and instead build out more options for the integration internally. It doesn't hurt to ask though!

You may be able to do a fair bit of what you're after by taking advantage of the different ways the existing GitHub integration can associate work to Stories, and Github's API.

Using the Story ID in one of the ways that Clubhouse is listening for is going to be your best bet for the initial association.

For things like automatically creating stories when someone creates a PR against certain repos, you might use GitHub's webhooks to listen for the PR creation, and use the Story endpoint to create a new Story based on that PR.

Then, with the returned new Story details, grab the Story ID and use GitHib's Issue Comments endpoint to add bracketed text [ch###], where ### is the Story ID, as a comment on the PR. If Clubhouse's Github integration is on, and the webhook was already added to the repository in Github, Clubhouse should associate the PR with the Story in the comment.

Between the two, there's a lot of ways to customize a workflow!