worktrees

type AbortDisposition string

type AbortOptions struct {
	ProjectsRoot string
	Task         string
	Base         string
	Disposition  AbortDisposition
	Successor    string
	// SuccessorIdentity is the caller's explicit execution identity declaration
	// for the claim created by an applied handoff/not_landed transition.
	SuccessorIdentity ClaimExecutionIdentity
	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 Admission struct {
	Mode     AdmissionMode `json:"mode"`
	Admitted bool          `json:"admitted"`
	Reason   string        `json:"reason,omitempty"`
	Remedy   string        `json:"remedy,omitempty"`
}

type AdmissionMode string

type AgentIdentity struct {
	Runtime string
	AgentID string
	Model   string
	PID     int
}

type BackfillOptions struct {
	ProjectsRoot string
	Base         string
	Apply        bool
}

type BackfillResult struct {
	Path       string `json:"path"`
	Repository string `json:"repository"`
	EffortID   string `json:"effort_id,omitempty"`
	Layout     string `json:"layout"`
	Action     string `json:"action"`
	Reason     string `json:"reason,omitempty"`
}

type BranchCleanupOptions struct {
	ProjectsRoot string
	Base         string
	Scope        string
	Apply        bool
	OlderThan    time.Duration
	ReportDir    string
	Filter       string
	Progress     io.Writer
	// Now is injectable so age eligibility is deterministic under test.
	Now func() time.Time
}

type BranchCleanupOutcome struct {
	Base        string                `json:"base"`
	Scope       string                `json:"scope"`
	Apply       bool                  `json:"apply"`
	Results     []BranchCleanupResult `json:"results"`
	Diagnostics []string              `json:"diagnostics,omitempty"`
	Totals      map[string]int        `json:"totals"`
	ReportPath  string                `json:"report_path,omitempty"`
	ElapsedMS   int64                 `json:"elapsed_ms"`
}

type BranchCleanupResult struct {
	BranchEntry
	Eligible   bool   `json:"eligible"`
	SkipReason string `json:"skip_reason,omitempty"`
	Applied    bool   `json:"applied"`
	Outcome    string `json:"outcome"` // planned, deleted, skipped, or failed
	Error      string `json:"error,omitempty"`
}

type BranchEntry struct {
	Repository      string       `json:"repository"`
	Branch          string       `json:"branch"`
	Scope           string       `json:"scope"` // local or remote
	SHA             string       `json:"sha"`
	ShortSHA        string       `json:"short_sha"`
	CommitterDate   time.Time    `json:"committer_date,omitempty"`
	Base            string       `json:"base"`
	TargetSHA       string       `json:"target_sha,omitempty"`
	Disposition     string       `json:"disposition"`
	Evidence        string       `json:"evidence"`
	Reason          string       `json:"reason,omitempty"`
	Task            string       `json:"task,omitempty"`
	OpenPullRequest *PullRequest `json:"open_pull_request,omitempty"`
	// PullRequestQueryFailed distinguishes "no open pull request" from "WB
	// could not ask GitHub." Cleanup's remote apply fails the whole scope
	// closed on the latter; list surfaces it but never refuses on it.
	PullRequestQueryFailed bool `json:"pull_request_query_failed,omitempty"`
}

type BranchListOptions struct {
	ProjectsRoot string
	Base         string
	Scope        string // local, remote, or all; default local
	Only         string // one disposition name; empty means every disposition
	OlderThan    time.Duration
	Filter       string
	// Progress receives incremental "[n/N] repository" lines as the sweep
	// works, plus a closing summary. Nil disables progress reporting.
	Progress io.Writer
}

type BranchListOutcome struct {
	Base        string         `json:"base"`
	Scope       string         `json:"scope"`
	Entries     []BranchEntry  `json:"entries"`
	Diagnostics []string       `json:"diagnostics,omitempty"`
	Totals      map[string]int `json:"totals"`
	ElapsedMS   int64          `json:"elapsed_ms"`
}

type ClaimExecutionIdentity struct {
	Model    string
	CLI      string
	Provider string
}

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
	// AbsorbedBy is the optional landing receipt pointer described on
	// ListOptions.AbsorbedBy. It is verified, never trusted.
	AbsorbedBy string
	// Progress and Workers are passed straight through to the inventory walk;
	// see ListOptions. Cleanup's whole cost is that walk, so a fleet-wide run
	// is unobservable and unbounded without them.
	Progress  func(ListProgress)
	Workers   int
	AllMerged bool
	Apply     bool
	// ResumeInterrupted authorizes recovery of exactly the named task's
	// descriptor-validated interrupted lock before normal terminal cleanup.
	// It is deliberately unavailable to fleet cleanup.
	ResumeInterrupted 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"`
	Recovery    *InterruptedLockRecovery `json:"recovery,omitempty"`
}

