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

forge

package

Go to main page

Versions in this module

v0

v0.3.0

Aug 18, 2026

v0.2.0

Aug 9, 2026

Changes in this version

+ const EnumerationIncompletePrefix

+ var ErrNotFound = errors.New("resource not found (404)")

+ type MRInfo struct

+ ForkMR bool

+ IID string

+ ProjectID string

+ SourceBranch string

+ SourceSHA string

+ TargetBranch string

+ TargetSHA string

type PublicationReceipt

+ Warnings []string

type Snapshot

+ ChangedFilesComplete bool

+ ChangedFilesGap string

+ func (s Snapshot) EnumerationOpaqueReason() string

+ type Warner interface

+ Warnings func() []string

v0.1.0

Aug 5, 2026

Changes in this version

+ var ErrArmingRefused = errors.New("forge: arming precondition unmet — advisory-only, no approve/merge write")

+ var ErrIncompletePreconditions = errors.New(...)

+ var ErrInvalidSummaryMarker = errors.New("forge: UpsertComment requires artifact.kind summary-comment")

+ var ErrRescanFailed = errors.New(...)

+ var ErrSHAMoved = errors.New(...)

+ var ErrUnsupportedDecision = errors.New("forge: unsupported decision for Reconcile")

+ type Artifact struct

+ Kind string

+ SchemaVersion string

+ type CapabilityFlags struct

+ DiscussionsResolvedGate bool

+ HasApprovalRulesAPI bool

+ MergeResultDigestRecordable bool

+ MergeTrainAvailable bool

+ ProtectedPipelineExternal bool

+ Tier GitLabTier

+ type CapabilityGap struct

+ Reason CapabilityGapReason

+ Subject string

+ type CapabilityGapReason string

+ const GapApprovalRulesUnavailable

+ const GapFreeTierRequireReview

+ type Clocker interface

+ Now func() time.Time

+ type DesiredMerge struct

+ MergeResultDigest string

+ SourceSha string

+ TargetSha string

+ type DesiredReviewState struct

+ Approve bool

+ ClearSlot *Slot

+ MR string

+ Merge *DesiredMerge

+ Project string

+ Summary *DesiredSummary

+ Thread *DesiredThread

+ type DesiredSummary struct

+ Body string

+ Marker Marker

+ type DesiredThread struct

+ Body string

+ Marker Marker

+ type DuplicatePrevention string

+ const DuplicatePreventionBestEffort

+ const DuplicatePreventionSerialized

+ type Forge interface

+ Approve func(project, mr string) (string, error)

+ CreateThread func(project, mr string, marker Marker, body string) (Thread, error)

+ CurrentHeads func(project, mr string) (source, target, digest string, err error)

+ ListBotNotes func(project, mr string) ([]Note, error)

+ ListBotThreads func(project, mr string) ([]Thread, error)

+ MergeCAS func(project, mr string, m DesiredMerge) (string, error)

+ ResolveThread func(project, mr, id string) error

+ UpsertComment func(project, mr string, marker Marker, body string) (Note, error)

+ type GitLabTier string

+ const TierFree

+ const TierPremium

+ const TierUltimate

+ type MRHeads struct

+ Author string

+ ForkMR bool

+ MergeResultDigest string

+ SourceBranch string

+ SourceSHA string

+ TargetBranch string

+ TargetSHA string

+ type Marker struct

+ Artifact Artifact

+ Decision string

+ Occurrence string

+ Slot Slot

+ type Note struct

+ Author string

+ Body string

+ ID string

+ Marker Marker

+ type Operation struct

+ Kind string

+ PerformedAt string

+ TargetID string

+ type PreconditionProbe struct

+ ArmEligible bool

+ AutoMergeEligible bool

+ CapabilityGaps []CapabilityGapReason

+ DuplicatePrevention DuplicatePrevention

+ ProtectedConfigVerified bool

+ Refusals []PreconditionRefusal

+ func PreconditionFromCapabilities(caps CapabilityFlags) PreconditionProbe

+ type PreconditionRefusal struct

+ Code PreconditionRefusalCode

+ Detail string

+ type PreconditionRefusalCode string

+ const RefusalDiscussionsGateMissing

+ const RefusalInsecureTopology

+ const RefusalTierCapabilityGap

+ type Preconditions struct

+ ArmEligible bool

+ MergeResultDigest string

+ SourceSha string

+ TargetSha string

+ type PublicationReceipt struct

+ APIVersion string

+ Kind string

+ Operations []Operation

+ Repairs []Repair

+ func Reconcile(f Forge, clock Clocker, desired DesiredReviewState, pre Preconditions) (PublicationReceipt, error)

+ type Repair struct

+ Action string

+ CanonicalForgeID string

+ RepairedForgeID string

+ type ResolveRequest struct

+ MR string

+ MRAuthor string

+ MergeResultDigest string

+ Project string

+ SourceSha string

+ Subject string

+ TargetSha string

+ type ResolveResult struct

+ Evidence *aggregate.ApprovalEvidence

+ Gap *CapabilityGap

+ func ResolveWithEvidence(ev aggregate.ApprovalEvidence) ResolveResult

+ func ResolveWithGap(gap CapabilityGap) ResolveResult

+ func (r ResolveResult) HasEvidence() bool

+ func (r ResolveResult) HasGap() bool

+ func (r ResolveResult) WellFormed() error

+ type Resolver interface

+ Resolve func(req ResolveRequest) (ResolveResult, error)

+ type Slot struct

+ Effect string

+ EntryRef string

+ MR string

+ Project string

+ Rule string

+ type Snapshot struct

+ BotThreads []Thread

+ Capabilities CapabilityFlags

+ ChangedFiles []string

+ Heads MRHeads

+ type Snapshotter interface

+ Snapshot func(project, mr string) (Snapshot, error)

+ type Thread struct

+ Author string

+ ID string

+ Marker Marker

+ Resolved bool