Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

github

package

Go to main page

Versions in this module

v0

v0.2.1

Oct 19, 2026

Changes in this version

+ func AppJWT(appID string, key *rsa.PrivateKey) (string, error)

+ func ParseAppKey(raw []byte) (*rsa.PrivateKey, error)

+ func VerifyOperationOwner(change forge.Change, reference forge.RepoRef, operationID string, ...) bool

+ type AppConfig struct

+ AppID string

+ InstallationID string

+ PrivateKeyPEM []byte

+ func (a AppConfig) GoString() string

+ func (a AppConfig) LogValue() slog.Value

+ func (a AppConfig) String() string

+ type MergeGuard func(context.Context, forge.MergeRequest, forge.Change, forge.Rules) error

+ type Provider struct

+ func New(config forge.Config) (*Provider, error)

+ func NewApp(ctx context.Context, cfg forge.Config, app AppConfig) (*Provider, error)

+ func (p *Provider) Behind(ctx context.Context, r forge.RepoRef, base, head string) (int, error)

+ func (p *Provider) CancelNativeQueue(ctx context.Context, request forge.QueueCancelRequest) (forge.QueueState, error)

+ func (p *Provider) CancelPipeline(ctx context.Context, in forge.PipelineRequest) (forge.DeploymentStatus, error)

+ func (p *Provider) CloseChange(ctx context.Context, in forge.CloseChangeRequest) (forge.Change, error)

+ func (p *Provider) CloseIdleConnections()

+ func (p *Provider) CommentChange(ctx context.Context, in forge.CommentChangeRequest) (forge.Change, error)

+ func (p *Provider) CreateChange(ctx context.Context, request forge.CreateChangeRequest) (forge.Change, error)

+ func (p *Provider) DecodeEvent(headers http.Header, payload []byte) (forge.Event, error)

+ func (p *Provider) EvaluateNativeEligibility(ctx context.Context, r forge.RepoRef, id string) (forge.NativeEligibility, error)

+ func (p *Provider) EvaluateQueuePrerequisites(ctx context.Context, r forge.RepoRef, id string) (forge.NativeEligibility, forge.CheckRule, error)

+ func (p *Provider) FindChangeByOperation(ctx context.Context, reference forge.RepoRef, operationID string, ...) (*forge.Change, error)

+ func (p *Provider) GetRepository(ctx context.Context, reference forge.RepoRef) (forge.Repository, error)

+ func (p *Provider) ListAdvisories(ctx context.Context, reference forge.RepoRef) ([]forge.Advisory, error)

+ func (p *Provider) ListAllowedWorkflows(ctx context.Context, reference forge.RepoRef) ([]forge.Workflow, error)

+ func (p *Provider) ListBotWork(ctx context.Context, reference forge.RepoRef) ([]forge.Change, error)

+ func (p *Provider) ListChecks(ctx context.Context, reference forge.RepoRef, ref string) ([]forge.Check, error)

+ func (p *Provider) ListIssues(ctx context.Context, reference forge.RepoRef) ([]forge.Issue, error)

+ func (p *Provider) ListRepositories(ctx context.Context, request forge.InventoryRequest) (domain.Page[forge.Repository], error)

+ func (p *Provider) PermissionsURL(ctx context.Context) (string, error)

+ func (p *Provider) ProbeCapabilities(ctx context.Context) (forge.Capabilities, error)

+ func (p *Provider) ReadApprovals(ctx context.Context, r forge.RepoRef, id string) ([]forge.Approval, error)

+ func (p *Provider) ReadChange(ctx context.Context, reference forge.RepoRef, changeID string) (forge.Change, error)

+ func (p *Provider) ReadCheckLog(ctx context.Context, reference forge.RepoRef, checkID string) (string, error)

+ func (p *Provider) ReadCommitProof(ctx context.Context, r forge.RepoRef, sha string) (forge.CommitProof, error)

+ func (p *Provider) ReadDeploymentGates(ctx context.Context, r forge.RepoRef, environment string) (forge.DeploymentGates, error)

+ func (p *Provider) ReadDeploymentStatus(ctx context.Context, reference forge.RepoRef, runID string) (forge.DeploymentStatus, error)

+ func (p *Provider) ReadEffectiveRules(ctx context.Context, r forge.RepoRef, branch string) (forge.Rules, error)

+ func (p *Provider) ReadExecutionCheck(ctx context.Context, repository forge.RepoRef, id string) (forge.ExecutionCheck, error)

+ func (p *Provider) ReadFileAtRef(ctx context.Context, reference forge.RepoRef, filePath string, ref string) (forge.File, error)

+ func (p *Provider) ReadMergeResult(ctx context.Context, r forge.RepoRef, id string) (forge.MergeResult, error)

+ func (p *Provider) ReadQueueState(ctx context.Context, r forge.RepoRef, id string) (forge.QueueState, error)

+ func (p *Provider) ReadSourceManifest(ctx context.Context, r forge.RepoRef, commit string) (forge.SourceManifest, error)

+ func (p *Provider) ReconcileChanges(ctx context.Context, reference forge.RepoRef, cursor string) (domain.Page[forge.Change], error)

+ func (p *Provider) RefreshAppBranch(ctx context.Context, in forge.RefreshBranchRequest) error

+ func (p *Provider) RequestAllowedRecovery(ctx context.Context, in forge.PipelineRequest) (forge.DeploymentStatus, error)

+ func (p *Provider) RequestNativeMergeOrQueue(ctx context.Context, in forge.MergeRequest) (forge.MergeResult, error)

+ func (p *Provider) RequestReview(ctx context.Context, reference forge.RepoRef, changeID string, ...) error

+ func (p *Provider) ResolveRef(ctx context.Context, reference forge.RepoRef, ref string) (string, error)

+ func (p *Provider) TriggerOrObservePipeline(ctx context.Context, in forge.PipelineRequest) (forge.DeploymentStatus, error)

+ func (p *Provider) UpdateAppBranch(ctx context.Context, in forge.UpdateBranchRequest) (string, error)

+ func (p *Provider) VerifyWebhook(headers http.Header, payload []byte) error

+ func (p *Provider) WithBranchAuthorizer(fn func(context.Context, forge.UpdateBranchRequest) error) *Provider

+ func (p *Provider) WithBranchRefreshAuthorizer(fn func(context.Context, forge.RefreshBranchRequest) error) *Provider

+ func (p *Provider) WithChangeAuthorizer(fn func(context.Context, forge.CreateChangeRequest) error) *Provider

+ func (p *Provider) WithDeliveryGuard(guard forge.DeliveryGuard) *Provider

+ func (p *Provider) WithGraphQL(endpoint string, client forge.HTTPClient) (*Provider, error)

+ func (p *Provider) WithMergeGuard(fn MergeGuard) *Provider

+ func (p *Provider) WithReviewAuthorizer(fn func(context.Context, forge.RepoRef, string, []string) error) *Provider

+ func (p *Provider) WriteExecutionCheck(ctx context.Context, in forge.ExecutionCheckRequest) (forge.ExecutionCheck, error)