type CleanupResult struct {
	ListResult
	Eligible      bool `json:"eligible"`
	Applied       bool `json:"applied"`
	RemoteDeleted bool `json:"remote_deleted"`
	WorktreeGone  bool `json:"worktree_gone"`
	// WorktreeResidueRemoved records that Git unregistered the worktree, failed
	// to finish deleting it, and WB removed what was left. It is audit
	// evidence, not a warning: the task completes either way, and the operator
	// deserves to know which of the two paths deleted the checkout.
	WorktreeResidueRemoved bool   `json:"worktree_residue_removed,omitempty"`
	BranchDeleted          bool   `json:"branch_deleted"`
	BacklogID              string `json:"backlog_id,omitempty"`
	Reason                 string `json:"reason,omitempty"`
}

type CorrectExecutionIdentityOptions struct {
	ProjectsRoot string
	EffortID     string
	RunID        string
	ClaimID      string
	EventID      string
	Actor        string
	Reason       string
	Model        *string
	CLI          *string
	Provider     *string
}

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 ExecutionIdentity struct {
	Model           string   `json:"model"`
	ModelProvenance string   `json:"model_provenance"`
	ModelDeclaredBy string   `json:"model_declared_by,omitempty"`
	CLI             string   `json:"cli,omitempty"`
	Provider        string   `json:"provider,omitempty"`
	CorrectionIDs   []string `json:"correction_ids,omitempty"`
}

type ExecutionIdentityCorrectionResult struct {
	ClaimID      string            `json:"claim_id"`
	CorrectionID string            `json:"correction_id"`
	Identity     ExecutionIdentity `json:"identity"`
	OutboxPath   string            `json:"outbox_path"`
}

type GuardOptions struct {
	ProjectsRoot string
	Base         string

	// Admission gates a commit on the worktree carrying its own record. It is
	// off unless a caller opts in, so guard's existing layout checks keep their
	// current meaning everywhere else.
	Admission AdmissionMode
}

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"`
	Admission     *Admission `json:"admission,omitempty"`
}

type HeldOperationLock struct {
	// contains filtered or unexported fields
}

