worktrees

Oct 2, 2026

Changes in this version

+ type LiveOwner struct

+ Agent string

+ At time.Time

+ PID int

+ func DeclaredOwnerLiveReadOnly(worktree string) (state string, owner LiveOwner)

Oct 1, 2026

Changes in this version

+ var ErrCollaborationCanonicalClone = errors.New("coordination requires a linked worktree, not its canonical clone")

+ func ObserveCollaborationLegacyOwner(worktree, sessionDirectory string) (worktreecollab.ObservedOwner, error)

+ func ObserveCollaborationLegacyOwnerReadOnly(worktree, sessionDirectory string) (worktreecollab.ObservedOwner, error)

+ func ResolveCollaborationCheckout(ctx context.Context, projectsRoot, idOrPath string) (worktreecollab.Checkout, error)

+ func SecureGitHelperForArgument(argument string) (func([]string) int, bool)

Sep 28, 2026

Changes in this version

+ func ReadRemovedTerminalWorkLogClaimBase(projectsRoot string, expectation TerminalWorkLogExpectation) (string, error)

Sep 24, 2026

Changes in this version

type BranchEntry

+ OpenBasePullRequest *PullRequest

+ PullRequestQueried bool

+ PullRequestQueryError string

+ PullRequests []BranchPullRequest

type BranchListOptions

+ WithPRs bool

+ type BranchPullRequest struct

+ Base string

+ Head string

+ HeadSHA string

+ MergeSHA string

+ MergedAt *time.Time

+ Number int

+ Role string

+ State string

+ URL string

Sep 24, 2026

Changes in this version

type BranchEntry

+ RefKind string

type BranchListOutcome

+ RetiredTagNames int

+ RetiredTags map[string]int

type RetireOptions

+ Preserve string

type RetireResult

+ Preserve string

Sep 23, 2026

Changes in this version

+ type RetireOptions struct

+ Apply bool

+ ArchiveRemote string

+ Inspect RetiredArchiveInspector

+ Message string

+ Now func() time.Time

+ OpenPullRequests func(context.Context, string, string, string) (bool, error)

+ ProjectsRoot string

+ RemoteOwnership func(context.Context, string) error

+ Repository string

+ Task string

+ type RetireResult struct

+ ArchiveRef string

+ ArchiveRepository string

+ ArchiveSHA string

+ Branch string

+ Canonical string

+ ClaimID string

+ DeleteIntentSHA string

+ EffortID string

+ IntentAt time.Time

+ IntentMessage string

+ IntentParentSHA string

+ IntentTreeSHA string

+ Local bool

+ OriginalRemoteSHA string

+ Phase string

+ ReportPath string

+ Repository string

+ RetiredRef string

+ RunID string

+ SourceSHA string

+ Task string

+ Version int

+ Worktree string

+ WorktreesRoot string

+ func Retire(ctx context.Context, options RetireOptions) (RetireResult, error)

Sep 23, 2026

Changes in this version

+ const DefaultRetiredArchiveRepository

+ type RetiredArchiveInspection struct

+ Exists bool

+ Private bool

+ Repository string

+ type RetiredArchiveInspector func(context.Context, string) (RetiredArchiveInspection, error)

+ type RetiredArchivePlan struct

+ ArchiveRepository string

+ GeneratedAt time.Time

+ LocalQuarantine string

+ Outcome string

+ Refusal string

+ RemoteRefRename bool

+ SourceRepository string

+ WorkLogExport string

+ WorktreeDeletion bool

+ func PlanRetiredArchivePreflight(ctx context.Context, sourceRepository string, inspect RetiredArchiveInspector) (RetiredArchivePlan, error)

+ type RetiredArchiveTarget struct

+ Organization string

+ Repository string

+ func ResolveRetiredArchiveTarget(organization string) (RetiredArchiveTarget, error)

Sep 23, 2026

Changes in this version

type BranchListOutcome

+ RetiredRemoteUnavailable bool

Sep 23, 2026

Changes in this version

+ const BranchRetired

+ func QuarantineManifestDigest(path string) (string, error)

type BranchEntry

+ Author string

+ Title string

type BranchListOptions

+ IncludeRetired bool

+ Name string

+ Org string

type BranchListOutcome

+ Org string

+ RetiredBranches int

+ RetiredRefs map[string]int

+ type BranchQuarantineManifest struct

+ Entries []BranchQuarantineRequest

+ type BranchQuarantineOptions struct

+ Apply bool

+ Branch string

+ Manifest string

+ Now func() time.Time

+ ProjectsRoot string

+ Reason string

+ ReportDir string

+ Repository string

+ SHA string

+ type BranchQuarantineOutcome struct

+ Apply bool

+ GeneratedAt time.Time

+ ReportPath string

+ Results []BranchQuarantineResult

+ func BranchQuarantine(ctx context.Context, options BranchQuarantineOptions) (BranchQuarantineOutcome, error)

+ type BranchQuarantineRequest struct

+ Reason string

+ Ref string

+ Repository string

+ SHA string

+ type BranchQuarantineResult struct

+ Destination string

+ Error string

+ Outcome string

Sep 22, 2026

Changes in this version

type ListResult

+ RetiredPrepareCandidateAcknowledgementPath string

Sep 21, 2026

Changes in this version

+ const BranchSuperseded

type BranchCleanupOptions

+ Branch string

+ PeerEvidence []string

+ Repository string

+ RequireHosts []string

+ SupersededBy string

type BranchCleanupResult

+ RecoveryBundle string

type BranchEntry

+ SupersededAtOrigin bool

+ SupersessionReceipt string

+ SupersessionReceiptID string

+ SupersessionRejection string

+ SupersessionReviewer string

+ SupersessionSHA256 string

type BranchListOptions

+ Branch string

+ Repository string

type BranchListOutcome

+ Branch string

+ GeneratedAt time.Time

+ Host string

+ Repository string

Sep 20, 2026

Changes in this version

type AbortResult

+ WorkLogRecovered bool

+ WorkLogRecoveryPlanned bool

Sep 19, 2026

Changes in this version

+ type RegisteredPullRequestBinding struct

+ ClaimID string

+ PullRequest int

+ RecordedAt time.Time

+ Repository string

+ Task string

+ URL string

+ func ListRegisteredPullRequestBindings(projectsRoot string) ([]RegisteredPullRequestBinding, error)

Sep 18, 2026

Changes in this version

type ParkedLocalCustody

+ func (custody *ParkedLocalCustody) ResolvedWorktreeDirs() map[string]string

Sep 18, 2026

Changes in this version

+ const BusyProcessCheckSupported

+ func BusyProcessReason(paths []string) string

+ func IdentifyManagedCheckout(projectsRoot, worktree string) (task string, active bool, ok bool, err error)

+ func ParkedSessionReason(root string, paths []string) string

+ func ReverseRelocation(ctx context.Context, projectsRoot, canonicalDir, destination, source string, ...) error

+ type RelocateCheckoutOptions struct

+ Apply bool

+ CanonicalDir string

+ Destination string

+ Now func() time.Time

+ ProjectsRoot string

+ Source string

+ To string

+ type RelocateCheckoutResult struct

+ Applied bool

+ Eligible bool

+ Reason string

+ ReceiptPath string

+ Repaired bool

+ func RelocateCheckout(ctx context.Context, options RelocateCheckoutOptions) (RelocateCheckoutResult, error)

Sep 18, 2026

Changes in this version

+ func RecordClaimPullRequestBinding(projectsRoot, worktree string, binding ClaimPullRequestBinding) (task, claimID string, err error)

+ type ClaimPullRequestBinding struct

+ PullRequest int

+ RecordedAt time.Time

+ Repository string

+ URL string

Sep 18, 2026

Changes in this version

+ func FinalizeCloneMoveRelocationReceipts(entries []cloneMoveRelocationEntry, now time.Time) error

+ func GitOperationInProgress(ctx context.Context, path string) (string, error)

