orchestrate

Oct 2, 2026

Changes in this version

type WorktreeMergeLandOptions

+ WaitSlice time.Duration

Oct 2, 2026

Changes in this version

type HeadCheck

+ func PullRequestHeadChecksOf(ctx context.Context, repository string, view PullRequestView) ([]HeadCheck, bool, error)

+ type HeadObservation struct

+ Blocked []string

+ Checks []HeadCheck

+ Green bool

+ func ObservePullRequestHead(ctx context.Context, repository string, view PullRequestView) (HeadObservation, error)

Sep 28, 2026

Changes in this version

+ type ExpectedActionChecks struct

+ Event string

+ Names []string

+ PullRequestBase string

+ PullRequestNumber int

+ WorkflowID int64

+ type Git interface

+ BranchSetUpstreamTo func(ctx context.Context, dir, upstream, branch string) error

+ BranchShowCurrent func(ctx context.Context, dir string) (string, error)

+ CherryPick func(ctx context.Context, dir, sha string) error

+ CherryPickNoCommit func(ctx context.Context, dir string, shas ...string) error

+ CommitNoVerify func(ctx context.Context, dir, message string) error

+ CommitObjectExists func(ctx context.Context, dir, sha string) (bool, error)

+ FetchRefs func(ctx context.Context, dir, remote string, refs ...string) error

+ MergeBaseIsAncestorStrict func(ctx context.Context, dir, ancestor, descendant string) error

+ MergeTreeWriteTree func(ctx context.Context, dir, a, b string) (string, error)

+ PushForceWithLeaseHead func(ctx context.Context, dir, ref, leaseSHA string) error

+ RevListReverseRange func(ctx context.Context, dir, from, to string) (string, error)

+ RevParse func(ctx context.Context, dir, rev string) (string, error)

+ ShowTreeFormat func(ctx context.Context, dir, commit string) (string, error)

+ StatusPorcelain func(ctx context.Context, dir string) (string, error)

+ WorktreeAddDetached func(ctx context.Context, dir, path, revision string) error

+ WorktreeRemoveForce func(ctx context.Context, dir, worktree string) error

+ type PullRequestUpdateOptions struct

+ ProjectsRoot string

+ PullRequest string

+ Repository string

+ type PullRequestUpdateResult struct

+ AfterSHA string

+ BeforeSHA string

+ Branch string

+ LocalSync string

+ PullRequest string

+ Reason string

+ ReceiptPath string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Status string

+ Target string

+ TargetBeforeSHA string

+ TargetCurrentSHA string

+ TargetParentSHA string

+ func UpdatePullRequest(ctx context.Context, options PullRequestUpdateOptions) (PullRequestUpdateResult, error)

type PullRequestWaitOptions

+ ExpectedActionChecks *ExpectedActionChecks

type RemoteCheck

+ PullRequestBase string

+ PullRequestNumber int

+ WorkflowEvent string

+ WorkflowID int64

+ WorkflowRunID int64

+ type WorktreeMergeImportedMainDeadcode struct

+ CandidateSHA string

+ ImportedSHA string

+ MergeSHA string

+ OriginMainSHA string

+ TargetSHA string

+ Validation quality.VerificationReport

type WorktreeMergeLandOptions

+ DirectCIPullRequest string

type WorktreeMergePrepareOptions

+ DirectCIPullRequest string

+ Sleep func(time.Duration)

type WorktreeMergeReceipt

+ ImportedMainDeadcode *WorktreeMergeImportedMainDeadcode

type WorktreeMergeValidationDeferral

+ DirectCIBase string

+ DirectCIPullRequest string

+ DirectCIPullRequestNumber int

+ DirectCIWorkflowID int64

Sep 22, 2026

Changes in this version

+ func AcknowledgeRetiredPrepareCandidate(ctx context.Context, ...) (retiredcandidateack.Acknowledgement, error)

+ type WorktreeMergeRetiredPrepareCandidateAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Sep 19, 2026

Changes in this version

+ func IsTransientGitHubFailure(err error) bool

Sep 18, 2026

Changes in this version

+ const CreateRefusalIdentityNeedsLand

+ const LandRefusalReviewCommentCrossRepo

+ const LandRefusalReviewCommentEmpty

+ const LandRefusalReviewHeadMalformed

+ const LandRefusalReviewStale

+ const WorktreeMergeFindingDeferredValidationCheckSkipped

+ func PeekWorktreeMergeValidationDeferral(ctx context.Context, projectsRoot string, sources []string, target string, ...) (bool, error)

+ func ResolvePullRequestCreateWorktree(ctx context.Context, projectsRoot, argument string) (string, error)

+ func ReviewDigest(comment string) string

+ func SuggestClosesFromPrompt(prompt string) []int

type PullRequestCreateOptions

+ Closes []int

type PullRequestLandOptions

+ ReviewComment string

+ ReviewCommentFile string

type PullRequestLandResult

+ Closes []int

+ ReviewBound *bool

+ ReviewCommentURL string

+ ReviewDigest string

+ ReviewedHeadSHA string

+ Reviewer string

+ SelfReview bool

type RemoteCheck

+ Conclusion string

+ type ReviewerIdentity struct

+ Harness string

+ Model string

+ Session string

+ func FillReviewerIdentityFromEnvironment(identity ReviewerIdentity) ReviewerIdentity