type InterruptedLockRecovery struct {
	Task          string `json:"task"`
	WorktreesRoot string `json:"worktrees_root"`
	Path          string `json:"path"`
	PID           int    `json:"pid"`
	Disposition   string `json:"disposition"`
	Applied       bool   `json:"applied"`
	Reason        string `json:"reason,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
	// OwnerState limits results by current owner PID liveness: active or orphaned.
	OwnerState string
	GitHub     bool
	// AbsorbedBy points at the merged pull request or exact landing commit
	// that carried a candidate's work into the target inside a differently
	// named integration branch. It selects which receipt to verify and never
	// substitutes for one: every containment proof still runs, so a wrong or
	// dishonest pointer can only fail closed. See absorbedLandingReceipt.
	AbsorbedBy string
	// Progress, when set, is called as the walk reaches and finishes each
	// candidate. The inventory is one long blocking call — with GitHub set it
	// fetches from the network once per candidate, serially — so without this
	// hook a fleet-wide run is indistinguishable from a hang for as long as it
	// takes. It is observation only: nothing about the walk depends on it, and
	// a nil Progress costs nothing.
	Progress func(ListProgress)
	// Workers caps concurrent candidate inspections, mirroring wb sync's
	// --workers. Zero means the default; one makes the walk serial again,
	// which is the behaviour to fall back to if a repository ever proves
	// unsafe to inspect alongside its siblings.
	Workers int
}

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

type ListProgress struct {
	// Index counts candidates inspected in this run, 1-based, across every
	// layout. The total is not known in advance: it takes reading each task
	// directory to learn how many repositories are under it, which is most of
	// the walk itself.
	Index      int
	Task       string
	Repository string // empty until inspection identifies it
	Path       string
	// Done distinguishes reaching a candidate from finishing it. Both are
	// reported because the gap between them is the part that takes the time,
	// and a candidate that never reports Done is the one that is stuck.
	Done    bool
	Elapsed time.Duration
	// Network is true when this candidate's inspection contacts origin, which
	// is what makes the walk slow.
	Network bool
}

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"`
	RebaseMergedAtOrigin bool   `json:"rebase_merged_at_origin,omitempty"`
	AbsorbedAtOrigin     bool   `json:"absorbed_at_origin,omitempty"`
	AbsorbedBySHA        string `json:"absorbed_by_sha,omitempty"`
	// AbsorbedByRejection explains why an explicitly supplied --absorbed-by
	// receipt did not hold. An operator pointer that fails verification is a
	// precise, reportable refusal of that candidate, never a malformed
	// worktree and never a reason to abort a fleet-wide sweep.
	AbsorbedByRejection string `json:"absorbed_by_rejection,omitempty"`
	Clean               bool   `json:"clean"`
	LocallyMerged       bool   `json:"locally_merged"`
	Locked              bool   `json:"locked"`
	// LockOwner and LockOwnerPID describe who holds Locked, so a refusal
	// can distinguish a peer operation still running from a recoverable
	// remnant of one that was interrupted. See diagnoseTaskLock.
	LockOwner         LockOwnerState `json:"lock_owner,omitempty"`
	LockOwnerPID      int            `json:"lock_owner_pid,omitempty"`
	LastCommit        time.Time      `json:"last_commit"`
	Owners            []OwnerView    `json:"owners,omitempty"`
	OwnerState        string         `json:"owner_state"`
	OpenPullRequest   *PullRequest   `json:"open_pull_request,omitempty"`
	MergedPullRequest *PullRequest   `json:"merged_pull_request,omitempty"`
}

type LoadWorkLogOptions struct {
	ProjectsRoot        string
	Worktree            string
	IncludePromptBodies bool
}

type LocalGitEvidence struct {
	Branch    string `json:"branch,omitempty"`
	Head      string `json:"head,omitempty"`
	Dirty     bool   `json:"dirty"`
	StatusSHA string `json:"status_sha256,omitempty"`
	Status    string `json:"status,omitempty"`
}

type LocalTargetEvidence struct {
	Ref       string    `json:"ref,omitempty"`
	SHA       string    `json:"sha,omitempty"`
	FetchedAt time.Time `json:"fetched_at,omitempty"`
	Ahead     int       `json:"ahead"`
	Behind    int       `json:"behind"`
	Strategy  string    `json:"strategy,omitempty"`
}

type LocalUsageEvidence struct {
	Discriminator string   `json:"discriminator"`
	InputTokens   *int64   `json:"input_tokens,omitempty"`
	OutputTokens  *int64   `json:"output_tokens,omitempty"`
	TotalTokens   *int64   `json:"total_tokens,omitempty"`
	EstimatedCost *float64 `json:"estimated_cost,omitempty"`
	Currency      string   `json:"currency,omitempty"`
	ProviderRef   string   `json:"provider_ref,omitempty"`
}

type LocalWorkLogEvent struct {
	Version    int                  `json:"version"`
	Seq        int                  `json:"seq"`
	ID         string               `json:"id"`
	Type       string               `json:"type"`
	At         time.Time            `json:"at"`
	Message    string               `json:"message,omitempty"`
	NextAction string               `json:"next_action,omitempty"`
	Prompt     string               `json:"prompt,omitempty"`
	PromptSHA  string               `json:"prompt_sha256,omitempty"`
	Git        *LocalGitEvidence    `json:"git,omitempty"`
	Target     *LocalTargetEvidence `json:"target,omitempty"`
	Usage      *LocalUsageEvidence  `json:"usage,omitempty"`
	Result     string               `json:"result,omitempty"`
	Conflict   string               `json:"conflict,omitempty"`
	Owner      *OwnerRegistration   `json:"owner,omitempty"`
	Extra      map[string]any       `json:"extra,omitempty"`
}