+ func ReconcileClonePlacement(ctx context.Context, clonePath, legacyClonePath string, apply bool) (status string, informational []string, err error)

+ func RecordCloneMoveRelocationIntents(projectsRoot string, moves []CloneMoveWorktree, now time.Time) ([]cloneMoveRelocationEntry, error)

+ func VerifyClonePlacement(ctx context.Context, clonePath string, worktreePaths []string) error

+ type CloneMoveResult struct

+ Destination string

+ Source string

+ Worktrees []CloneMoveWorktree

+ func ApplyCloneMove(ctx context.Context, source, destination string) (CloneMoveResult, error)

+ func PlanCloneMove(ctx context.Context, source, destination string) (CloneMoveResult, error)

+ type CloneMoveWorktree struct

+ Destination string

+ Head string

+ Source string

Sep 18, 2026

Changes in this version

+ const StoreModeCentral

+ const StoreModeRepositoryLocal

+ func CanonicalRepositoryPathForURL(projectsRoot, repository, cloneURL string) (string, error)

+ func ExpectedRemoteURL(projectsRoot, canonicalPath string) (string, error)

type ListResult

+ Placement string

Sep 15, 2026

Changes in this version

+ func ValidExecutionIdentifier(value string, allowUnknown bool) bool

type SessionCheckpointOptions

+ RequestedModel string

Sep 12, 2026

Changes in this version

+ type DiscardedLifecycleBacklogProof struct

+ Branch string

+ HeadSHA string

+ Path string

+ Repository string

+ Target string

+ Task string

+ Worktree string

+ func FindDiscardedLifecycleBacklogProof(ctx context.Context, ...) (*DiscardedLifecycleBacklogProof, error)

+ type TerminalCleanupProof struct

+ GeneratedAt time.Time

+ ReportPath string

+ Result CleanupResult

+ func FindTerminalCleanupProof(projectsRoot, repository, target, task, worktree, branch string) (*TerminalCleanupProof, error)

Sep 12, 2026

Changes in this version

+ const MaxTaskSummaryRunes

+ func NormalizeTaskSummary(value string) (string, error)

+ type ActiveClaimSummary struct

+ Branch string

+ Owner string

+ RecordedAt time.Time

+ Repository string

+ Task string

+ TaskSummary string

+ WBSessionID string

+ func ListActiveClaimSummaries(projectsRoot, filter string) ([]ActiveClaimSummary, error)

type ListResult

+ TaskSummary string

type WorkLogClaimView

+ TaskSummary string

type WorkLogOptions

+ TaskSummary string

Sep 9, 2026

Changes in this version

+ const MaxFinalizeReportBytes

type ListOptions

+ Finalized *bool

type ListResult

+ FinalizedAt time.Time

+ ReportPath string

+ TerminalMessage string

+ TerminalResult string

type LogFinalizeOptions

+ Report []byte

+ type WorkLogTerminalView struct

+ Disposition string

+ FinalCommit string

+ ReportPath string

+ SealedAt time.Time

+ TerminalMessage string

+ TerminalResult string

type WorkLogView

+ FinalizeReportBody string

+ Terminal *WorkLogTerminalView

Sep 7, 2026

Changes in this version

type CleanupResult

+ Proof string

type ListResult

+ AbsorbedConflictAcknowledgementPath string

+ AbsorbedConflictProvenSourceSHAs []string

+ AbsorbedConflictReceiptPath string

Sep 6, 2026

Changes in this version

+ func FinalizeRepositoryTransferWorkLogs(ctx context.Context, options RepositoryRelocateOptions) ([]string, error)

type ListOptions

+ MergeReceiptProofs []MergeReceiptCleanupProof

type ListResult

+ RecordedBase string

+ type RepositoryRelocateOptions struct

+ Apply bool

+ DefaultBranch string

+ DestinationRepository string

+ Now func() time.Time

+ OnCleanupPending func(receiptPath, recoveryCommand string) error

+ ProjectsRoot string

+ RemoteURL string

+ SourceRepository string

+ type RepositoryRelocateResult struct

+ Applied bool

+ CleanupPending bool

+ DefaultBranch string

+ DestinationDir string

+ DestinationRepository string

+ Eligible bool

+ Reason string

+ ReceiptPaths []string

+ RecoveryCommand string

+ RemoteURL string

+ ReplacementCleanupReceipt string

+ ReplacementCleanupStatus string

+ RetiredDestinationDir string

+ SourceDir string

+ SourceFetchURL string

+ SourcePushURL string

+ SourceRepository string

+ Worktrees []string

+ func RelocateRepository(ctx context.Context, options RepositoryRelocateOptions) (RepositoryRelocateResult, error)

+ type RepositoryTransferCleanupOptions struct

+ Apply bool

+ ProjectsRoot string

+ ReceiptPath string

+ type RepositoryTransferCleanupResult struct

+ Applied bool

+ Eligible bool

+ Outcome string

+ QuarantineDir string

+ Reason string

+ ReceiptPath string

+ func RecoverRepositoryTransferCleanup(ctx context.Context, options RepositoryTransferCleanupOptions) (RepositoryTransferCleanupResult, error)

Sep 6, 2026

Changes in this version

type GCEntry

+ RemoteHeadAncestorOfHead bool

type ListResult

+ RemoteHeadAncestorOfHead bool

Sep 5, 2026

Changes in this version

type AbortResult

+ ReservationRuns []string

+ type RelocateOptions struct

+ Apply bool

+ Filter string

+ Now func() time.Time

+ ProjectsRoot string

+ Task string

+ To string

+ type RelocateOutcome struct

+ Diagnostics []ListDiagnostic

+ Results []RelocateResult

+ SchemaVersion int

+ func Relocate(ctx context.Context, options RelocateOptions) (RelocateOutcome, error)

+ type RelocateResult struct

+ AlreadyThere bool

+ Applied bool

+ Branch string

+ CanonicalDir string

+ ClaimID string

+ Destination string

+ Eligible bool

+ Finalized bool

+ HeadSHA string

+ Reason string

+ ReceiptPath string

+ RecoveryPending bool

+ Repaired bool

+ Repository string

+ Task string

+ To string

+ WorktreeDir string

Sep 4, 2026

Changes in this version

type AbortOptions

+ AbsorbedBy string

type PullRequest

+ BaseSHA string

Sep 4, 2026

Changes in this version

+ const LayoutLocal

+ const LayoutShared

+ const SecureCanonicalPolicyGitHelperArgument

+ func RunSecureCanonicalPolicyGitHelper(args []string) int

type ListResult

+ Local bool

+ type PlacementWorktree struct

+ Path string

+ func CreateWorktreeAtPlacement(ctx context.Context, canonicalPath string, placement WorktreePlacement, ...) (*PlacementWorktree, error)

+ func (created *PlacementWorktree) Close()

+ type WorktreePlacement struct

+ RepositoryLocal bool

+ Root string

+ func ResolveUserWorktreePlacement(canonicalPath string) (WorktreePlacement, error)

+ func ResolveWorktreePlacement(ctx context.Context, canonicalPath, baseRevision string) (WorktreePlacement, error)

+ func (placement WorktreePlacement) Path(task, repository string) (string, error)

Sep 4, 2026

Changes in this version

type CleanupOutcome

+ ResolvedTasks []string

Sep 3, 2026

Changes in this version

+ const DefaultSessionFreshness

+ const DisableSessionFreshness

+ func HeartbeatAt(worktree string) time.Time

+ func LastActivity(ctx context.Context, result ListResult) time.Time

+ func NewestChangedFileTime(ctx context.Context, worktree string) time.Time

+ func TouchHeartbeat(worktree, command string)

+ func TouchHeartbeatForCurrentDirectory(command string)

type AbortResult

+ Quarantined []LifecycleBacklogQuarantine

type CleanupOptions

+ Activity bool

type CleanupOutcome