+ func FinalizeReviewerIdentity(identity ReviewerIdentity) ReviewerIdentity

+ func ParseReviewerIdentity(raw string) ReviewerIdentity

+ func (identity ReviewerIdentity) SelfReview(other ReviewerIdentity) bool

+ func (identity ReviewerIdentity) String() string

+ type WorktreeMergeFinding struct

+ Checks []string

+ Code string

+ Message string

type WorktreeMergeLandOptions

+ ValidateLocally bool

type WorktreeMergePrepareOptions

+ RequireHostLoadAdmission func() (*WorktreeMergeHostLoadAdmission, error)

+ Route WorktreeMergeRoute

+ ValidateLocally bool

type WorktreeMergeReceipt

+ Findings []WorktreeMergeFinding

+ ValidationDeferral *WorktreeMergeValidationDeferral

+ type WorktreeMergeValidationDeferral struct

+ CandidateSHA string

+ Reason string

+ RecordedAt time.Time

+ Route WorktreeMergeRoute

Sep 18, 2026

Changes in this version

type WorktreeMergePreparedRebatch

+ ClosedPullRequest string

type WorktreeMergeReceipt

+ AutoMergeArmed bool

+ LocalSync string

+ MergedBy string

+ SupersededPullRequest string

Sep 18, 2026

Changes in this version

type PullRequestLandResult

+ LocalSync string

Sep 18, 2026

Changes in this version

+ const CreateRefusalBaseMismatch

+ const CreateRefusalCanonicalClone

+ const CreateRefusalDirtyWorktree

+ const CreateRefusalInvalidPath

+ const CreateRefusalLeftoverBeforeLanding

+ const CreateRefusalNothingStaged

+ const CreateRefusalNothingToPush

+ const CreateRefusalSecretPath

+ const CreateRefusalUnapprovedPatch

+ type CreateOutcome string

+ const CreateFindings

+ const CreateRefused

+ const CreateSuccess

+ type PullRequestCreateOptions struct

+ Add []string

+ AllowUnfenced bool

+ ApprovedBy string

+ AutoMerge bool

+ Base string

+ Body string

+ BodyFile string

+ CommitAll bool

+ CommitStaged bool

+ Draft bool

+ Events streams.EventAppender

+ EventsForRepository func(repository string) (streams.EventAppender, string)

+ Land bool

+ LandOptions *PullRequestLandOptions

+ Lane LaneGuardRequest

+ LinkPreflight func(repository string) error

+ MergeMethod string

+ Message string

+ ProjectsRoot string

+ Retry int

+ Stream string

+ Timeout time.Duration

+ Title string

+ Worktree string

+ type PullRequestCreateResult struct

+ Adopted bool

+ ApprovedBy string

+ AutoMergeArmed bool

+ AutoMergeReason string

+ BaseRef string

+ ClaimID string

+ CommittedPaths []string

+ Evidence map[string]string

+ HeadRef string

+ HeadSHA string

+ LandResult *PullRequestLandResult

+ Mechanical bool

+ NextCommand string

+ Outcome CreateOutcome

+ PullRequest int

+ Reason string

+ RefusalCode string

+ Repository string

+ SanctionedCommand string

+ SchemaVersion int

+ Task string

+ Title string

+ URL string

+ Verb string

+ func CreatePullRequest(ctx context.Context, options PullRequestCreateOptions) (result PullRequestCreateResult, err error)

+ func (result PullRequestCreateResult) ExitCode() int

Sep 18, 2026

Changes in this version

+ const LandRefusalUpdateConflict

type PullRequestLandOptions

+ NoAutoMerge bool

+ NoUpdateBranch bool

type PullRequestLandResult

+ AutoMergeArmed bool

Sep 18, 2026

Changes in this version

+ func IsTransientReadFailure(err error) bool

+ func UnsatisfiedRequiredChecks(ctx context.Context, repository, selector string) ([]string, error)

type CIFailureDetail

+ func PullRequestFailureDetails(ctx context.Context, repository, selector string) ([]CIFailureDetail, error)

Sep 18, 2026

Changes in this version

+ func CanonicalClonePath(githubDir string, repository Repository) (string, error)

Sep 18, 2026

Changes in this version

+ type AppliedFileReporter interface

+ AppliedFiles func(T) []string

+ type InPlaceInspector interface

+ InspectWorkingTree func(context.Context, string, Repository) (Assessment[T], error)

Sep 12, 2026

Changes in this version

type WorktreeMergeLandOptions

+ AllowUnfenced bool

type WorktreeMergeReceipt

+ AllowUnfenced bool

Sep 12, 2026

Changes in this version

+ type CheckoutUpdate struct

+ Cause string

+ Checkout string

+ NewSHA string

+ OldSHA string

type PullRequestLandOptions

+ CheckoutUpdated func(context.Context, CheckoutUpdate)

type WorktreeMergeLandOptions

+ CheckoutUpdated func(context.Context, CheckoutUpdate)

type WorktreeMergeUnpublishedValidationFailureAcknowledgement

+ CandidateCleanupBacklog string

+ PreservedSources []WorktreeMergeSource

Sep 9, 2026

Changes in this version

+ type WorktreeMergeLegacyConflictIdentity struct

+ AcknowledgementPath string

+ Actor string

+ Candidate WorktreeMergeCandidate

+ ClaimBaseSHA string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

type WorktreeMergeStrandedLandingAcknowledgement