type LocalWorkLogProjection struct {
	Version        int                  `json:"version"`
	EffortID       string               `json:"effort_id,omitempty"`
	RunID          string               `json:"run_id,omitempty"`
	ClaimID        string               `json:"claim_id,omitempty"`
	Lifecycle      string               `json:"lifecycle"`
	LastSeq        int                  `json:"last_seq"`
	LastEventID    string               `json:"last_event_id,omitempty"`
	LastType       string               `json:"last_type,omitempty"`
	LastMessage    string               `json:"last_message,omitempty"`
	LastNextAction string               `json:"last_next_action,omitempty"`
	LastCheckpoint *LocalGitEvidence    `json:"last_checkpoint,omitempty"`
	LastTarget     *LocalTargetEvidence `json:"last_target,omitempty"`
	Conflict       string               `json:"conflict,omitempty"`
	UpdatedAt      time.Time            `json:"updated_at"`
}

type LockOwnerState string

type LogArchiveOptions struct {
	ProjectsRoot string
	Worktree     string
	Apply        bool
	Force        bool
}

type LogCheckpointOptions struct {
	ProjectsRoot  string
	Worktree      string
	Message       string
	NextAction    string
	UsageDisc     string
	InputTokens   *int64
	OutputTokens  *int64
	EstimatedCost *float64
	Currency      string
	ProviderRef   string
}

type LogFinalizeOptions struct {
	ProjectsRoot string
	Worktree     string
	Result       string // success|failure
	Message      string
	Apply        bool
}

type LogHandoffOptions struct {
	ProjectsRoot string
	Worktree     string
	Summary      string
	NextAction   string
	Successor    string
	Model        string
	CLI          string
	Provider     string
	Apply        bool
}

type LogInitOptions struct {
	ProjectsRoot string
	Worktree     string
	Prompt       []byte
	Source       string
	Model        string
	CLI          string
	Provider     string
	Runtime      string
	AgentID      string
}

type LogIntegrateOptions struct {
	ProjectsRoot string
	Worktree     string
	Base         string
	Strategy     string // rebase|merge|auto
}

type LogRecoverOptions struct {
	ProjectsRoot string
	Worktree     string
	Apply        bool
	Takeover     bool
	Actor        string
}

type LogRefreshOptions struct {
	ProjectsRoot string
	Worktree     string
	Base         string
}

type LogSteerOptions struct {
	ProjectsRoot string
	Worktree     string
	Body         []byte
	Source       string
	Runtime      string
	Model        string
	CLI          string
	Provider     string
}

type LogSyncOptions struct {
	ProjectsRoot string
	Worktree     string
	Apply        bool
}

type LogVerbResult struct {
	Worktree   string                  `json:"worktree"`
	Verb       string                  `json:"verb"`
	Event      *LocalWorkLogEvent      `json:"event,omitempty"`
	Projection *LocalWorkLogProjection `json:"projection,omitempty"`
	Prompt     string                  `json:"prompt,omitempty"`
	Applied    bool                    `json:"applied"`
	Offline    bool                    `json:"offline,omitempty"`
	Outbox     int                     `json:"outbox,omitempty"`
	Notes      []string                `json:"notes,omitempty"`
	Diagnosis  []string                `json:"diagnosis,omitempty"`
}

type Manifest struct {
	Version      int       `yaml:"version"`
	EffortID     string    `yaml:"effort_id"`
	ParentEffort string    `yaml:"parent_effort,omitempty"`
	EffortKind   string    `yaml:"effort_kind"`
	Repository   string    `yaml:"repository"`
	Worktree     string    `yaml:"worktree"`
	Branch       string    `yaml:"branch"`
	Base         string    `yaml:"base"`
	BaseSHA      string    `yaml:"base_sha"`
	CreatedAt    time.Time `yaml:"created_at"`
	Initiator    string    `yaml:"initiator,omitempty"`
	AgentID      string    `yaml:"agent_id,omitempty"`
	AgentRuntime string    `yaml:"agent_runtime,omitempty"`
	Model        string    `yaml:"model,omitempty"`
	CLI          string    `yaml:"cli,omitempty"`
	Provider     string    `yaml:"provider,omitempty"`
	RunID        string    `yaml:"run_id,omitempty"`
	ClaimID      string    `yaml:"claim_id,omitempty"`
	Provenance   string    `yaml:"provenance"`

	// InferredFields and Evidence are populated only for a reconstructed
	// manifest, so a reader can see exactly which values were guessed and from
	// what. They stay empty for provenance: created.
	InferredFields []string `yaml:"inferred_fields,omitempty"`
	Evidence       []string `yaml:"evidence,omitempty"`
}

