GitHub

Sovereign

Sovereign tier required. 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

- 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 to approve editable pull-request metadata before publication, or return to Workflow Steps.

Git Command