+ PullRequestHeadSHA string

Sep 9, 2026

Changes in this version

+ type WorktreeMergeUnpublishedValidationFailureAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ Candidate WorktreeMergeCandidate

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func AcknowledgeUnpublishedValidationFailure(ctx context.Context, ...) (WorktreeMergeUnpublishedValidationFailureAcknowledgement, error)

+ type WorktreeMergeUnpublishedValidationFailureAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Sep 7, 2026

Changes in this version

+ const LandRefusalLandingLaneHeld

+ func WorktreeMergeLaneReleasable(status WorktreeMergeStatus) bool

+ type AbsorbedConflictAcknowledgementLookup struct

+ Acknowledged bool

+ Acknowledgement WorktreeMergeAbsorbedConflictAcknowledgement

+ Receipt WorktreeMergeReceipt

+ ReceiptPath string

+ func FindAbsorbedConflictAcknowledgement(projectsRoot, candidateTask, candidateWorktree string) (lookup AbsorbedConflictAcknowledgementLookup, ok bool, err error)

+ type LaneGuardRequest struct

+ Owner landinglane.Owner

+ StaleAfter time.Duration

+ TakeOver bool

+ TakeoverReason string

type PullRequestLandOptions

+ Lane LaneGuardRequest

type PullRequestLandResult

+ LaneOwner *landinglane.Record

type PullRequestWaitResult

+ Evidence map[string]string

type WorktreeMergeLandOptions

+ Lane LaneGuardRequest

type WorktreeMergePrepareOptions

+ Lane LaneGuardRequest

type WorktreeMergeReceipt

+ LaneOwner *landinglane.Record

+ TargetRefreshes []WorktreeMergeTargetRefresh

+ type WorktreeMergeTargetRefresh struct

+ NewCandidateSHA string

+ NewTargetSHA string

+ PreviousCandidateSHA string

+ PreviousTargetSHA string

+ RecordedAt time.Time

Sep 7, 2026

Changes in this version

+ type WorktreeMergeRetiredPublicationAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ CandidateBranch string

+ CandidateSHA string

+ CandidateTask string

+ CandidateWorktree string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ PublishedCandidateSHA string

+ PullRequest string

+ PullRequestClosedAt string

+ PullRequestHeadSHA string

+ PullRequestState string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptPhase WorktreeMergePhase

+ ReceiptSHA256 string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func AcknowledgeRetiredPublication(ctx context.Context, ...) (WorktreeMergeRetiredPublicationAcknowledgement, error)

+ type WorktreeMergeRetiredPublicationAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Sep 7, 2026

Changes in this version

+ type WorktreeMergeHostLoadAdmission struct

+ CheckedAt time.Time

+ Floor float64

+ Load float64

+ Overridden bool

+ SkippedReason string

type WorktreeMergeLandOptions

+ HostLoadAdmission *WorktreeMergeHostLoadAdmission

type WorktreeMergePrepareOptions

+ HostLoadAdmission *WorktreeMergeHostLoadAdmission

type WorktreeMergeReceipt

+ HostLoadAdmission *WorktreeMergeHostLoadAdmission

+ func PeekWorktreeMergeReceipt(projectsRoot, input string) (WorktreeMergeReceipt, error)

Sep 7, 2026

Changes in this version

type WorktreeMergeStrandedLandingAcknowledgement

+ CandidateLanding string

+ CandidateLandingTreeSHA string

Sep 7, 2026

Changes in this version

+ type WorktreeMergeAbsorbedConflictAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ CandidateBranch string

+ CandidateSHA string

+ CandidateTask string

+ CandidateWorktree string

+ CurrentTargetSHA string

+ ExcusedDerivedPaths []string

+ ID string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ SourceProofs []WorktreeMergeAbsorbedConflictSourceProof

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func AcknowledgeAbsorbedConflict(ctx context.Context, ...) (WorktreeMergeAbsorbedConflictAcknowledgement, error)

+ type WorktreeMergeAbsorbedConflictAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ DerivedPaths []string

+ ProjectsRoot string

+ Reason string

+ Receipt string

+ type WorktreeMergeAbsorbedConflictPathProof struct

+ AddedLines int

+ MatchedLines int

+ Method string

+ Path string

+ type WorktreeMergeAbsorbedConflictSourceProof struct

+ Branch string

+ MergeBaseSHA string

+ Method string

+ PathCount int

+ PathProofs []WorktreeMergeAbsorbedConflictPathProof

+ SHA string

+ Task string

+ Worktree string

Sep 7, 2026

Changes in this version

type WorktreeMergeLandOptions

+ CheckTimeout time.Duration

+ PrepareTimeout time.Duration

+ ShardAttemptTimeout time.Duration

Sep 6, 2026

Changes in this version

type WorktreeMergeReceipt

+ SourcePullRequests []WorktreeMergeSourcePullRequestReconciliation

+ type WorktreeMergeSourcePullRequestReconciliation struct

+ Closed bool

+ Commented bool

+ Number int

+ ObservedBase string

+ ObservedSHA string

+ Outcome string

+ Reason string

+ SourceSHA string

+ URL string

+ UpdatedAt time.Time

Sep 6, 2026

Changes in this version

+ type CIFailureAnnotation struct

+ EndLine int

+ Message string

+ Path string

+ StartLine int

type CIFailureDetail

+ Annotations []CIFailureAnnotation

