worktreeclaims

type ActiveClaim struct {
	Task, ClaimID, Path string
}

type ActiveClaimPorts struct {
	ReadProjectionForClaim func(home, worktree string) (Projection, error)
	ReadProjectionReadOnly func(worktree string) (Projection, error)
	Corroborate            func(home, worktree string, projection Projection) error
	OpenRun                func(home, effort, run string, create bool) (*os.File, string, error)
	ReadClaimAt            func(*os.File, string) (Claim, error)
}

type ActivitySnapshot struct {
	WorktreeDir string
	LastCommit  time.Time
	Owners      []OwnerView
}

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
	WBSessionID string
	Registered  bool
}

type BindingPorts struct {
	Root       func(string) (string, error)
	Active     func(string, string) (ActiveClaim, error)
	Homes      func(string) ([]string, error)
	Walk       func(string, func(*os.File, string, string)) error
	ReadJSONAt func(*os.File, string, any) error
}

type Claim struct {
	Version         int                      `json:"version"`
	EffortID        string                   `json:"effort_id"`
	RunID           string                   `json:"run_id"`
	ClaimID         string                   `json:"claim_id"`
	Task            string                   `json:"task"`
	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"`
	ModelDeclaredBy string                   `json:"model_declared_by,omitempty"`
	CLI             string                   `json:"cli,omitempty"`
	Provider        string                   `json:"provider,omitempty"`
	TaskSummary     string                   `json:"task_summary,omitempty"`
	WBSessionID     string                   `json:"wb_session_id,omitempty"`
	PromptArchive   string                   `json:"prompt_archive,omitempty"` // run-relative
	PromptDigest    string                   `json:"prompt_sha256,omitempty"`
	ParentClaimID   string                   `json:"parent_claim_id,omitempty"`
	AcquiredVia     string                   `json:"acquired_via,omitempty"`
	ExternalHandoff *ExternalHandoffEvidence `json:"external_handoff,omitempty"`

	// Provenance fields (wb#631, SDLC logging-gap analysis 2026-09-18): IDs
	// only, read at zero cost from the environment by
	// internal/provenance.FromEnv, never a prompt or response body. Additive
	// and omitempty, so an older WB reading this claim sees nothing new and a
	// claim written before this change decodes with every one of them empty
	// — no schema version bump was needed for that.
	//
	// HarnessSessionID is stable across every subagent one harness session
	// dispatches, unlike WBSessionID above, which every subagent shares
	// because it derives from the orchestrator's PID.
	HarnessSessionID string `json:"harness_session_id,omitempty"`
	Harness          string `json:"harness,omitempty"`
	EffortLevel      string `json:"effort_level,omitempty"`
	// ToolUseID identifies the exact tool call that created this claim, set
	// by the agent guard's export prefix (internal/agentguard, wb#637) when
	// this claim was created from a subagent's Bash call.
	ToolUseID string `json:"tool_use_id,omitempty"`
	// WBVersion is the wb binary that wrote this claim.
	WBVersion string `json:"wb_version,omitempty"`
}

type ClaimExecutionIdentity struct{ Model, CLI, Provider string }

type ClaimIdentity struct {
	Version                                                int
	EffortID, Repository, Worktree, Branch, Base, BaseSHA  string
	Model, ModelProvenance, ModelDeclaredBy, CLI, Provider string
	ParentClaimID, AcquiredVia, AgentID                    string
}

type ClaimLockPorts struct{ AfterOpen func(int) }

type ClaimPublicEvent struct {
	Version    int       `json:"version"`
	Type       string    `json:"type"`
	At         time.Time `json:"at"`
	EffortID   string    `json:"effort_id"`
	RunID      string    `json:"run_id"`
	ClaimID    string    `json:"claim_id"`
	Repository string    `json:"repository"`
	Branch     string    `json:"branch"`
	Base       string    `json:"base"`
	BaseSHA    string    `json:"base_sha"`
	Lifecycle  string    `json:"lifecycle"`
}