type OriginalPromptView struct {
	Source string `json:"source"` // journal | archive
	Name   string `json:"name,omitempty"`
	SHA256 string `json:"sha256,omitempty"`
	Body   string `json:"body,omitempty"`
}

type OrphanFamily struct {
	RootEffort  string           `json:"root_effort"`
	Worktrees   []OrphanWorktree `json:"worktrees"`
	Disposition string           `json:"disposition"`
	Reason      string           `json:"reason,omitempty"`
}

type OrphanOptions struct {
	ProjectsRoot string
	Base         string
	// StaleAfter is how long without a commit before an unmerged worktree needs
	// a decision. It never makes anything eligible for automatic removal.
	StaleAfter time.Duration
	// Now is injectable so ages are deterministic under test.
	Now time.Time
}

type OrphanReport struct {
	Families []OrphanFamily `json:"families"`
	// Residue is the checkouts no registry mentions, which the family sweep is
	// structurally unable to see. See orphans_residue.go.
	Residue   []OrphanResidue `json:"residue,omitempty"`
	Totals    OrphanTotals    `json:"totals"`
	Unscanned []string        `json:"unscanned,omitempty"`
}

type OrphanResidue struct {
	Path          string   `json:"path"`
	WorktreesRoot string   `json:"worktrees_root"`
	Task          string   `json:"task"`
	Repository    string   `json:"repository"`
	Layout        string   `json:"layout"`
	CanonicalDir  string   `json:"canonical_dir,omitempty"`
	Evidence      []string `json:"evidence,omitempty"`
	Remedy        string   `json:"remedy"`
}

type OrphanTotals struct {
	Worktrees   int            `json:"worktrees"`
	Families    int            `json:"families"`
	ByLayout    map[string]int `json:"by_layout"`
	ByDispositn map[string]int `json:"by_disposition"`
	NoManifest  int            `json:"without_manifest"`
	Dirty       int            `json:"dirty"`
	Residue     int            `json:"residue"`
}

type OrphanWorktree struct {
	Path         string `json:"path"`
	CanonicalDir string `json:"canonical_dir"`
	Repository   string `json:"repository"`
	Layout       string `json:"layout"`
	Branch       string `json:"branch"`
	EffortID     string `json:"effort_id"`
	ParentEffort string `json:"parent_effort,omitempty"`
	RootEffort   string `json:"root_effort"`

	HasManifest bool   `json:"has_manifest"`
	Provenance  string `json:"provenance,omitempty"`
	HasPrompts  bool   `json:"has_prompts"`
	PromptCount int    `json:"prompt_count"`

	LastCommit time.Time `json:"last_commit,omitempty"`
	AgeDays    int       `json:"age_days"`
	Dirty      bool      `json:"dirty"`
	Missing    bool      `json:"missing"`
	Merged     bool      `json:"merged_into_target"`

	// Owner evidence, when a session declared itself. OwnerState is live,
	// gone, or unstated; only a declared PID counts, so a worktree nobody
	// claimed is unstated rather than falsely reported as abandoned.
	OwnerState string `json:"owner_state"`
	OwnerAgent string `json:"owner_agent,omitempty"`
	OwnerPID   int    `json:"owner_pid,omitempty"`

	Disposition string   `json:"disposition"`
	Evidence    []string `json:"evidence"`
}

type OwnerRegistration struct {
	Agent  string `json:"agent,omitempty"`
	Model  string `json:"model,omitempty"`
	Effort string `json:"effort,omitempty"`
	// PID is the declared agent session's process, never WB's own. WB is a
	// short-lived CLI: its PID is dead moments after it would be written, and
	// once recycled it would report an abandoned worktree as active. An
	// absent PID therefore reads as unknown, which is the honest answer.
	PID int `json:"pid,omitempty"`
	// WBVersion and Command are always populated, because WB always knows
	// them. They give a worktree provenance even when no agent identity was
	// declared.
	WBVersion string    `json:"wb_version,omitempty"`
	Command   string    `json:"command,omitempty"`
	At        time.Time `json:"at"`
}