type RemoteCheck

+ CheckRunID int64

Sep 6, 2026

Changes in this version

type PullRequestLandOptions

+ MergeMethodExplicit bool

Sep 6, 2026

Changes in this version

+ const LandRefusalCanonicalSync

type PullRequestLandResult

+ CanonicalSync string

Sep 6, 2026

Changes in this version

type WorktreeMergePrepareOptions

+ CheckTimeout time.Duration

+ PrepareTimeout time.Duration

+ ShardAttemptTimeout time.Duration

type WorktreeMergeReceipt

+ ValidationTimeouts *WorktreeMergeValidationTimeouts

+ type WorktreeMergeValidationTimeouts struct

+ Check time.Duration

+ ShardAttempt time.Duration

Sep 6, 2026

Changes in this version

type WorktreeMergeReceipt

+ ValidationIdentity *WorktreeMergeValidationIdentity

+ type WorktreeMergeValidationIdentity struct

+ CandidateSHA string

+ QualityPolicySHA string

+ SourceSHAs []string

+ TargetSHA string

+ Validators map[string]string

+ WBBuild string

+ WBExecutableSHA string

Sep 5, 2026

Changes in this version

+ type CIFailureDetail struct

+ Check string

+ Excerpt string

+ JobURL string

+ Reason string

+ RunURL string

type PullRequestWaitResult

+ FailureDetails []CIFailureDetail

Sep 5, 2026

Changes in this version

+ type WorktreeMergeConflictCandidateAdvance struct

+ AcknowledgementPath string

+ AdvancedCandidateSHA string

+ ClaimBaseSHA string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ OriginalCandidate WorktreeMergeCandidate

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

Sep 5, 2026

Changes in this version

+ type WorktreeMergeConflictCandidateRefresh struct

+ Actor string

+ Candidate WorktreeMergeCandidate

+ CurrentTargetSHA string

+ ImmutableClaimSHA256 string

+ ObservedCandidateDescendant string

+ Reason string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RequiredRoots []WorktreeMergeValidationFailureSealRoot

+ Sources []WorktreeMergeSource

+ Status string

+ func PrepareConflictWorktreeMergeReplacement(ctx context.Context, options WorktreeMergeConflictCandidateRefreshOptions) (result WorktreeMergeConflictCandidateRefresh, retErr error)

+ type WorktreeMergeConflictCandidateRefreshOptions struct

+ Actor string

+ AgentID string

+ AgentRuntime string

+ Apply bool

+ CLI string

+ ExpectedCurrentTargetSHA string

+ ExpectedImmutableClaimSHA256 string

+ ExpectedReceiptSHA256 string

+ ExpectedSourceSHAs []string

+ Initiator string

+ Model string

+ Progress progress.Reporter

+ ProjectsRoot string

+ Provider string

+ Reason string

+ Receipt string

+ Retry int

+ SessionRequired bool

+ Sources []string

+ Timeout time.Duration

+ func (options WorktreeMergeConflictCandidateRefreshOptions) RefreshTask() string

Sep 5, 2026

Changes in this version

type WorktreeMergeValidationFailureSupersession

+ ObservedCandidateDescendantSHA string

Sep 5, 2026

Changes in this version

+ type WorktreeMergeMissingCleanupAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ Assets []worktrees.TerminalWorkLogExpectation

+ CurrentTargetSHA string

+ ID string

+ LandingSHA string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Status string

+ Target string

+ func AcknowledgeMissingWorktreeMergeCleanup(ctx context.Context, options WorktreeMergeMissingCleanupAcknowledgementOptions) (WorktreeMergeMissingCleanupAcknowledgement, error)

+ type WorktreeMergeMissingCleanupAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Sep 5, 2026

Changes in this version

+ type WorktreeMergeLegacyValidationFailureIdentity struct

+ AcknowledgementPath string

+ Actor string

+ Candidate WorktreeMergeCandidate

+ ClaimBaseSHA string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

Sep 5, 2026

Changes in this version

type PullRequestWaitResult

+ PolicyAuthorityUnavailable string

+ UnfencedValidation bool

Sep 5, 2026

Changes in this version

type PullRequestWaitOptions

+ OperationProgress progress.Reporter

Sep 5, 2026

Changes in this version

type PullRequestLandOptions

+ OperationProgress progress.Reporter

Sep 4, 2026

Changes in this version

+ type WorktreeMergePublishedCandidateAdoption struct

+ AcknowledgementPath string

+ Actor string

+ Candidate WorktreeMergeCandidate

+ ID string

+ Lane string

+ PullRequest string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Status string

+ Target string

+ func AdoptPublishedWorktreeMergeCandidate(ctx context.Context, options WorktreeMergePublishedCandidateAdoptionOptions) (WorktreeMergePublishedCandidateAdoption, error)

+ type WorktreeMergePublishedCandidateAdoptionOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ PullRequest string

+ Reason string

+ Receipt string

Sep 3, 2026

Changes in this version

+ const LandRefusalChecksFailed

+ const LandRefusalChecksPending

+ const LandRefusalDraft

+ const LandRefusalHeadMoved

+ const LandRefusalKeepDoesNotBuild

+ const LandRefusalKeepNeedsCheckout

+ const LandRefusalKeepReasonMissing

+ const LandRefusalKeepUnknownCommit

+ const LandRefusalLandingUnverified

+ const LandRefusalLocked