type ClaimPullRequestBinding struct {
	Repository  string    `json:"repository"`
	PullRequest int       `json:"pull_request,omitempty"`
	URL         string    `json:"url"`
	RecordedAt  time.Time `json:"recorded_at"`
}

type CleanupLockPorts struct {
	PrepareTask   func(home, task string) (*CleanupTask, error)
	ProcessIsDead func(int) bool
	PID           func() int
	// AfterTaskOpen is an operation-local test seam for a path replacement
	// between descriptor acquisition and the final path validation.
	AfterTaskOpen func()
}

type CleanupTask struct {
	WorktreesPath    string
	TaskPath         string
	Worktrees        *os.File
	Task             *os.File
	Lock             OperationLock
	AfterPurgeRewind func()
	AfterPurgeRead   func()
}

type CorrectionIdentity struct {
	EffortID, RunID, ClaimID, EventID, Actor, Reason string
	Model, CLI, Provider                             *string
}

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

type CorrectionOutboxEvent struct {
	Version      int       `json:"version"`
	Type         string    `json:"type"`
	At           time.Time `json:"at"`
	EffortID     string    `json:"effort_id"`
	RunID        string    `json:"run_id"`
	ClaimID      string    `json:"claim_id"`
	Repository   string    `json:"repository"`
	Branch       string    `json:"branch"`
	Base         string    `json:"base"`
	BaseSHA      string    `json:"base_sha"`
	Lifecycle    string    `json:"lifecycle"`
	CorrectionID string    `json:"correction_id,omitempty"`
}

type CorrectionPorts struct {
	OpenRun              func(home, effort, run string, create bool) (*os.File, string, error)
	LockClaim            func(*os.File, string) (func(), error)
	OpenPrivateChild     func(*os.File, string, bool) (*os.File, error)
	ReadJSONAt           func(*os.File, string, any) error
	WriteJSONImmutableAt func(*os.File, string, any, bool) error
	OpenOutbox           func(string, string, bool) (*os.File, error)
	ValidSafeSegment     func(string) bool
	ReadNames            func(*os.File) ([]string, error)
	Now                  func() time.Time
}

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

type CreationResult struct {
	Repository, WorktreeDir, Branch, Base, BaseSHA string
}

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 ExternalHandoffEvidence struct {
	Version                int    `json:"version"`
	Protocol               string `json:"protocol,omitempty"`
	HandoffID              string `json:"handoff_id"`
	MemberID               string `json:"member_id,omitempty"`
	RequestDigest          string `json:"request_digest"`
	PredecessorWBSessionID string `json:"predecessor_wb_session_id"`
	SuccessorWBSessionID   string `json:"successor_wb_session_id"`
	SourceMachine          string `json:"source_machine"`
	TargetMachine          string `json:"target_machine"`
	SourceWorkLogReference string `json:"source_work_log_reference"`
	TargetWorkLogReference string `json:"target_work_log_reference"`
	SuccessorTmuxName      string `json:"successor_tmux_name"`
}

type FinalizeReport struct {
	Result     string `json:"terminal_result"`
	Message    string `json:"terminal_message,omitempty"`
	ReportPath string `json:"report_path,omitempty"`
}

type FinalizeReportPorts struct {
	SplitRepository func(string) (string, string, error)
	ValidSegment    func(string) bool
	OpenRun         func(home, effort, run string, create bool) (*os.File, string, error)
	OpenChild       func(*os.File, string, bool) (*os.File, error)
	WriteBytes      func(*os.File, string, []byte, os.FileMode) error
	OpenDirectory   func(string, bool) (*os.File, error)
	ReadBytes       func(*os.File, string) ([]byte, error)
}

type GitEvidencePorts struct {
	Git func(context.Context, string, ...string) (string, error)
}

