worktrees

type AbortDisposition string

type AbortOptions struct {
	ProjectsRoot string
	Task         string
	Base         string
	Disposition  AbortDisposition
	Successor    string
	DeleteRemote bool
	Apply        bool
	// contains filtered or unexported fields
}

type AbortResult struct {
	ListResult
	Disposition   AbortDisposition `json:"disposition"`
	Successor     string           `json:"successor,omitempty"`
	Eligible      bool             `json:"eligible"`
	Applied       bool             `json:"applied"`
	WorktreeGone  bool             `json:"worktree_gone"`
	BranchDeleted bool             `json:"branch_deleted"`
	RemoteDeleted bool             `json:"remote_deleted"`
	BacklogID     string           `json:"backlog_id,omitempty"`
	Reason        string           `json:"reason,omitempty"`
}

type CleanupOptions struct {
	ProjectsRoot string
	Task         string
	Base         string
	// Filter narrows both which candidates are validated and which are acted
	// on to those whose owner/repository slug contains this substring — see
	// ListOptions.Filter. An empty Filter matches everything, preserving
	// today's behavior exactly.
	Filter       string
	AllMerged    bool
	Apply        bool
	DeleteRemote bool
	OlderThan    time.Duration
	ReportDir    string
	Now          func() time.Time
	// contains filtered or unexported fields
}

type CleanupOutcome struct {
	Results     []CleanupResult     `json:"results"`
	ReportPath  string              `json:"report_path,omitempty"`
	Diagnostics []ListDiagnostic    `json:"diagnostics,omitempty"`
	Artifacts   []LifecycleArtifact `json:"artifacts,omitempty"`
}

type CleanupResult struct {
	ListResult
	Eligible      bool   `json:"eligible"`
	Applied       bool   `json:"applied"`
	RemoteDeleted bool   `json:"remote_deleted"`
	WorktreeGone  bool   `json:"worktree_gone"`
	BranchDeleted bool   `json:"branch_deleted"`
	BacklogID     string `json:"backlog_id,omitempty"`
	Reason        string `json:"reason,omitempty"`
}

type CreateOptions struct {
	ProjectsRoot string
	Operation    string
	// Branch is an exact branch name. It has highest precedence and is never
	// derived from agent or harness identity.
	Branch string
	// BranchChosen distinguishes an omitted branch from an explicitly empty
	// --branch flag, which is invalid rather than a request to fall back.
	BranchChosen bool
	// BranchPrefix derives <prefix><operation> when Branch is empty. The
	// companion boolean preserves the meaningful explicit empty CLI value,
	// which disables any persisted prefix for this invocation.
	BranchPrefix       string
	BranchPrefixChosen bool
	Base               string
	Resume             bool
	WorkLog            WorkLogOptions
	// contains filtered or unexported fields
}

type CreatePublicationError struct {
	Outcomes []CreateRecoveryOutcome `json:"outcomes"`
	Err      error                   `json:"-"`
}

type CreateRecoveryOutcome struct {
	Result             CreateResult              `json:"result"`
	HeadSHA            string                    `json:"head_sha"`
	WorkLog            WorkLogPublicationOutcome `json:"work_log"`
	CleanupBacklogID   string                    `json:"cleanup_backlog_id,omitempty"`
	CleanupBacklogPath string                    `json:"cleanup_backlog_path,omitempty"`
	BacklogPersisted   bool                      `json:"backlog_persisted"`
	RollbackCompleted  bool                      `json:"rollback_completed"`
	RecoveryError      string                    `json:"recovery_error,omitempty"`
}

type CreateResult struct {
	Repository       string `json:"repository"`
	CanonicalDir     string `json:"canonical_dir"`
	WorktreeDir      string `json:"worktree_dir"`
	Branch           string `json:"branch"`
	Base             string `json:"base"`
	BaseSHA          string `json:"base_sha"`
	Action           string `json:"action"`
	WorkLogPath      string `json:"work_log_path,omitempty"`
	CleanupBacklogID string `json:"cleanup_backlog_id,omitempty"`
}

type GuardOptions struct {
	ProjectsRoot string
	Base         string
}

type GuardResult struct {
	Path          string `json:"path"`
	CanonicalDir  string `json:"canonical_dir"`
	WorktreesRoot string `json:"worktrees_root"`
	Branch        string `json:"branch"`
	Kind          string `json:"kind"`
	Transient     bool   `json:"transient,omitempty"`
}

type LifecycleArtifact struct {
	Task          string `json:"task"`
	WorktreesRoot string `json:"worktrees_root"`
	Path          string `json:"path"`
	Kind          string `json:"kind"`
	State         string `json:"state"`
	Disposition   string `json:"disposition"`
	Eligible      bool   `json:"eligible"`
	Applied       bool   `json:"applied"`
	ArchivePath   string `json:"archive_path,omitempty"`
	Reason        string `json:"reason,omitempty"`
}

type ListDiagnostic struct {
	Task          string `json:"task,omitempty"`
	WorktreesRoot string `json:"worktrees_root,omitempty"`
	Path          string `json:"path"`
	Message       string `json:"message"`
}

type ListOptions struct {
	ProjectsRoot string
	Task         string
	Base         string
	// Filter narrows the inventory to candidates whose owner/repository slug
	// (or, for a candidate that cannot be identified that cleanly, whatever
	// raw path-derived identity is available) contains this substring — the
	// same "only repos whose org/name contains this substring" semantics as
	// the root --filter flag elsewhere in WB. An empty Filter matches
	// everything, exactly like today. Filtering happens before a candidate's
	// diagnostic or result is retained, so a candidate outside the selection
	// can neither appear in the report nor influence it.
	Filter string
	GitHub bool
}