type OwnerView struct {
	OwnerRegistration
	PIDStatus string `json:"pid_status"`
}

type PromptHeader struct {
	Seq      int       `yaml:"seq"`
	At       time.Time `yaml:"at"`
	SHA256   string    `yaml:"sha256"`
	Source   string    `yaml:"source"`
	Runtime  string    `yaml:"runtime,omitempty"`
	Model    string    `yaml:"model,omitempty"`
	CLI      string    `yaml:"cli,omitempty"`
	Provider string    `yaml:"provider,omitempty"`
	Slug     string    `yaml:"-"`
}

type PromptRecord struct {
	Name     string    `json:"name"`
	Seq      int       `json:"seq"`
	At       time.Time `json:"at"`
	SHA256   string    `json:"sha256"`
	Source   string    `json:"source"`
	Runtime  string    `json:"runtime,omitempty"`
	Model    string    `json:"model,omitempty"`
	CLI      string    `json:"cli,omitempty"`
	Provider string    `json:"provider,omitempty"`
	Body     string    `json:"body,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"`
	MergeSHA string     `json:"merge_sha,omitempty"`
	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 RetireShellsOptions struct {
	ProjectsRoot string
	Filter       string
	Apply        bool
}

type RetireShellsOutcome struct {
	Apply   bool           `json:"apply"`
	Results []RetiredShell `json:"results"`
	Totals  map[string]int `json:"totals"`
}

type RetiredShell struct {
	WorktreesRoot string `json:"worktrees_root"`
	Task          string `json:"task"`
	Path          string `json:"path"`
	Eligible      bool   `json:"eligible"`
	Applied       bool   `json:"applied"`
	Reason        string `json:"reason"`
	Error         string `json:"error,omitempty"`
}

type WorkLogClaimView struct {
	EffortID        string    `json:"effort_id"`
	RunID           string    `json:"run_id"`
	ClaimID         string    `json:"claim_id"`
	Task            string    `json:"task,omitempty"`
	Repository      string    `json:"repository"`
	Worktree        string    `json:"worktree"`
	Branch          string    `json:"branch"`
	Base            string    `json:"base"`
	BaseSHA         string    `json:"base_sha"`
	Lifecycle       string    `json:"lifecycle"`
	RecordedAt      time.Time `json:"recorded_at"`
	Initiator       string    `json:"initiator,omitempty"`
	AgentID         string    `json:"agent_id,omitempty"`
	AgentRuntime    string    `json:"agent_runtime,omitempty"`
	Model           string    `json:"model,omitempty"`
	ModelProvenance string    `json:"model_provenance,omitempty"`
	CLI             string    `json:"cli,omitempty"`
	Provider        string    `json:"provider,omitempty"`
	PromptDigest    string    `json:"prompt_sha256,omitempty"`
	PromptArchive   string    `json:"prompt_archive,omitempty"`
	ClaimPath       string    `json:"claim_path,omitempty"`
}

type WorkLogGitEvidence struct {
	Branch string `json:"branch,omitempty"`
	Head   string `json:"head,omitempty"`
	Dirty  bool   `json:"dirty"`
	Status string `json:"status_short,omitempty"`
}

type WorkLogOptions struct {
	EffortID              string
	RunID                 string
	Initiator             string
	AgentID               string
	AgentRuntime          string
	Model                 string
	CLI                   string
	Provider              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
}

type WorkLogView struct {
	Worktree       string              `json:"worktree"`
	Manifest       *Manifest           `json:"manifest,omitempty"`
	Prompts        []PromptRecord      `json:"prompts"`
	OriginalPrompt *OriginalPromptView `json:"original_prompt,omitempty"`
	Claim          *WorkLogClaimView   `json:"claim,omitempty"`
	Owners         []OwnerView         `json:"owners,omitempty"`
	Git            WorkLogGitEvidence  `json:"git"`
	Notes          []string            `json:"notes,omitempty"`
}