type HeartbeatPorts struct {
	OpenJournal   func(string, bool) (*os.File, error)
	ReadBytesAt   func(*os.File, string) ([]byte, error)
	WriteAtomicAt func(*os.File, string, []byte, os.FileMode) error
	Now           func() time.Time
	PID           func() int
	GitRaw        func(context.Context, string, ...string) ([]byte, error)
	Lstat         func(string) (os.FileInfo, error)
	Getwd         func() (string, error)
	Abs           func(string) (string, error)
	Stat          func(string) (os.FileInfo, error)
	Rewind        func(*os.File) error
	ReadDir       func(*os.File) ([]os.DirEntry, error)
	EntryInfo     func(os.DirEntry) (os.FileInfo, error)
}

type HeartbeatRecord struct {
	At      time.Time `json:"at"`
	Command string    `json:"command,omitempty"`
	PID     int       `json:"pid,omitempty"`
}

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

type HistoryPorts struct {
	OpenHome          func(string, bool) (*os.File, error)
	OpenChild         func(*os.File, string, bool) (*os.File, error)
	OpenRun           func(string, string, string, bool) (*os.File, string, error)
	OpenOutbox        func(string, string, bool) (*os.File, error)
	ReadJSON          func(*os.File, string, any) error
	ValidSegment      func(string) bool
	ExpectedClaimID   func(Claim) (string, error)
	IdentityFromClaim func(Claim) ExecutionIdentity
}

type IdentityCorrection struct {
	Version       int       `json:"version"`
	Type          string    `json:"type"`
	CorrectionID  string    `json:"correction_id"`
	ClaimID       string    `json:"claim_id"`
	Sequence      int       `json:"sequence"`
	PredecessorID string    `json:"predecessor_id,omitempty"`
	At            time.Time `json:"at"`
	Actor         string    `json:"actor"`
	Reason        string    `json:"reason"`
	Initiator     string    `json:"initiator,omitempty"`
	Model         *string   `json:"model,omitempty"`
	CLI           *string   `json:"cli,omitempty"`
	Provider      *string   `json:"provider,omitempty"`
}

type IdentityState 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 LandedEvidence struct {
	Target      string `json:"target"`
	LandedSHA   string `json:"landed_sha"`
	Proof       string `json:"proof"`
	PullRequest int    `json:"pull_request,omitempty"`
}

type LegacyHandoff struct {
	HandoffID, MemberID, Repository, PredecessorWBSessionID, AgentID, SourceWorkLogReference, TargetWorkLogReference, RequestDigest string
}

type LocalGit struct {
	Branch string
	Head   string
}

type LocalJournalIdentity struct {
	EffortID, RunID, ClaimID, Lifecycle string
}

type LocalJournalPorts struct {
	EnsureExclude        func(string) error
	OpenDirectory        func(string, bool) (*os.File, error)
	ReadEvents           func(string) ([]worktreejournal.LocalWorkLogEvent, error)
	ReadBytesAt          func(*os.File, string) ([]byte, error)
	ParseEvents          func([]byte) ([]worktreejournal.LocalWorkLogEvent, error)
	EnsureCustody        func(string)
	Lock                 func(*os.File) (func(), error)
	AppendUnderLock      func(string, *os.File, worktreejournal.LocalWorkLogEvent) (worktreejournal.LocalWorkLogEvent, worktreejournal.LocalWorkLogProjection, error)
	RebuildProjection    func([]worktreejournal.LocalWorkLogEvent) (worktreejournal.LocalWorkLogProjection, error)
	ReadManifestIdentity func(string) (LocalJournalIdentity, error)
	ReadHybridProjection func(string) (LocalJournalIdentity, error)
	Git                  func(context.Context, string, ...string) (string, error)
}

type LockMetadataPorts struct {
	AfterTruncate func()
	AfterSeek     func()
	AfterWrite    func()
}

type LockOps struct {
	Chmod func(int, uint32) error
	Flock func(int, int) error
}

type LockOwnerState string