type ListOutcome struct {
	SchemaVersion int                 `json:"schema_version"`
	Results       []ListResult        `json:"results"`
	Diagnostics   []ListDiagnostic    `json:"diagnostics,omitempty"`
	Artifacts     []LifecycleArtifact `json:"artifacts,omitempty"`
}

type ListResult struct {
	Task               string       `json:"task"`
	Repository         string       `json:"repository"`
	CanonicalDir       string       `json:"canonical_dir"`
	WorktreeDir        string       `json:"worktree_dir"`
	WorktreesRoot      string       `json:"worktrees_root"`
	Branch             string       `json:"branch"`
	Base               string       `json:"base"`
	HeadSHA            string       `json:"head_sha"`
	RemoteHeadSHA      string       `json:"remote_head_sha,omitempty"`
	RemoteTargetSHA    string       `json:"remote_target_sha,omitempty"`
	IntegratedAtOrigin bool         `json:"integrated_at_origin"`
	Clean              bool         `json:"clean"`
	LocallyMerged      bool         `json:"locally_merged"`
	Locked             bool         `json:"locked"`
	LastCommit         time.Time    `json:"last_commit"`
	OpenPullRequest    *PullRequest `json:"open_pull_request,omitempty"`
	MergedPullRequest  *PullRequest `json:"merged_pull_request,omitempty"`
}

type PullRequest struct {
	Number  int        `json:"number"`
	URL     string     `json:"url"`
	State   string     `json:"state"`
	Base    string     `json:"base"`
	HeadSHA string     `json:"head_sha"`
	Merged  *time.Time `json:"merged_at,omitempty"`
}

type RenameOptions struct {
	ProjectsRoot string
	OldTask      string
	NewTask      string
	// Filter narrows which of OldTask's repositories are renamed to those
	// whose owner/repository slug contains this substring — see
	// ListOptions.Filter for the exact semantics. An empty Filter renames
	// every repository under OldTask.
	Filter string
	// Branch is an exact feature branch. When empty, WB derives a branch from
	// BranchPrefix or layered worktrees policy; without a prefix the new task
	// slug itself is the branch name.
	Branch             string
	BranchChosen       bool
	BranchPrefix       string
	BranchPrefixChosen bool
	Base               string
	// DeleteOldBranch is retained for source compatibility; recycle always
	// deletes the old local branch. Force is the explicit discarded-work
	// authorization for an old branch not integrated into origin/Base.
	DeleteOldBranch bool
	// DeleteRemote must be explicit for apply. If origin/<old-branch> exists,
	// it must still equal the preflight head and is retired with an exact
	// force-with-lease after the old Work Log is durable.
	DeleteRemote bool
	Force        bool
	// PreserveCachePaths is the allow-list of ignored/untracked paths that may
	// survive recycle. Empty means no cache survives. Paths are repository
	// relative, safe, and audited in the rename report.
	PreserveCachePaths []string
	WorkLog            WorkLogOptions
	// Apply performs the rename. The default is a dry-run plan, exactly like
	// `wb worktree cleanup`.
	Apply     bool
	ReportDir string
	Now       func() time.Time
	// contains filtered or unexported fields
}

type RenameOutcome struct {
	Results     []RenameResult   `json:"results"`
	ReportPath  string           `json:"report_path,omitempty"`
	Diagnostics []ListDiagnostic `json:"diagnostics,omitempty"`
}

type RenameResult struct {
	OldTask             string   `json:"old_task"`
	NewTask             string   `json:"new_task"`
	Repository          string   `json:"repository"`
	CanonicalDir        string   `json:"canonical_dir"`
	OldWorktreeDir      string   `json:"old_worktree_dir"`
	NewWorktreeDir      string   `json:"new_worktree_dir"`
	OldBranch           string   `json:"old_branch"`
	NewBranch           string   `json:"new_branch"`
	Base                string   `json:"base"`
	Eligible            bool     `json:"eligible"`
	Applied             bool     `json:"applied"`
	Repaired            bool     `json:"repaired,omitempty"`
	OldBranchDeleted    bool     `json:"old_branch_deleted"`
	OldRemoteDeleted    bool     `json:"old_remote_deleted"`
	PreservedCachePaths []string `json:"preserved_cache_paths,omitempty"`
	Reason              string   `json:"reason,omitempty"`
}

type RepositoryRenameMismatchError struct {
	Worktree            string
	Owner               string
	PathRepository      string
	CanonicalRepository string
}

type WorkLogOptions struct {
	EffortID              string
	RunID                 string
	Initiator             string
	AgentID               string
	AgentRuntime          string
	Model                 string
	OriginalPrompt        string // readable local file, copied to the private archive
	RequireOriginalPrompt bool   // public create/recycle commands require exact local recovery input
	// contains filtered or unexported fields
}

type WorkLogPublicationOutcome struct {
	ClaimPath         string `json:"claim_path,omitempty"`
	EffortID          string `json:"effort_id,omitempty"`
	RunID             string `json:"run_id,omitempty"`
	ClaimID           string `json:"claim_id,omitempty"`
	ClaimWritten      bool   `json:"claim_written"`
	ProjectionWritten bool   `json:"projection_written"`
	OutboxWritten     bool   `json:"outbox_written"`
	// contains filtered or unexported fields
}