+ const LandRefusalMergeRejected

+ const LandRefusalNotMergeable

+ const LandRefusalNotOpen

+ const LandRefusalUnapprovedPatch

+ const LandRefusalUnfencedTarget

+ func PullRequestNumber(selector string) (string, error)

+ func RepositoryFromPullRequestURL(pullRequestURL string) (string, error)

+ type ChangedFile struct

+ Filename string

+ Patch string

+ Status string

+ type HeadCheck struct

+ Bucket string

+ Name string

+ func PullRequestHeadChecks(ctx context.Context, repository, selector string) ([]HeadCheck, bool, error)

+ type LandOutcome string

+ const LandFindings

+ const LandRefused

+ const LandSuccess

+ type LandedCommit struct

+ Kept bool

+ LandedSHA string

+ SourceSHA string

+ Subject string

+ func MapLandedCommits(ctx context.Context, canonical, base, mergeBase string, landed []LandedCommit) ([]LandedCommit, error)

+ type MechanicalVerdict struct

+ Mechanical bool

+ NonManifest []string

+ Reasons []string

+ func ClassifyMechanical(files []ChangedFile) MechanicalVerdict

+ func (verdict MechanicalVerdict) Summary() string

+ type PullRequestLandOptions struct

+ AllowUnfenced bool

+ ApprovedBy string

+ BuildCommand []string

+ CheckPollInterval time.Duration

+ Events streams.EventAppender

+ Keep bool

+ KeepCommits []string

+ MergeMethod string

+ Now func() time.Time

+ Progress func(PullRequestWaitProgress)

+ ProjectsRoot string

+ PullRequest string

+ Reason string

+ Repository string

+ Slice time.Duration

+ Stream string

+ Subject string

+ type PullRequestLandResult struct

+ AbsorbedPolls int

+ ApprovedBy string

+ BaseRef string

+ BranchDeleted bool

+ ChangedFiles []string

+ Checks *PullRequestWaitResult

+ CleanedTasks []string

+ CleanupReports []string

+ Commits []LandedCommit

+ Evidence map[string]string

+ HeadRef string

+ HeadSHA string

+ KeepReason string

+ Kept bool

+ KeptCommits []string

+ LandingOnBase bool

+ ManualEquivalent []string

+ Mechanical bool

+ MergeSHA string

+ NonManifest []string

+ Outcome LandOutcome

+ PullRequest int

+ Reason string

+ RefusalCode string

+ Repository string

+ SanctionedCommand string

+ SavedTokensEstimate int

+ SavedToolCalls int

+ SchemaVersion int

+ Subject string

+ Title string

+ URL string

+ Verb string

+ func LandPullRequest(ctx context.Context, options PullRequestLandOptions) (result PullRequestLandResult, err error)

+ func (result PullRequestLandResult) ExitCode() int

+ func (result PullRequestLandResult) FooterLine() string

+ type PullRequestView struct

+ Base struct{ ... }

+ Body string

+ Draft bool

+ HTMLURL string

+ Head struct{ ... }

+ Locked bool

+ MergeCommitSHA string

+ Mergeable *bool

+ MergeableState string

+ Merged bool

+ MergedAt *time.Time

+ Number int

+ State string

+ Title string

+ func ReadPullRequest(ctx context.Context, repository, selector string) (PullRequestView, error)

+ type SourceCommit struct

+ Body string

+ SHA string

+ Subject string

Sep 2, 2026

Changes in this version

+ func MatchesHold(slug string, patterns []string) bool

type Options

+ Hold []string

type Result

+ Held bool

Sep 2, 2026

Changes in this version

+ type WorktreeMergePublishedForwardRepair struct

+ Actor string

+ Candidate WorktreeMergeCandidate

+ CurrentTargetSHA string

+ ImmutableClaimSHA256 string

+ Reason string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RequiredRoots []WorktreeMergeValidationFailureSealRoot

+ Sources []WorktreeMergeSource

+ Status string

+ SupersessionPath string

+ SupersessionSHA256 string

+ func PreparePublishedValidationFailureForwardRepair(ctx context.Context, options WorktreeMergePublishedForwardRepairOptions) (result WorktreeMergePublishedForwardRepair, retErr error)

+ type WorktreeMergePublishedForwardRepairOptions struct

+ Actor string

+ AgentID string

+ AgentRuntime string

+ Apply bool

+ CLI string

+ ExpectedCurrentTargetSHA string

+ ExpectedImmutableClaimSHA256 string

+ ExpectedReceiptSHA256 string

+ ExpectedSourceSHAs []string

+ ExpectedSupersessionSHA256 string

+ Initiator string

+ Model string

+ ProjectsRoot string

+ Provider string

+ Reason string

+ Receipt string

+ Retry int

+ SessionRequired bool

+ Sources []string

+ Timeout time.Duration

+ func (options WorktreeMergePublishedForwardRepairOptions) RepairTask() string

+ type WorktreeMergeReceiptCollisionAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ Candidate WorktreeMergeCandidate

+ ClaimBaseSHA string

+ CurrentSources []WorktreeMergeSource

+ ExpectedCandidateSHA string

+ ExpectedCurrentSourceSHA string

+ ExpectedHistoricalRefreshSourceSHA string

+ ExpectedTargetSHA string

+ HistoricalRefreshSources []WorktreeMergeSource

+ HistoricalValidationFailedOperatorAssertion bool