+ Quarantined []LifecycleBacklogQuarantine

type GCOptions

+ SessionFreshness time.Duration

type GCOutcome

+ Shells []RetiredShell

+ type LifecycleBacklogQuarantine struct

+ Path string

+ Reason string

+ Repository string

+ Task string

type ListOptions

+ Activity bool

type ListResult

+ LastActivityAt time.Time

type RetireShellsOptions

+ Tasks []string

Sep 3, 2026

Changes in this version

+ const DefaultResidueDepth

+ const GCClassClaimedLive

+ const GCClassContained

+ const GCClassDetachedReview

+ const GCClassDetachedUnknown

+ const GCClassDirty

+ const GCClassLandedClean

+ const GCClassLandedResidue

+ const GCClassOpenPR

+ const GCClassUnmerged

+ const GCClassUnpushed

+ const ManagementManaged

+ const ManagementUnknown

+ const ManagementUnmanaged

type CleanupOptions

+ AllowResidue bool

+ IncludeDetached bool

+ ResidueDepth int

+ TTL time.Duration

type CleanupOutcome

+ Purged []PurgedArtefact

+ type GCEntry struct

+ AgeSeconds int64

+ Applied bool

+ Branch string

+ Class string

+ CreatedAt time.Time

+ Detached bool

+ Eligible bool

+ Error string

+ Evidence []string

+ Expired bool

+ HeadSHA string

+ Landing *LandingEvidence

+ Management string

+ Owner string

+ OwnerState string

+ PullRequest *PullRequest

+ Reason string

+ RemoteHeadSHA string

+ Repository string

+ SanctionedCommand string

+ Size diskusage.Usage

+ TTLSeconds int64

+ Task string

+ Warnings []string

+ WorktreeDir string

+ WorktreesRoot string

+ func (entry GCEntry) String() string

+ type GCOptions struct

+ AllowResidue bool

+ Apply bool

+ Base string

+ DeleteRemote bool

+ Filter string

+ Now func() time.Time

+ OlderThan time.Duration

+ Progress func(ListProgress)

+ ProjectsRoot string

+ ResidueDepth int

+ SkipDetached bool

+ SkipSizes bool

+ SupersededBy string

+ TTL time.Duration

+ Tasks []string

+ Workers int

+ type GCOutcome struct

+ Apply bool

+ Artifacts []LifecycleArtifact

+ Diagnostics []ListDiagnostic

+ Entries []GCEntry

+ PartialTasks []GCPartialTask

+ Purged []PurgedArtefact

+ Reclaimable diskusage.Usage

+ Reclaimed diskusage.Usage

+ RetiredShells []RetiredShell

+ SchemaVersion int

+ Totals map[string]int

+ func GC(ctx context.Context, options GCOptions) (GCOutcome, error)

+ func (outcome GCOutcome) Refused() int

+ type GCPartialTask struct

+ LeftAlone []string

+ Retired []string

+ Task string

+ type LandingEvidence struct

+ LandedSHA string

+ LandingSHA string

+ PullRequest *PullRequest

+ Residue []ResidualCommit

+ Truncated bool

+ func (evidence *LandingEvidence) ResidueSummary() string

type ListOptions

+ IncludeDetached bool

+ Now func() time.Time

+ ResidueDepth int

+ ResidueEvidence bool

+ TTL time.Duration

type ListOutcome

+ Purged []PurgedArtefact

type ListResult

+ AgeSeconds int64

+ CreatedAt time.Time

+ Detached bool

+ Expired bool

+ HeadUnknownToRemote bool

+ Landing *LandingEvidence

+ Owner string

+ TTLSeconds int64

+ type PurgedArtefact struct

+ Kind string

+ Path string

+ Task string

+ WorktreesRoot string

+ type ResidualCommit struct

+ SHA string

+ Subject string

Sep 2, 2026

Changes in this version

+ const PublicationBehind

+ const PublicationDiverged

+ const PublicationPublished

+ const PublicationUnborn

+ const PublicationUnpublished

+ func PublicationFinding(publication *CanonicalFreshness, branch string) string

+ func PublicationVerified(publication *CanonicalFreshness) bool

type GuardOptions

+ CheckPublication bool

type GuardResult

+ Publication *CanonicalFreshness

Sep 2, 2026

Changes in this version

type CleanupOptions

+ RequireRemoteRetirement bool

Sep 1, 2026

Changes in this version

+ func ValidateRemovedTerminalWorkLogs(projectsRoot string, expectations []TerminalWorkLogExpectation) error

+ type TerminalWorkLogExpectation struct

+ Base string

+ Branch string

+ FinalCommit string

+ Repository string

+ Task string

+ Worktree string

Aug 31, 2026

Changes in this version

+ func WorkLogClaimID(effort string, result CreateResult) string

type LogRecoverOptions

+ EstablishClaim bool

type WorkLogPublicationOutcome

+ func EnsureWorkLogClaim(home, task string, result CreateResult, options WorkLogOptions) (WorkLogPublicationOutcome, error)

Aug 30, 2026

Changes in this version

+ func MutationInitiator() string

+ func SetMutationInitiator(value string) func()

+ func ValidateDependencyDeltas(ctx context.Context, receipt SupersessionReceipt, entry ListResult) error

type AdoptOptions

+ Initiator string

type CorrectExecutionIdentityOptions

+ Initiator string

type Manifest

+ DependencyCampaign bool

type OwnerRegistration

+ Initiator string

type PullRequest

+ Repository string

+ type SupersessionDependencyDelta struct

+ Before string

+ CandidateAfter string

+ Consumer string

+ Ecosystem string

+ Lockfile string

+ LockfileSelector string

+ LockfileVersion string

+ Manifest string

+ Package string

+ RequestedAfter string

+ Reviewed bool

+ Selector string

+ SourceHead string

+ SourcePR string

type SupersessionReceipt

+ DependencyDeltas []SupersessionDependencyDelta

+ DependencyDeltasComplete bool

+ OriginalPR string

+ OriginalPRHead string

+ OriginalPRNumber int

+ OriginalPRRepository string

+ func (receipt SupersessionReceipt) DependencyAuditJSON() ([]byte, error)

+ func (receipt SupersessionReceipt) DependencyAuditMarkdown() string

Aug 29, 2026

Changes in this version

+ const CanonicalFreshnessAhead

+ const CanonicalFreshnessCurrent

+ const CanonicalFreshnessDiverged

+ const CanonicalFreshnessDrifted

+ const CanonicalFreshnessFetchError

+ const CanonicalFreshnessMissing

+ const CanonicalFreshnessOffline

+ const CanonicalFreshnessStale

+ const EnvSessionID

type AgentIdentity

+ Registered bool

+ WBSessionID string

+ func RegisteredIdentity() (AgentIdentity, bool)

+ type CanonicalFreshness struct

+ Ahead int

+ Behind int

+ Error string

+ Fetched bool

+ LocalSHA string

+ ObservedAt time.Time

+ RemoteRef string

+ RemoteSHA string

+ Status string

+ Target string

+ TargetDrift bool

type CreateOptions

+ SessionRequired bool

type GuardOptions

+ CheckFreshness bool

type GuardResult

+ Freshness *CanonicalFreshness

type LifecycleArtifact

+ NonBlocking bool

+ Repository string

type ListResult

+ WorkLogSessionID string

+ type RetiredStageRecoveryOptions struct

+ Apply bool

+ ProjectsRoot string

+ Stage string

+ Task string

+ type RetiredStageRecoveryOutcome struct

+ Apply bool

+ ReceiptPath string

+ Results []RetiredStageRecoveryResult

+ func RecoverRetiredStages(ctx context.Context, options RetiredStageRecoveryOptions) (RetiredStageRecoveryOutcome, error)

+ type RetiredStageRecoveryResult struct

+ Applied bool

+ ArchivePath string

+ Branch string

+ ByteCount int64

+ ContentDigest string

+ Disposition string