type LockedWorkLogRun struct {
	Directory *os.File
	Path      string
	Unlock    func()
}

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

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"`
	DependencyCampaign bool      `yaml:"dependency_campaign,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 MoveExpectedLockHooks struct {
	AfterMove     func()
	AfterOpen     func()
	BeforeRestore func()
}

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

type OperationLockPorts struct {
	AfterClaim           func()
	AfterOpen            func(*os.File)
	AfterHold            func(*os.File)
	AfterInspect         func(*os.File)
	AfterReclaimOpen     func(*os.File)
	AfterReclaimIdentity func(*os.File)
	AfterRetiredRewind   func(*os.File)
	MoveRetired          func(*os.File, string, ManagedLockIdentity) (*os.File, error)
	MoveQuarantine       func(*os.File, string, ManagedLockIdentity) (*os.File, error)
	RetiredToken         func() string
	StatDirectory        func(int, *unix.Stat_t) error
}

type Options struct {
	EffortID, RunID, Initiator, AgentID, AgentRuntime, Model, CLI, Provider string
	TaskSummary, WBSessionID, OriginalPrompt                                string
	RequireOriginalPrompt                                                   bool
	AcquiredVia                                                             string
	Snapshot                                                                PromptSnapshot
}

type OptionsPorts struct {
	Root             func(string) (string, error)
	OpenRun          func(string, string, string, bool) (*os.File, string, error)
	ReadBytesAt      func(*os.File, string) ([]byte, error)
	ReadJSONAt       func(*os.File, string, any) error
	OpenPrivateChild func(*os.File, string, bool) (*os.File, error)
	ValidateIdentity func(ExecutionIdentity) error
	AbsPath          func(string) (string, error)
	OpenPrompt       func(string) (*os.File, error)
	StatPrompt       func(*os.File) (os.FileInfo, error)
	ReadPrompt       func(*os.File) ([]byte, error)
}

type OwnerPorts struct {
	Version              func() string
	Now                  func() time.Time
	MutationInitiator    func() string
	CurrentIdentity      func() AgentIdentity
	InvokedCommand       func() string
	AppendEvent          func(string, worktreejournal.LocalWorkLogEvent) error
	ReadEvents           func(string) ([]worktreejournal.LocalWorkLogEvent, error)
	ActiveHandoff        func(string, string) (LegacyHandoff, bool)
	ExpectedCompletionID func(string, string) string
	ReadForInspection    func(string, func(worktreejournal.LocalWorkLogEvent) bool) ([]worktreejournal.LocalWorkLogEvent, bool, error)
	ProcessStatus        func(int) error
	Warnings             *OwnerWarnings
}

type OwnerRegistration struct {
	Agent     string    `json:"agent,omitempty"`
	Model     string    `json:"model,omitempty"`
	Effort    string    `json:"effort,omitempty"`
	Initiator string    `json:"initiator,omitempty"`
	PID       int       `json:"pid,omitempty"`
	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 OwnerWarnings struct {
	// contains filtered or unexported fields
}

type Ports struct {
	RecordOwner           func(string, string, string, string, int) error
	CurrentPID            func() int
	Git                   func(context.Context, string, ...string) (string, error)
	OriginSlug            func(context.Context, string) (string, error)
	EnsureExclude         func(string, []string, string) error
	ReadBytesAt           func(*os.File, string) ([]byte, error)
	WriteBytesImmutableAt func(*os.File, string, []byte, os.FileMode, bool) error
	EncodeManifest        func(Manifest) ([]byte, error)
	EncodePromptHeader    func(PromptHeader) ([]byte, error)
	ReadNames             func(*os.File) ([]string, error)
	Rewind                func(*os.File) error
}

type Projection struct {
	Version   int    `json:"version"`
	EffortID  string `json:"effort_id"`
	RunID     string `json:"run_id"`
	ClaimID   string `json:"claim_id"`
	Lifecycle string `json:"lifecycle"`
}

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 PromptMetadata struct {
	Version         int       `json:"version"`
	SHA256          string    `json:"sha256"`
	SourceReference string    `json:"source_reference"`
	CapturedAt      time.Time `json:"captured_at"`
}

type PromptSnapshot struct {
	Contents []byte
	Digest   string
}

type PublicEvent struct {
	Version         int                                  `json:"version"`
	Type            string                               `json:"type"`
	At              time.Time                            `json:"at"`
	EffortID        string                               `json:"effort_id"`
	RunID           string                               `json:"run_id"`
	ClaimID         string                               `json:"claim_id"`
	Repository      string                               `json:"repository"`
	Branch          string                               `json:"branch"`
	Base            string                               `json:"base"`
	BaseSHA         string                               `json:"base_sha"`
	FinalCommit     string                               `json:"final_commit,omitempty"`
	Lifecycle       string                               `json:"lifecycle"`
	Disposition     string                               `json:"disposition,omitempty"`
	CorrectionID    string                               `json:"correction_id,omitempty"`
	ExternalHandoff *ExternalHandoffEvidence             `json:"external_handoff,omitempty"`
	DirtyCapture    *worktreeproof.DirtyWorktreeEvidence `json:"dirty_capture,omitempty"`
	Supersession    *worktreeproof.SupersessionReceipt   `json:"supersession,omitempty"`
	// Landed mirrors the sealed terminal's landing proof: the target and the
	// commit are public Git facts.
	Landed *LandedEvidence `json:"landed,omitempty"`
	// FinalizeReport mirrors the sealed terminal's finalize evidence into the
	// outbox receipt so a downstream Synchestra consumer sees the same
	// terminal_result/terminal_message/report_path a local reader gets from
	// wb worktree list/summary/log show.
	FinalizeReport *FinalizeReport `json:"finalize_report,omitempty"`
}

type PublicationHooks struct {
	AfterClaim      func() error
	AfterProjection func() error
}

type PublicationPorts struct {
	OpenPrivateChild     func(*os.File, string, bool) (*os.File, error)
	ReadClaimAt          func(*os.File, string) (Claim, error)
	ReadClaimNames       func(*os.File) ([]string, error)
	CorroborateExisting  func(Claim) error
	RequiredSessionID    string
	WriteJSONImmutableAt func(*os.File, string, any, bool) error
	EnsureRunIndex       func(*os.File, string, string) error
	WriteProjection      func(string, Projection) error
	WriteCreationJournal func(Claim) error
	OpenOutbox           func(string, string, bool) (*os.File, error)
}

type PublicationReceipt struct {
	ClaimPath         string
	ClaimWritten      bool
	ProjectionWritten bool
	OutboxWritten     bool
	Claim             Claim
}

type ReconciliationEvidence struct {
	Version int    `json:"version"`
	Head    string `json:"head"`
	Ref     string `json:"ref"`
	Bundle  string `json:"bundle"`
	SHA256  string `json:"sha256"`
}

type ReconciliationPorts struct {
	ReadProjection func(string) (Projection, error)
	OpenRun        func(string, string, string, bool) (*os.File, string, error)
	OpenChild      func(*os.File, string, bool) (*os.File, error)
	ReadClaimAt    func(*os.File, string) (Claim, error)
	ReadJSON       func(*os.File, string, any) error
	WriteJSON      func(*os.File, string, any, os.FileMode) error
}

type ReconciliationRecord struct {
	Version      int       `json:"version"`
	EventID      string    `json:"event_id"`
	ClaimID      string    `json:"claim_id"`
	Worktree     string    `json:"worktree"`
	Repository   string    `json:"repository"`
	ClaimBranch  string    `json:"claim_branch"`
	LiveBranch   string    `json:"live_branch"`
	ExpectedHead string    `json:"expected_head"`
	LocalHead    string    `json:"local_claim_head"`
	RemoteHead   string    `json:"remote_claim_head"`
	TargetHead   string    `json:"target_head"`
	Actor        string    `json:"actor"`
	Reason       string    `json:"reason"`
	Stage        string    `json:"stage"`
	CreatedAt    time.Time `json:"created_at"`
}

type ReconciliationRequest struct {
	Worktree, EventID, LiveBranch, ExpectedHead, Actor, Reason string
}

type RecoveryPorts struct {
	RepositoryRootFor func(context.Context, string) (string, error)
	ReadManifest      func(string) (Manifest, error)
	ObserveGit        func(context.Context, string) LocalGit
	Git               func(context.Context, string, ...string) (string, error)
	ClaimID           func(string, CreationResult) string
}

type RegisteredPullRequestBinding struct {
	Task        string
	ClaimID     string
	Repository  string
	PullRequest int
	URL         string
	RecordedAt  time.Time
}

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

type RepositoryRegistrationPorts struct {
	Openat func(int, string, int, uint32) (int, error)
	Flock  func(int, int) error
}

type TerminalEvidence struct {
	ExternalHandoff *ExternalHandoffEvidence
	Orphaned        *worktreeproof.OrphanedEvidence
	DirtyCapture    *worktreeproof.DirtyWorktreeEvidence
	Supersession    *worktreeproof.SupersessionReceipt
	Landed          *LandedEvidence
	FinalizeReport  *FinalizeReport
}

type TerminalPorts struct {
	OpenPrivateChild   func(*os.File, string, bool) (*os.File, error)
	ReadJSONAt         func(*os.File, string, any) error
	WriteJSONImmutable func(*os.File, string, any, bool) error
	OpenOutbox         func(string, string, bool) (*os.File, error)
	Now                func() time.Time
}

type TerminalReadPorts struct {
	ReadProjectionForClaim func(home, worktree string) (Projection, error)
	ReadProjectionReadOnly func(worktree string) (Projection, error)
	ProjectionMissing      func(error) bool
	Corroborate            func(home, worktree string, projection Projection) error
	OpenRun                func(home, effort, run string, create bool) (*os.File, string, error)
	ReadTerminalAt         func(*os.File, string) (TerminalRecord, error)
}

type TerminalRecord struct {
	Claim
	FinalCommit      string                               `json:"final_commit"`
	Disposition      string                               `json:"worktree_disposition"`
	SealedAt         time.Time                            `json:"sealed_at"`
	SuccessorClaimID string                               `json:"successor_claim_id,omitempty"`
	SuccessorAgentID string                               `json:"successor_agent_id,omitempty"`
	ExternalHandoff  *ExternalHandoffEvidence             `json:"external_handoff_completion,omitempty"`
	Orphaned         *worktreeproof.OrphanedEvidence      `json:"orphaned_evidence,omitempty"`
	DirtyCapture     *worktreeproof.DirtyWorktreeEvidence `json:"dirty_capture,omitempty"`
	Supersession     *worktreeproof.SupersessionReceipt   `json:"supersession,omitempty"`
	// Landed is the proof behind a `landed` disposition that cleanup sealed:
	// which target received the work and at which commit. It is nil for every
	// other disposition and for a `landed` terminal `wb worktree log finalize`
	// sealed, which is the agent's own declaration.
	Landed *LandedEvidence `json:"landed,omitempty"`
	// FinalizeReport is set only when this terminal was sealed by
	// `wb worktree log finalize`. It is nil for every other disposition
	// (recycled, removed, superseded, orphaned, handoff, ...).
	FinalizeReport *FinalizeReport `json:"finalize_report,omitempty"`
}

type TerminalSealRequest struct {
	Claim            Claim
	FinalCommit      string
	Disposition      string
	SuccessorClaimID string
	SuccessorAgentID string
	Evidence         TerminalEvidence
}

type TerminalWorkLogExpectation struct {
	Task        string
	Repository  string
	Worktree    string
	Branch      string
	Base        string
	FinalCommit string
}