+ ID string

+ ImmutableClaimSHA256 string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Status string

+ Target string

+ func AcknowledgeWorktreeMergeReceiptCollision(ctx context.Context, ...) (WorktreeMergeReceiptCollisionAcknowledgement, error)

+ type WorktreeMergeReceiptCollisionAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ExpectedCandidateSHA string

+ ExpectedCurrentSourceSHA string

+ ExpectedHistoricalRefreshSourceSHA string

+ ExpectedImmutableClaimSHA256 string

+ ExpectedReceiptSHA256 string

+ ExpectedTargetSHA string

+ ProjectsRoot string

+ Reason string

+ Receipt string

+ type WorktreeMergeSelfSupersessionCorrection struct

+ Actor string

+ CorrectedReplacement WorktreeMergeCandidate

+ CorrectionPath string

+ CurrentTargetSHA string

+ ID string

+ ImmutableClaimSHA256 string

+ OriginalCandidate WorktreeMergeCandidate

+ OriginalClaimBaseSHA string

+ Reason string

+ ReceiptPath string

+ ReceiptSHA256 string

+ RecordedAt time.Time

+ ReplacementClaimBaseSHA string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ SupersessionID string

+ SupersessionPath string

+ SupersessionSHA256 string

+ func CorrectValidationFailedSelfSupersession(ctx context.Context, options WorktreeMergeSelfSupersessionCorrectionOptions) (WorktreeMergeSelfSupersessionCorrection, error)

+ type WorktreeMergeSelfSupersessionCorrectionOptions struct

+ Actor string

+ Apply bool

+ ExpectedImmutableClaimSHA256 string

+ ExpectedSupersessionSHA256 string

+ ProjectsRoot string

+ Reason string

+ Receipt string

+ ReplacementWorktree string

Sep 2, 2026

Changes in this version

+ type WorktreeMergeStrandedLandingAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ CandidateSHA string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ ProvedLandingSHA string

+ PullRequest string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func AcknowledgeStrandedPullRequestLanding(ctx context.Context, ...) (WorktreeMergeStrandedLandingAcknowledgement, error)

+ type WorktreeMergeStrandedLandingAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Sep 2, 2026

Changes in this version

+ const FetchMemoMaxAge

type FetchMemo

+ func (memo *FetchMemo) Skips() int

type Options

+ FetchMemoDiscovery bool

Sep 2, 2026

Changes in this version

+ type FetchMemo struct

+ func NewFetchMemo() *FetchMemo

+ func (memo *FetchMemo) MarkFetched(slug string)

+ func (memo *FetchMemo) MarkTouched(slug string)

+ func (memo *FetchMemo) SkipFetch(slug string) bool

type Options

+ FetchMemo *FetchMemo

Sep 1, 2026

Changes in this version

+ type MergeLaneClaim struct

+ Lane string

+ ReceiptPath string

+ Status string

+ Target string

+ func ActiveMergeLaneClaim(projectsRoot, repository, branch string) (*MergeLaneClaim, error)

Sep 1, 2026

Changes in this version

+ var DefaultStableRereadDelay = 15 * time.Second

type PullRequestWaitOptions

+ StableRereadDelay time.Duration

Sep 1, 2026

Changes in this version

type WorktreeMergeLandOptions

+ StopBeforeMerge bool

type WorktreeMergeStatus

+ const WorktreeMergePublished

Sep 1, 2026

Changes in this version

type WorktreeMergePrepareOptions

+ RebatchReceipt string

+ type WorktreeMergePreparedRebatch struct

+ AcknowledgementPath string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ OriginalCandidate WorktreeMergeCandidate

+ OriginalSources []WorktreeMergeSource

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Replacement WorktreeMergeCandidate

+ ReplacementReceiptPath string

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

type WorktreeMergeReceipt

+ RebatchOf string

+ RebatchedCandidates []WorktreeMergeCandidate

Sep 1, 2026

Changes in this version

+ type WorktreeMergeValidationFailureSeal struct

+ Actor string

+ Candidate WorktreeMergeCandidate

+ CurrentTargetSHA string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ Repository string

+ RequiredRoots []WorktreeMergeValidationFailureSealRoot

+ Status string

+ Target string

+ TargetTreeSHA string

+ func PrepareValidationFailedWorktreeMergeSeal(ctx context.Context, options WorktreeMergeValidationFailureSealOptions) (WorktreeMergeValidationFailureSeal, error)

+ type WorktreeMergeValidationFailureSealOptions struct

+ Actor string

+ AgentID string

+ AgentRuntime string

+ Apply bool

+ CLI string

+ Initiator string

+ Model string

+ ProjectsRoot string

+ Provider string

+ Reason string

+ Receipt string

+ Retry int

+ SessionRequired bool

+ Timeout time.Duration

+ type WorktreeMergeValidationFailureSealRoot struct

+ Kind string

+ SHA string

Sep 1, 2026

Changes in this version

+ type WorktreeMergeValidationFailureSupersession struct

+ AcknowledgementPath string

+ Actor string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ OriginalCandidate WorktreeMergeCandidate

+ OriginalClaimBaseSHA string

+ Reason string

+ ReceiptID string

+ ReceiptPath string

+ ReceiptSHA256 string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Replacement WorktreeMergeCandidate