+ Durable bool

+ Eligible bool

+ FileCount int

+ GitDir string

+ GitRepository string

+ HeadSHA string

+ Path string

+ Reason string

+ RemoteURL string

+ Stage string

+ StageDevice uint64

+ StageInode uint64

+ SymlinkCount int

+ Task string

+ WorktreesRoot string

type WorkLogOptions

+ WBSessionID string

Aug 29, 2026

Changes in this version

+ const LocalEventBranchReconciled

type LogRecoverOptions

+ EventID string

+ ExpectedHead string

+ Reason string

+ ReconcileBranch string

+ Remote bool

type LogVerbResult

+ ReadyForNormalCleanup bool

Aug 29, 2026

Changes in this version

type AbortDisposition

+ const AbortOrphaned

type AbortOptions

+ Actor string

+ ClaimID string

+ Reason string

type AbortResult

+ DirtyCapture *DirtyWorktreeEvidence

type CleanupOptions

+ SupersededBy string

+ type DirtyWorktreeEvidence struct

+ Bytes int64

+ Files int

+ SHA256 string

type ListResult

+ SupersededAtOrigin bool

+ SupersessionReceipt string

+ SupersessionReceiptID string

+ SupersessionRejection string

+ SupersessionReviewer string

+ type SupersessionApproval struct

+ Actor string

+ ApprovedAt time.Time

+ Decision string

+ ReceiptID string

+ Trusted bool

+ type SupersessionReceipt struct

+ Approval SupersessionApproval

+ Branch string

+ OriginalHead string

+ Replacements []SupersessionReplacement

+ Repository string

+ Residuals []SupersessionResidual

+ ResidualsComplete bool

+ Target string

+ TargetHead string

+ Task string

+ Version int

+ type SupersessionReplacement struct

+ Kind string

+ Ref string

+ SHA string

+ type SupersessionResidual struct

+ Classification string

+ Commit string

+ Paths []string

+ Reason string

+ ReplacementRef string

+ Reviewed bool

Aug 28, 2026

Changes in this version

type GuardResult

+ TransientOperation string

Aug 28, 2026

Changes in this version

+ func ValidateTerminalCleanupReports(paths []string, repository string, expectedTasks []string) error

type CleanupOptions

+ MergeReceiptProofs []MergeReceiptCleanupProof

+ type MergeReceiptCleanupProof struct

+ CandidateSHA string

+ LandingSHA string

+ Repository string

+ SourceBranch string

+ SourceSHA string

+ SourceTask string

+ SourceWorktree string

+ Target string

Aug 28, 2026

Changes in this version

type CleanupOptions

+ Tasks []string

type ListOptions

+ Tasks []string

Aug 28, 2026

Changes in this version

type AbortOptions

+ All bool

type ListDiagnostic

+ NonBlocking bool

Aug 28, 2026

Changes in this version

type CleanupOptions

+ ExactRepository string

Aug 27, 2026

Changes in this version

+ const CheckpointRefPrefix

+ const NotALandingReceiptNotice

+ func CheckpointRemoteRef(task string) (string, error)

+ type FetchRemoteCheckpointOptions struct

+ Root string

+ Task string

type LogCheckpointOptions

+ SkipRemote bool

type LogVerbResult

+ RemoteCheckpoint *RemoteCheckpointResult

+ type PushRemoteCheckpointOptions struct

+ HeadSHA string

+ Root string

+ Task string

+ type RemoteCheckpointFetchResult struct

+ LocalRef string

+ Notice string

+ Ref string

+ SHA string

+ func FetchRemoteCheckpoint(ctx context.Context, options FetchRemoteCheckpointOptions) (RemoteCheckpointFetchResult, error)

+ type RemoteCheckpointResult struct

+ Notice string

+ Pushed bool

+ Ref string

+ SHA string

+ func PushRemoteCheckpoint(ctx context.Context, options PushRemoteCheckpointOptions) (RemoteCheckpointResult, error)

Aug 27, 2026

Changes in this version

+ func AttachParkedLocalSuccessor(ctx context.Context, options ParkedLocalSuccessorOptions) error

+ func CaptureParkedSessionAggregate(ctx context.Context, projectsRoot string, listed []ListResult, ...) error

+ func CaptureParkedSessionWorktree(ctx context.Context, projectsRoot string, listed ListResult, ...) (sessionpark.Worktree, error)

+ func ParkedSessionWorkLogReference(projectsRoot, worktree string, source session.Record) (string, error)

+ func ParkedSessionWorkLogSnapshot(projectsRoot, worktree string, source session.Record) (string, string, error)

+ func SessionReceiveMemberPath(projectsRoot string, spec SessionReceiveSpec) (string, error)

+ func SessionReceiveWorktreePath(projectsRoot string, request sessionmove.Request) (string, error)

+ func WithParkedLocalResumeCustody(ctx context.Context, projectsRoot string, bundle sessionpark.Bundle, ...) error

+ func WithParkedLocalResumeCustodyForAttempt(ctx context.Context, projectsRoot string, bundle sessionpark.Bundle, ...) error

+ func WithParkedRemoteResumeCustody(ctx context.Context, projectsRoot string, bundle sessionpark.Bundle, ...) error

+ type ExternalSessionWorkLogPrepareOptions struct

+ AttemptID string

+ AttemptIndex uint64

+ HandoverBytes []byte

+ PinnedCommit string

+ ProjectsRoot string

+ ReceivedAt time.Time

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ Session session.Record

+ WorktreeDir string

+ type ExternalSessionWorkLogPrepareResult struct

+ ClaimID string

+ OwnerEvent LocalWorkLogEvent

+ ReceivedEvent LocalWorkLogEvent

+ Replayed bool

+ WorkLogReference string

+ func PrepareExternalSessionWorkLog(ctx context.Context, options ExternalSessionWorkLogPrepareOptions) (ExternalSessionWorkLogPrepareResult, error)

+ type ExternalSourceMessageOptions struct

+ Message sessionmove.Message

+ MessageReceipt sessionmove.MessageReceipt

+ ProjectsRoot string

+ Receipt sessionmove.Receipt

+ Record sessionmove.MessageRecord

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ SourceSession session.Record

+ type ExternalSourceOfferOptions struct

+ ExecutionLock *sessionmove.ExecutionLock

+ ProjectsRoot string

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ SourceSession session.Record

+ Store sessionmove.Store

+ type ExternalSourceOfferResult struct

+ OfferEvent LocalWorkLogEvent

+ OwnerEvent LocalWorkLogEvent

+ Replayed bool

+ func EnsureExternalSourceOfferEvidence(options ExternalSourceOfferOptions) (ExternalSourceOfferResult, error)

+ type ExternalSourceSealOptions struct

+ ExecutionLock *sessionmove.ExecutionLock

+ ProjectsRoot string

+ Receipt sessionmove.Receipt

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ SourceSession session.Record

+ Store sessionmove.Store

+ type ExternalSourceSealResult struct

+ CompletionEvent LocalWorkLogEvent

+ Replayed bool

+ SealedAt time.Time

+ SourceWorkLogReference string

+ TargetWorkLogReference string

+ func SealExternalSessionWorkLog(options ExternalSourceSealOptions) (ExternalSourceSealResult, error)

+ type ExternalTargetAttemptFailureOptions struct

+ Failure sessionlaunch.FailureEvidence

+ ProjectsRoot string

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ WorktreeDir string

+ type ExternalTargetCompletionOptions struct

+ ProjectsRoot string

+ Receipt sessionmove.Receipt

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ WorktreeDir string

+ type ExternalTargetMessageOptions struct

+ Message sessionmove.Message

+ ProjectsRoot string

+ Receipt sessionmove.Receipt

+ Record sessionmove.MessageRecord

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

type LocalWorkLogEvent

+ func RecordExternalSourceMessageSent(options ExternalSourceMessageOptions) (LocalWorkLogEvent, error)

