# GitHub
{{< tier level="sovereign" note="GitHub steps publish approved pull-request metadata and exact reviewed branch evidence." >}}

Use the **GitHub** adapter after a workflow has recorded the repository identity, exact head commit, and approved pull-request title, body, and draft state. The adapter provides one action: `create_pull_request`.

## Configuration

```yaml
- key: create_pr
  name: Create pull request
  kind: tool
  tool:
    id: github
    action: create_pull_request
  inputs:
    projectKey: "${workflow.inputs.projectKey}"
    remoteName: "${workflow.inputs.remoteName}"
    expectedRemoteUrlDigest: "${steps.observe_remote.outputs.remoteUrlDigest}"
    baseBranch: "${workflow.inputs.baseBranch}"
    headBranch: "${workflow.inputs.headBranch}"
    expectedHeadSha: "${steps.resolve_head.outputs.resolvedSha}"
    title: "${steps.approve_proposal.outputs.title}"
    body: "${steps.approve_proposal.outputs.body}"
    draft: "${steps.approve_proposal.outputs.draft}"
  outputs:
    outcome: "$.normalized.outcome"
    number: "$.normalized.number"
    url: "$.normalized.url"
```

| Input | Required | Purpose |
| --- | --- | --- |
| `projectKey` | Yes | Registered Valdr project; a project-scoped run can supply it |
| `remoteName` | Yes | Configured Git remote, commonly `origin` |
| `expectedRemoteUrlDigest` | Yes | Frozen remote identity from Git `remote_status` |
| `baseBranch` | Yes | Pull-request target branch |
| `headBranch` | Yes | Published source branch |
| `expectedHeadSha` | Yes | Exact approved head commit |
| `title`, `body`, `draft` | Yes | Approved pull-request proposal |

Valdr resolves the repository from `projectKey` and supplies the request identity. The action creates the pull request or adopts the matching existing same-repository request. A changed remote, head commit, or proposal blocks publication instead of silently publishing different work. The workflow host must have the GitHub CLI installed and authenticated for the selected repository.

## Included workflow

The official Valdr Workflow pack includes **Create Pull Request** (`valdr-workflow.pull-request.create`). It records local and remote refs, drafts a proposal from the exact diff, lets an authorized operator edit and approve it, rechecks the evidence, pushes the exact head, and creates or adopts the pull request.

## Next step

Use a [Human-Gate Step](../human-gate/) to approve editable pull-request metadata before publication, or return to [Workflow Steps](../).