+ ReplacementClaimBaseSHA string

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func SupersedeValidationFailedWorktreeMerge(ctx context.Context, options WorktreeMergeValidationFailureSupersessionOptions) (WorktreeMergeValidationFailureSupersession, error)

+ type WorktreeMergeValidationFailureSupersessionOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

+ ReplacementWorktree string

Aug 31, 2026

Changes in this version

+ type WorktreeMergeLandedFailureAcknowledgement struct

+ AcknowledgementPath string

+ Actor string

+ CandidateBranch string

+ CandidateSHA string

+ CandidateWorktree string

+ ClaimBaseSHA string

+ CurrentTargetSHA string

+ ID string

+ Lane string

+ Reason string

+ ReceiptID string

+ ReceiptLandingSHA string

+ ReceiptPath string

+ ReceiptStatus WorktreeMergeStatus

+ ReceiptTargetSHA string

+ RecordedAt time.Time

+ Repository string

+ SchemaVersion int

+ Sources []WorktreeMergeSource

+ Status string

+ Target string

+ func AcknowledgeLandedMergeFailure(ctx context.Context, options WorktreeMergeLandedFailureAcknowledgementOptions) (WorktreeMergeLandedFailureAcknowledgement, error)

+ type WorktreeMergeLandedFailureAcknowledgementOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Reason string

+ Receipt string

Aug 31, 2026

Changes in this version

type Options

+ WaitForPRChecks bool

type PullRequestWaitOptions

+ AllowUnfenced bool

Aug 30, 2026

Changes in this version

type Options

+ DependencyCampaign bool

Aug 29, 2026

Changes in this version

type PullRequestWaitOptions

+ AllowTargetDescendant bool

type PullRequestWaitResult

+ TargetContainsHead bool

Aug 28, 2026

Changes in this version

type WorktreeMergeLandOptions

+ Progress progress.Reporter

+ ProgressRequested bool

type WorktreeMergePrepareOptions

+ Progress progress.Reporter

+ ProgressRequested bool

Aug 28, 2026

Changes in this version

type WorktreeMergeReceipt

+ BaselineValidation quality.VerificationReport

Aug 28, 2026

Changes in this version

+ const WorktreeMergeSchemaVersion

+ type WorktreeMergeCandidate struct

+ Branch string

+ SHA string

+ Task string

+ Worktree string

+ type WorktreeMergeForwardRepairReceipt struct

+ CandidateSHA string

+ Checks PullRequestWaitResult

+ Failure string

+ LandingSHA string

+ PullRequest string

+ Status WorktreeMergeStatus

+ TargetSHA string

+ type WorktreeMergeLandOptions struct

+ CheckPollInterval time.Duration

+ Cleanup bool

+ OnFailure string

+ ProjectsRoot string

+ Receipt string

+ Retry int

+ Route WorktreeMergeRoute

+ Timeout time.Duration

+ type WorktreeMergePhase string

+ const WorktreeMergePhaseLand

+ const WorktreeMergePhasePrepare

+ const WorktreeMergePhaseRevert

+ type WorktreeMergePrepareOptions struct

+ AgentID string

+ AgentRuntime string

+ CLI string

+ Initiator string

+ Model string

+ ProjectsRoot string

+ Provider string

+ Retry int

+ Sources []string

+ Target string

+ Timeout time.Duration

+ type WorktreeMergePushGateReceipt struct

+ LocalSHA string

+ ObservedAt time.Time

+ PreviousRemoteSHA string

+ Remote string

+ RemoteRef string

+ Status string

+ type WorktreeMergeRebaseReceipt struct

+ CandidateAfter string

+ CandidateBefore string

+ TargetAfter string

+ TargetBefore string

+ type WorktreeMergeReceipt struct

+ Candidate WorktreeMergeCandidate

+ CanonicalSync string

+ Checks PullRequestWaitResult

+ CleanedTasks []string

+ Cleanup bool

+ CleanupReports []string

+ CreatedAt time.Time

+ Failure string

+ ForwardRepairs []WorktreeMergeForwardRepairReceipt

+ ID string

+ LandingSHA string

+ Lane string

+ OnFailure string

+ Phase WorktreeMergePhase

+ PreviousTargetSHA string

+ PublishedCandidateSHA string

+ PullRequest string

+ PushGate *WorktreeMergePushGateReceipt

+ Rebase *WorktreeMergeRebaseReceipt

+ ReceiptPath string

+ Repository string

+ ResumeArgs []string

+ RevertOf *WorktreeMergeRevertReceipt

+ Route WorktreeMergeRouteDecision

+ SchemaVersion int

+ SourceRefreshes []WorktreeMergeSourceRefresh

+ Sources []WorktreeMergeSource

+ Status WorktreeMergeStatus

+ Target string

+ TargetSHA string

+ UpdatedAt time.Time

+ Validation quality.VerificationReport

+ func LandWorktreeMerge(ctx context.Context, options WorktreeMergeLandOptions) (WorktreeMergeReceipt, error)

+ func PrepareWorktreeMerge(ctx context.Context, options WorktreeMergePrepareOptions) (WorktreeMergeReceipt, error)

+ func PrepareWorktreeMergeRevert(ctx context.Context, projectsRoot, input string, timeout time.Duration, ...) (WorktreeMergeReceipt, error)

+ func ResumeWorktreeMerge(ctx context.Context, options WorktreeMergeLandOptions) (WorktreeMergeReceipt, error)