+ func RecordExternalTargetAttemptFailed(options ExternalTargetAttemptFailureOptions) (LocalWorkLogEvent, error)

+ func RecordExternalTargetCompleted(options ExternalTargetCompletionOptions) (LocalWorkLogEvent, error)

+ func RecordExternalTargetMessageReceived(options ExternalTargetMessageOptions) (LocalWorkLogEvent, error)

+ func RecordParkedTargetCompleted(options ParkedTargetCompletionOptions) (LocalWorkLogEvent, error)

type LogHandoffOptions

+ At time.Time

+ BundleCommit string

+ EventID string

+ HandoffID string

+ PredecessorWBSessionID string

+ RequestDigest sessionmove.Digest

+ SourceMachine string

+ SourceWorkLogReference string

+ TargetMachine string

+ type ParkedLocalCustody struct

+ func (custody *ParkedLocalCustody) Attach(ctx context.Context, successor session.Record, attemptID string, ...) error

+ type ParkedLocalSuccessorOptions struct

+ AttemptID string

+ AttemptIndex uint64

+ Bundle sessionpark.Bundle

+ ProjectsRoot string

+ Successor session.Record

+ type ParkedSessionWorkLogPrepareOptions struct

+ AttemptID string

+ AttemptIndex uint64

+ Member sessionpark.RemoteMember

+ PinnedCommit string

+ ProjectsRoot string

+ ReceivedAt time.Time

+ Request sessionpark.RemoteRequest

+ RequestDigest sessionmove.Digest

+ Session session.Record

+ WorktreeDir string

+ type ParkedSessionWorkLogPrepareResult struct

+ ClaimID string

+ OwnerEvent LocalWorkLogEvent

+ ReceivedEvent LocalWorkLogEvent

+ Replayed bool

+ WorkLogReference string

+ func PrepareParkedSessionWorkLog(ctx context.Context, options ParkedSessionWorkLogPrepareOptions) (ParkedSessionWorkLogPrepareResult, error)

+ type ParkedTargetCompletionOptions struct

+ Member sessionpark.RemoteMember

+ ProjectsRoot string

+ Request sessionpark.RemoteRequest

+ RequestDigest sessionmove.Digest

+ Successor sessionlaunch.Result

+ WorktreeDir string

+ type SessionCheckpointOptions struct

+ HandoffID string

+ Handover SessionHandover

+ Now time.Time

+ ProjectsRoot string

+ RequestedHarness string

+ SourceSession session.Record

+ SuccessorWBSessionID string

+ TargetMachine string

+ Worktree string

+ type SessionCheckpointResult struct

+ Digest sessionmove.Digest

+ HandoverBytes []byte

+ Request sessionmove.Request

+ RequestBytes []byte

+ WorkLogEvent LocalWorkLogEvent

+ func CreateSessionCheckpoint(ctx context.Context, options SessionCheckpointOptions) (SessionCheckpointResult, error)

+ type SessionHandover struct

+ Body []byte

+ RemainingWork string

+ Summary string

+ ValidationEvidence string

+ type SessionMemberReceiveOptions struct

+ ProjectsRoot string

+ Spec SessionReceiveSpec

+ type SessionReceiveOptions struct

+ ExecutionLock *sessionmove.ExecutionLock

+ ProjectsRoot string

+ Request sessionmove.Request

+ RequestDigest sessionmove.Digest

+ type SessionReceiveResult struct

+ CanonicalDir string

+ Commit string

+ HandoverBytes []byte

+ Repository string

+ Reused bool

+ WorktreeDir string

+ func ReceiveSessionBundle(ctx context.Context, options SessionReceiveOptions) (SessionReceiveResult, error)

+ func ReceiveSessionMember(ctx context.Context, options SessionMemberReceiveOptions) (SessionReceiveResult, error)

+ func VerifyReceivedSessionBundle(ctx context.Context, options SessionReceiveOptions) (SessionReceiveResult, error)

+ func VerifyReceivedSessionMember(ctx context.Context, options SessionMemberReceiveOptions) (SessionReceiveResult, error)

+ type SessionReceiveSpec struct

+ AuthorityDigest sessionmove.Digest

+ AuthorityID string

+ AuthorityStore string

+ Branch string

+ Commit string

+ Fence sessionauthority.Fence

+ HandoverDigest sessionmove.Digest

+ HandoverPath string

+ MemberKey string

+ OperationID string

+ PinBranch string

+ RepositoryRemote string

+ SourceWorkCommit string

Aug 27, 2026

Changes in this version

+ func EnsureManifest(worktree string, manifest Manifest) error

+ func EnsurePrompt(worktree string, header PromptHeader, body []byte) error

Aug 26, 2026

Changes in this version

type WorkLogOptions

+ func (options WorkLogOptions) WithOriginalPromptFromStdin(content []byte) (WorkLogOptions, error)

Aug 25, 2026

Changes in this version

type AbortOptions

+ Filter string

type AbortResult

+ Excluded bool

Aug 25, 2026

Changes in this version

type BranchCleanupOptions

+ AbsorbedBy string

type BranchEntry

+ AbsorbedByRejection string

Aug 25, 2026

Changes in this version

+ const BranchReceipted

type BranchCleanupOptions

+ Receipts bool

type BranchEntry

+ LandingSHA string

+ ReceiptPullRequest *PullRequest

Aug 24, 2026

Changes in this version

type GuardResult

+ External bool

Aug 24, 2026

Changes in this version

+ const AdoptAdopted

+ const AdoptAlreadyAdopted

+ const AdoptSkipped

+ const AdoptWouldAdopt

+ type AdoptOptions struct

+ AllExternal bool

+ Apply bool

+ Base string

+ Filter string

+ Now func() time.Time

+ Path string

+ ProjectsRoot string

+ type AdoptResult struct

+ Action string

+ Base string

+ Branch string

+ Path string

+ Reason string

+ Repository string

+ Task string

+ func Adopt(ctx context.Context, options AdoptOptions) ([]AdoptResult, error)

type ListResult

+ External bool

type Manifest

+ func PreviewReconstructedManifest(ctx context.Context, worktree string) (Manifest, error)

type WorkLogOptions

+ AcquiredVia string

Aug 24, 2026

Changes in this version

+ func SetSessionResolver(resolve func() (AgentIdentity, bool))

type AgentIdentity

+ func CurrentIdentity() AgentIdentity

Aug 24, 2026

Changes in this version

+ const OwnerGone

+ const OwnerLive

+ const OwnerUnstated

+ func DeclaredOwner(worktree string) (state, agent string, pid int)

type OrphanWorktree

+ OwnerAgent string

+ OwnerPID int

+ OwnerState string

Aug 23, 2026

Changes in this version

+ const DefaultInspectWorkers

type CleanupOptions

+ Progress func(ListProgress)

+ Workers int

type ListOptions

+ Progress func(ListProgress)

+ Workers int

+ type ListProgress struct

+ Done bool

+ Elapsed time.Duration

+ Index int

+ Network bool

+ Path string

+ Repository string

+ Task string

Aug 23, 2026

Changes in this version

+ const EnvAgentID

+ const EnvAgentModel

+ const EnvAgentPID

+ const EnvAgentRuntime

+ func InvokedCommand() string

+ func RecordCustody(worktree, effort, command string, identity AgentIdentity) error

+ func SetInvokedCommand(command string)

+ func TakeOwnerWarnings() []string

+ func UndeclaredOwnerWarning(worktree string) string

+ type AgentIdentity struct

+ AgentID string

+ Model string

+ PID int

+ Runtime string

+ func IdentityFromEnv() AgentIdentity

+ func (a AgentIdentity) Agent() string

+ func (a AgentIdentity) Declared() bool

type OwnerRegistration

+ Command string

+ WBVersion string

Aug 23, 2026

Changes in this version

type OrphanReport

+ Residue []OrphanResidue

+ type OrphanResidue struct

+ CanonicalDir string

+ Evidence []string

+ Layout string

+ Path string

+ Remedy string

+ Repository string

+ Task string

+ WorktreesRoot string

type OrphanTotals

+ Residue int

Aug 23, 2026

Changes in this version

+ const LocalEventOwner

type ListOptions

+ OwnerState string

type ListResult

+ OwnerState string

+ Owners []OwnerView

type LocalWorkLogEvent

+ Owner *OwnerRegistration

type LogInitOptions

+ AgentID string

+ type OwnerRegistration struct

+ Agent string

+ At time.Time

+ Effort string

+ Model string

+ PID int

+ type OwnerView struct

+ PIDStatus string

type WorkLogView

+ Owners []OwnerView

Aug 20, 2026

Changes in this version

type CleanupResult

+ WorktreeResidueRemoved bool

Aug 20, 2026

Changes in this version

type ListResult

+ LockOwner LockOwnerState

+ LockOwnerPID int

+ type LockOwnerState string

+ const LockOwnerDead

+ const LockOwnerLive

+ const LockOwnerNone

+ const LockOwnerUnreadable

Aug 19, 2026

Changes in this version

+ type RetireShellsOptions struct

+ Apply bool

+ Filter string

+ ProjectsRoot string

+ type RetireShellsOutcome struct

+ Apply bool

+ Results []RetiredShell

+ Totals map[string]int

+ func RetireTaskShells(ctx context.Context, options RetireShellsOptions) (RetireShellsOutcome, error)

+ type RetiredShell struct

+ Applied bool

+ Eligible bool

+ Error string

+ Path string

+ Reason string

+ Task string

+ WorktreesRoot string

Aug 19, 2026

Changes in this version

+ const BranchAbsorbed

+ const BranchContained

+ const BranchInUse

+ const BranchProtected

+ const BranchScopeAll

+ const BranchScopeLocal

+ const BranchScopeRemote

+ const BranchUnique

+ const BranchUnreadable

+ func DefaultBranchCleanupReportDir(home string, now time.Time) string

+ type BranchCleanupOptions struct

+ Apply bool

+ Base string

+ Filter string

+ Now func() time.Time

+ OlderThan time.Duration

+ Progress io.Writer

+ ProjectsRoot string

+ ReportDir string

+ Scope string

+ type BranchCleanupOutcome struct

+ Apply bool

+ Base string

+ Diagnostics []string

+ ElapsedMS int64

+ ReportPath string

+ Results []BranchCleanupResult

+ Scope string

+ Totals map[string]int

+ func BranchCleanup(ctx context.Context, options BranchCleanupOptions) (BranchCleanupOutcome, error)

+ type BranchCleanupResult struct

+ Applied bool

+ Eligible bool

+ Error string

+ Outcome string

+ SkipReason string

+ type BranchEntry struct

+ Base string

+ Branch string

+ CommitterDate time.Time

+ Disposition string

+ Evidence string

+ OpenPullRequest *PullRequest

+ PullRequestQueryFailed bool

+ Reason string

+ Repository string

+ SHA string

+ Scope string

+ ShortSHA string

+ TargetSHA string

+ Task string

+ type BranchListOptions struct

+ Base string

+ Filter string

+ OlderThan time.Duration

+ Only string

+ Progress io.Writer

+ ProjectsRoot string

+ Scope string

+ type BranchListOutcome struct

+ Base string

+ Diagnostics []string

+ ElapsedMS int64

+ Entries []BranchEntry

+ Scope string

+ Totals map[string]int

+ func BranchList(ctx context.Context, options BranchListOptions) (BranchListOutcome, error)

Aug 16, 2026

Changes in this version

type CleanupOptions

+ ResumeInterrupted bool

type CleanupOutcome

+ Recovery *InterruptedLockRecovery

+ type InterruptedLockRecovery struct

+ Applied bool

+ Disposition string

+ PID int

+ Path string

+ Reason string

+ Task string

+ WorktreesRoot string

Aug 16, 2026

Changes in this version

+ const LocalEventArchive

+ const LocalEventCheckpoint

+ const LocalEventFinalize

+ const LocalEventHandoff

+ const LocalEventInit

+ const LocalEventIntegrate

+ const LocalEventRecover

+ const LocalEventRefresh

+ const LocalEventRefreshNeed

+ const LocalEventSteer

+ const LocalEventSyncAttempt

+ func LogShow(ctx context.Context, projectsRoot, worktree string) (WorkLogView, LocalWorkLogProjection, error)

+ type LocalGitEvidence struct

+ Branch string

+ Dirty bool

+ Head string

+ Status string

+ StatusSHA string

+ type LocalTargetEvidence struct

+ Ahead int

+ Behind int

+ FetchedAt time.Time

+ Ref string

+ SHA string

+ Strategy string

+ type LocalUsageEvidence struct

+ Currency string

+ Discriminator string

+ EstimatedCost *float64

+ InputTokens *int64

+ OutputTokens *int64

+ ProviderRef string

+ TotalTokens *int64

+ type LocalWorkLogEvent struct

+ At time.Time

+ Conflict string

+ Extra map[string]any

+ Git *LocalGitEvidence

+ ID string

+ Message string

+ NextAction string

+ Prompt string

+ PromptSHA string

+ Result string

+ Seq int

+ Target *LocalTargetEvidence

+ Type string

+ Usage *LocalUsageEvidence

+ Version int

+ type LocalWorkLogProjection struct

+ ClaimID string

+ Conflict string

+ EffortID string

+ LastCheckpoint *LocalGitEvidence

+ LastEventID string

+ LastMessage string

+ LastNextAction string

+ LastSeq int

+ LastTarget *LocalTargetEvidence

+ LastType string

+ Lifecycle string

+ RunID string

+ UpdatedAt time.Time

+ Version int

+ type LogArchiveOptions struct

+ Apply bool

+ Force bool

+ ProjectsRoot string

+ Worktree string

+ type LogCheckpointOptions struct

+ Currency string

+ EstimatedCost *float64

+ InputTokens *int64

+ Message string

+ NextAction string

+ OutputTokens *int64

+ ProjectsRoot string

+ ProviderRef string

+ UsageDisc string

+ Worktree string

+ type LogFinalizeOptions struct

+ Apply bool

+ Message string

+ ProjectsRoot string

+ Result string

+ Worktree string

+ type LogHandoffOptions struct

+ Apply bool

+ CLI string

+ Model string

+ NextAction string

+ ProjectsRoot string

+ Provider string

+ Successor string

+ Summary string

+ Worktree string

+ type LogInitOptions struct

+ CLI string

+ Model string

+ ProjectsRoot string

+ Prompt []byte

+ Provider string

+ Runtime string

+ Source string

+ Worktree string

+ type LogIntegrateOptions struct

+ Base string

+ ProjectsRoot string

+ Strategy string

+ Worktree string

+ type LogRecoverOptions struct

+ Actor string

+ Apply bool

+ ProjectsRoot string

+ Takeover bool

+ Worktree string

+ type LogRefreshOptions struct

+ Base string

+ ProjectsRoot string

+ Worktree string

+ type LogSteerOptions struct

+ Body []byte

+ CLI string

+ Model string

+ ProjectsRoot string

+ Provider string

+ Runtime string

+ Source string

+ Worktree string

+ type LogSyncOptions struct

+ Apply bool

+ ProjectsRoot string

+ Worktree string

+ type LogVerbResult struct

+ Applied bool

+ Diagnosis []string

+ Event *LocalWorkLogEvent

+ Notes []string

+ Offline bool

+ Outbox int

+ Projection *LocalWorkLogProjection

+ Prompt string

+ Verb string

+ Worktree string

+ func LogArchive(ctx context.Context, options LogArchiveOptions) (LogVerbResult, error)

+ func LogCheckpoint(ctx context.Context, options LogCheckpointOptions) (LogVerbResult, error)