+ func RunWorktreeMerge(ctx context.Context, prepare WorktreeMergePrepareOptions, ...) (WorktreeMergeReceipt, error)

+ type WorktreeMergeRevertReceipt struct

+ CandidateSHA string

+ LandingSHA string

+ PreviousTargetSHA string

+ type WorktreeMergeRoute string

+ const WorktreeMergeRouteAuto

+ const WorktreeMergeRouteDirect

+ const WorktreeMergeRoutePullRequest

+ const WorktreeMergeRouteUnsupported

+ type WorktreeMergeRouteDecision struct

+ Reason string

+ Requested WorktreeMergeRoute

+ Route WorktreeMergeRoute

+ func ResolveWorktreeMergeRoute(ctx context.Context, repository, target string, requested WorktreeMergeRoute) (WorktreeMergeRouteDecision, error)

+ type WorktreeMergeSource struct

+ Branch string

+ Merged bool

+ SHA string

+ Task string

+ Worktree string

+ type WorktreeMergeSourceRefresh struct

+ RecordedAt time.Time

+ Sources []WorktreeMergeSource

+ type WorktreeMergeStatus string

+ const WorktreeMergeCanonicalSyncBlocked

+ const WorktreeMergeChecksFailed

+ const WorktreeMergeChecksPending

+ const WorktreeMergeComplete

+ const WorktreeMergeConflict

+ const WorktreeMergeLanded

+ const WorktreeMergePostTargetCIFailed

+ const WorktreeMergePrepared

+ const WorktreeMergePreparing

+ const WorktreeMergeValidationFailed

Aug 27, 2026

Changes in this version

type Options

+ AgentRuntime string

+ CLI string

+ Initiator string

+ Model string

+ Prompt string

+ Provider string

Aug 26, 2026

Changes in this version

+ type ResolvedBase struct

+ Fallback bool

+ Ref string

Aug 25, 2026

Changes in this version

type Options

+ Progress progress.Reporter

Aug 25, 2026

Changes in this version

type PullRequestWaitOptions

+ Progress func(PullRequestWaitProgress)

+ type PullRequestWaitProgress struct

+ NextPoll time.Duration

+ Observation int

+ Result PullRequestWaitResult

Aug 11, 2026

Changes in this version

+ const DefaultCheckPollInterval

Aug 10, 2026

Changes in this version

+ const MaxForegroundCheckWaitSlice

+ type PullRequestWaitOptions struct

+ CheckPollInterval time.Duration

+ Head string

+ PullRequest string

+ Repository string

+ Slice time.Duration

+ Target string

+ type PullRequestWaitResult struct

+ CandidateContainsTarget bool

+ Checks []RemoteCheck

+ Head string

+ ObservedHead string

+ ObservedTargetHead string

+ PullRequest string

+ Reason string

+ Repository string

+ RequiredChecks []RequiredRemoteCheck

+ RequiredChecksAuthority string

+ StableObservations int

+ Status PullRequestWaitStatus

+ Target string

+ TargetFreshnessAuthority string

+ func WaitForCommitChecks(ctx context.Context, options PullRequestWaitOptions) (PullRequestWaitResult, error)

+ func WaitForPullRequestChecks(ctx context.Context, options PullRequestWaitOptions) (PullRequestWaitResult, error)

+ type PullRequestWaitStatus string

+ const PullRequestWaitFailed

+ const PullRequestWaitPassed

+ const PullRequestWaitPending

type RemoteCheck

+ AppID int64

+ type RequiredRemoteCheck struct

+ IntegrationID int64

+ Name string

Jul 22, 2026

Changes in this version

type Options

+ CheckPollInterval time.Duration

Jul 22, 2026

Changes in this version

+ func EnsureCanonical(ctx context.Context, repository Repository, canonical string, options Options) error

+ type Assessment struct

+ Applicable bool

+ Metadata T

+ NeedsChange bool

+ Reason string

+ type Handler interface

+ Apply func(context.Context, string, Repository) (T, error)

+ CommitMessage func(Repository) string

+ Inspect func(context.Context, string, string, Repository) (Assessment[T], error)

+ PullRequest func(Repository) (title, body string)

+ ValidatePublishable func(context.Context, string, Repository) error

+ type OperationLock struct

+ func AcquireOperationLock(githubDir, operation string) (OperationLock, error)

+ func (lock OperationLock) Release()

+ type Options struct

+ Branch string

+ Checks []quality.Check

+ Commit bool

+ DryRun bool

+ GitHubDir string

+ Merge bool

+ Operation string

+ PR bool

+ Parallel int

+ Push bool

+ Ref string

+ Resume bool

+ Retry int

+ Timeout time.Duration

+ Verify bool

+ func Normalize(options Options) (Options, error)

+ type RemoteCheck struct

+ Bucket string

+ Link string

+ Name string

+ type Repository struct

+ Archived bool

+ CloneURL string

+ Path string

+ Slug string

+ type Result struct

+ Branch string

+ CanonicalDir string

+ ChangedFiles []string

+ Checks []RemoteCheck

+ Commit string

+ Merged bool

+ Metadata T

+ PR string

+ Pushed bool

+ Reason string

+ Ref string

+ Repository string

+ Status string

+ Verifications []quality.VerificationEntry

+ WorktreeDir string

+ func Run[T any](ctx context.Context, repositories []Repository, handler Handler[T], ...) ([]Result[T], error)