+ func LogFinalize(ctx context.Context, options LogFinalizeOptions) (LogVerbResult, error)

+ func LogHandoff(ctx context.Context, options LogHandoffOptions) (LogVerbResult, error)

+ func LogInit(ctx context.Context, options LogInitOptions) (LogVerbResult, error)

+ func LogIntegrate(ctx context.Context, options LogIntegrateOptions) (LogVerbResult, error)

+ func LogRecover(ctx context.Context, options LogRecoverOptions) (LogVerbResult, error)

+ func LogRefresh(ctx context.Context, options LogRefreshOptions) (LogVerbResult, error)

+ func LogSteer(ctx context.Context, options LogSteerOptions) (LogVerbResult, error)

+ func LogSync(ctx context.Context, options LogSyncOptions) (LogVerbResult, error)

Aug 15, 2026

Changes in this version

+ func FormatWorkLogViewText(view WorkLogView) string

+ func FormatWorktreeInfoText(view WorkLogView) string

+ type LoadWorkLogOptions struct

+ IncludePromptBodies bool

+ ProjectsRoot string

+ Worktree string

+ type OriginalPromptView struct

+ Body string

+ Name string

+ SHA256 string

+ Source string

+ type PromptRecord struct

+ At time.Time

+ Body string

+ CLI string

+ Model string

+ Name string

+ Provider string

+ Runtime string

+ SHA256 string

+ Seq int

+ Source string

+ type WorkLogClaimView struct

+ AgentID string

+ AgentRuntime string

+ Base string

+ BaseSHA string

+ Branch string

+ CLI string

+ ClaimID string

+ ClaimPath string

+ EffortID string

+ Initiator string

+ Lifecycle string

+ Model string

+ ModelProvenance string

+ PromptArchive string

+ PromptDigest string

+ Provider string

+ RecordedAt time.Time

+ Repository string

+ RunID string

+ Task string

+ Worktree string

+ type WorkLogGitEvidence struct

+ Branch string

+ Dirty bool

+ Head string

+ Status string

+ type WorkLogView struct

+ Claim *WorkLogClaimView

+ Git WorkLogGitEvidence

+ Manifest *Manifest

+ Notes []string

+ OriginalPrompt *OriginalPromptView

+ Prompts []PromptRecord

+ Worktree string

+ func LoadWorkLogView(ctx context.Context, options LoadWorkLogOptions) (WorkLogView, error)

Aug 15, 2026

Changes in this version

+ func OpenOperationLockDirectory(path string) (*os.File, error)

+ type HeldOperationLock struct

+ func AcquireOperationLock(directory *os.File, reclaimInterrupted bool) (*HeldOperationLock, error)

+ func (lock *HeldOperationLock) File() *os.File

+ func (lock *HeldOperationLock) Preserve()

+ func (lock *HeldOperationLock) ReclaimedInterrupted() bool

+ func (lock *HeldOperationLock) Release()

Aug 13, 2026

Changes in this version

+ const BackfillPresent

+ const BackfillSkipped

+ const BackfillWouldWrite

+ const BackfillWritten

+ const DispositionActive

+ const DispositionDecide

+ const DispositionRemove

+ const DispositionReview

+ const DispositionUnreadable

+ const LayoutCurrent

+ const LayoutExternal

+ const LayoutLegacy

+ type BackfillOptions struct

+ Apply bool

+ Base string

+ ProjectsRoot string

+ type BackfillResult struct

+ Action string

+ EffortID string

+ Layout string

+ Path string

+ Reason string

+ Repository string

+ func Backfill(ctx context.Context, options BackfillOptions) ([]BackfillResult, error)

+ type OrphanFamily struct

+ Disposition string

+ Reason string

+ RootEffort string

+ Worktrees []OrphanWorktree

+ type OrphanOptions struct

+ Base string

+ Now time.Time

+ ProjectsRoot string

+ StaleAfter time.Duration

+ type OrphanReport struct

+ Families []OrphanFamily

+ Totals OrphanTotals

+ Unscanned []string

+ func Orphans(ctx context.Context, options OrphanOptions) (OrphanReport, error)

+ type OrphanTotals struct

+ ByDispositn map[string]int

+ ByLayout map[string]int

+ Dirty int

+ Families int

+ NoManifest int

+ Worktrees int

+ type OrphanWorktree struct

+ AgeDays int

+ Branch string

+ CanonicalDir string

+ Dirty bool

+ Disposition string

+ EffortID string

+ Evidence []string

+ HasManifest bool

+ HasPrompts bool

+ LastCommit time.Time

+ Layout string

+ Merged bool

+ Missing bool

+ ParentEffort string

+ Path string

+ PromptCount int

+ Provenance string

+ Repository string

+ RootEffort string

Aug 13, 2026

Changes in this version

+ const EffortKindFeature

+ const EffortKindTask

+ const PromptSourceAgent

+ const PromptSourceHarness

+ const PromptSourceHuman

+ const ProvenanceCreated

+ const ProvenanceReconstructed

+ func AppendPrompt(worktree string, header PromptHeader, body []byte) (string, error)

+ func EffortKindFor(value string) string

+ func IsAncestorEffort(ancestor, descendant string) bool

+ func ParentEffort(value string) string

+ func RepositoryRootFor(ctx context.Context, path string) (string, error)

+ func ValidEffortPath(value string) bool

+ func WriteManifest(worktree string, manifest Manifest) error

+ type Admission struct

+ Admitted bool

+ Mode AdmissionMode

+ Reason string

+ Remedy string

+ func CheckAdmission(worktree string, mode AdmissionMode) Admission

+ type AdmissionMode string

+ const AdmissionEnforce

+ const AdmissionOff

+ const AdmissionWarn

type GuardOptions

+ Admission AdmissionMode

type GuardResult

+ Admission *Admission

+ type Manifest struct

+ AgentID string

+ AgentRuntime string

+ Base string

+ BaseSHA string

+ Branch string

+ CLI string

+ ClaimID string

+ CreatedAt time.Time

+ EffortID string

+ EffortKind string

+ Evidence []string

+ InferredFields []string

+ Initiator string

+ Model string

+ ParentEffort string

+ Provenance string

+ Provider string

+ Repository string

+ RunID string

+ Version int

+ Worktree string

+ func ReadManifest(worktree string) (Manifest, error)

+ func ReconstructManifest(ctx context.Context, worktree string) (Manifest, error)

+ type PromptHeader struct

+ At time.Time

+ CLI string

+ Model string

+ Provider string

+ Runtime string

+ SHA256 string

+ Seq int

+ Slug string

+ Source string

+ func ListPrompts(worktree string) ([]PromptHeader, error)

Aug 12, 2026

Changes in this version

type CleanupOptions

+ AbsorbedBy string

type ListOptions

+ AbsorbedBy string

type ListResult

+ AbsorbedAtOrigin bool

+ AbsorbedByRejection string

+ AbsorbedBySHA string

Aug 12, 2026

Changes in this version

type ListResult

+ RebaseMergedAtOrigin bool

type PullRequest

+ MergeSHA string

Aug 11, 2026

Changes in this version

type AbortOptions

+ SuccessorIdentity ClaimExecutionIdentity

+ type ClaimExecutionIdentity struct

+ CLI string

+ Model string

+ Provider string

+ type CorrectExecutionIdentityOptions struct

+ Actor string

+ CLI *string

+ ClaimID string

+ EffortID string

+ EventID string

+ Model *string

+ ProjectsRoot string

+ Provider *string

+ Reason string

+ RunID string

+ type ExecutionIdentity struct

+ CLI string

+ CorrectionIDs []string

+ Model string

+ ModelDeclaredBy string

+ ModelProvenance string

+ Provider string

+ type ExecutionIdentityCorrectionResult struct

+ ClaimID string

+ CorrectionID string

+ Identity ExecutionIdentity

+ OutboxPath string

+ func CorrectExecutionIdentity(options CorrectExecutionIdentityOptions) (ExecutionIdentityCorrectionResult, error)

type WorkLogOptions

+ CLI string

+ Provider string

Aug 10, 2026

Changes in this version

+ const SecureRenameGitHelperArgument

+ func RunSecureRenameGitHelper(args []string) int

type CreateOptions

+ BranchChosen bool

+ BranchPrefix string

+ BranchPrefixChosen bool

+ type CreatePublicationError struct

+ Err error

+ Outcomes []CreateRecoveryOutcome

+ func (err *CreatePublicationError) Error() string

+ func (err *CreatePublicationError) Unwrap() error

+ type CreateRecoveryOutcome struct

+ BacklogPersisted bool

+ CleanupBacklogID string

+ CleanupBacklogPath string

+ HeadSHA string

+ RecoveryError string

+ Result CreateResult

+ RollbackCompleted bool

+ WorkLog WorkLogPublicationOutcome

type CreateResult

+ CleanupBacklogID string

type RenameOptions

+ BranchChosen bool

+ BranchPrefix string

+ BranchPrefixChosen bool

+ type WorkLogPublicationOutcome struct

+ ClaimID string

+ ClaimPath string

+ ClaimWritten bool

+ EffortID string

+ OutboxWritten bool

+ ProjectionWritten bool

+ RunID string

Aug 10, 2026

Changes in this version

+ func PreflightWorkLogOptions(task string, options WorkLogOptions) error

+ type AbortDisposition string

+ const AbortDiscarded

+ const AbortHandoff

+ const AbortNotLanded

+ func (d AbortDisposition) String() string

+ type AbortOptions struct

+ Apply bool

+ Base string

+ DeleteRemote bool

+ Disposition AbortDisposition

+ ProjectsRoot string

+ Successor string

+ Task string

+ type AbortResult struct

+ Applied bool

+ BacklogID string

+ BranchDeleted bool

+ Disposition AbortDisposition

+ Eligible bool

+ Reason string

+ RemoteDeleted bool

+ Successor string

+ WorktreeGone bool

+ func Abort(ctx context.Context, options AbortOptions) ([]AbortResult, error)

type CleanupOutcome

+ Artifacts []LifecycleArtifact

type CleanupResult

+ BacklogID string

+ BranchDeleted bool

+ WorktreeGone bool

type CreateOptions

+ WorkLog WorkLogOptions

type CreateResult

+ BaseSHA string

+ WorkLogPath string

+ type LifecycleArtifact struct

+ Applied bool

+ ArchivePath string

+ Disposition string

+ Eligible bool

+ Kind string

+ Path string

+ Reason string

+ State string

+ Task string

+ WorktreesRoot string

type ListOutcome

+ Artifacts []LifecycleArtifact

+ SchemaVersion int

type ListResult

+ IntegratedAtOrigin bool

+ RemoteTargetSHA string

type RenameOptions

+ DeleteRemote bool

+ PreserveCachePaths []string

+ WorkLog WorkLogOptions

type RenameResult

+ OldRemoteDeleted bool

+ PreservedCachePaths []string

+ type WorkLogOptions struct

+ AgentID string

+ AgentRuntime string

+ EffortID string

+ Initiator string

+ Model string

+ OriginalPrompt string

+ RequireOriginalPrompt bool

+ RunID string

+ func PrepareWorkLogOptions(projectsRoot, task string, options WorkLogOptions) (WorkLogOptions, error)

Aug 10, 2026

Changes in this version

+ func DefaultRenameReportDir(home string, now time.Time) string

+ type RenameOptions struct

+ Apply bool

+ Base string

+ Branch string

+ DeleteOldBranch bool

+ Filter string

+ Force bool

+ NewTask string

+ Now func() time.Time

+ OldTask string

+ ProjectsRoot string

+ ReportDir string

+ type RenameOutcome struct

+ Diagnostics []ListDiagnostic

+ ReportPath string

+ Results []RenameResult

+ func Rename(ctx context.Context, options RenameOptions) (RenameOutcome, error)

+ type RenameResult struct

+ Applied bool

+ Base string

+ CanonicalDir string

+ Eligible bool

+ NewBranch string

+ NewTask string

+ NewWorktreeDir string

+ OldBranch string

+ OldBranchDeleted bool

+ OldTask string

+ OldWorktreeDir string

+ Reason string

+ Repaired bool

+ Repository string

Aug 9, 2026

Changes in this version

type CleanupOptions

+ Filter string

type CleanupOutcome

+ Diagnostics []ListDiagnostic

type ListDiagnostic

+ WorktreesRoot string

type ListOptions

+ Filter string

+ type RepositoryRenameMismatchError struct

+ CanonicalRepository string

+ Owner string

+ PathRepository string

+ Worktree string

+ func (mismatch *RepositoryRenameMismatchError) Error() string

Aug 7, 2026

Changes in this version

+ const SecureCanonicalGitHelperArgument

+ const SecureCleanupGitHelperArgument

+ const SecureStageCanonicalGitHelperArgument

+ const SecureStageGitHelperArgument

+ func CanonicalRepositoryPath(projectsRoot, repository string) (string, error)

+ func RunSecureCanonicalGitHelper(args []string) int

+ func RunSecureCleanupGitHelper(args []string) int

+ func RunSecureStageCanonicalGitHelper(args []string) int

+ func RunSecureStageGitHelper(args []string) int

+ func ValidateRepositories(repositories []string) ([]string, error)

type GuardResult

+ Transient bool

+ type ListDiagnostic struct

+ Message string

+ Path string

+ Task string

+ type ListOutcome struct

+ Diagnostics []ListDiagnostic

+ Results []ListResult

+ func ListWithDiagnostics(ctx context.Context, options ListOptions) (ListOutcome, error)

type ListResult

+ WorktreesRoot string

Jul 26, 2026

Changes in this version

+ func DefaultCleanupReportDir(projectsRoot string, now time.Time) string

+ type CleanupOptions struct

+ AllMerged bool

+ Apply bool

+ Base string

+ DeleteRemote bool

+ Now func() time.Time

+ OlderThan time.Duration

+ ProjectsRoot string

+ ReportDir string

+ Task string

+ type CleanupOutcome struct

+ ReportPath string

+ Results []CleanupResult

+ func Cleanup(ctx context.Context, options CleanupOptions) (CleanupOutcome, error)

+ type CleanupResult struct

+ Applied bool

+ Eligible bool

+ Reason string

+ RemoteDeleted bool

+ type ListOptions struct

+ Base string

+ GitHub bool

+ ProjectsRoot string

+ Task string

+ type ListResult struct

+ Base string

+ Branch string

+ CanonicalDir string

+ Clean bool

+ HeadSHA string

+ LastCommit time.Time

+ LocallyMerged bool

+ Locked bool

+ MergedPullRequest *PullRequest

+ OpenPullRequest *PullRequest

+ RemoteHeadSHA string

+ Repository string

+ Task string

+ WorktreeDir string

+ func List(ctx context.Context, options ListOptions) ([]ListResult, error)

+ type PullRequest struct

+ Base string

+ HeadSHA string

+ Merged *time.Time

+ Number int

+ State string

+ URL string

Jul 26, 2026

Changes in this version

+ func OriginSlug(ctx context.Context, path string) (string, error)

+ type CreateOptions struct

+ Base string

+ Branch string

+ Operation string

+ ProjectsRoot string

+ Resume bool

+ type CreateResult struct

+ Action string

+ Base string

+ Branch string

+ CanonicalDir string

+ Repository string

+ WorktreeDir string

+ func Create(ctx context.Context, repositories []string, options CreateOptions) ([]CreateResult, error)

+ type GuardOptions struct

+ Base string

+ ProjectsRoot string

+ type GuardResult struct

+ Branch string

+ CanonicalDir string

+ Kind string

+ Path string

+ WorktreesRoot string

+ func Guard(ctx context.Context, path string, options GuardOptions) (GuardResult, error)