env

type AddEnvTargetsParams struct {
	StateDir string
	Targets  []domain.EnvFile
}

type ApplyEnvSyncParams struct {
	Branch             string
	MainPath           string
	WorktreePath       string
	ParentWorktreePath string
	ParentBranch       string
	Files              []domain.EnvFile
	Strategy           domain.EnvStrategy
	Mode               domain.EnvMode
	Ports              EnvPortsParams
	Reserved           []string
	Resolutions        map[string]EnvResolution
}

type ComputeEnvParams struct {
	Branch             string
	MainPath           string
	WorktreePath       string
	ParentWorktreePath string
	ParentBranch       string
	Files              []domain.EnvFile
	Strategy           domain.EnvStrategy
	Mode               domain.EnvMode
	Ports              EnvPortsParams
	Reserved           []string
}

type EnvPortsParams struct {
	WorktreePath string
	Links        []domain.EnvPortLink
	Bases        map[domain.PortRef]int
	Offset       int
	// Block is the spacing between two worktrees' ports, which the reconciliation
	// diff needs to recognize another worktree's spelling of the same port.
	Block int
	// Origins is what turns a port substitution into an address one. A zero
	// value plans ports, which is every caller that knows nothing of the proxy.
	Origins rules.OriginContext
	// Owned are the wtm-derived keys this worktree's .env carries, resolved by
	// the caller — the only one that can ask git which worktree this is. The
	// [[env]] links resolve into these too: one key wtm writes in full is one
	// mechanism, whatever declared it.
	Owned []domain.EnvOwnedEntry
	// ValueLinks are the [[env]] declarations behind those entries, kept so the
	// reconciliation knows which keys it must not call a drift.
	ValueLinks []domain.EnvValueLink
	// Shared names the jobs that run once for the repository, so their ports are
	// written into the .env unshifted — the service binds what it declares.
	Shared map[string]bool
}

type EnvResolution struct {
	Decisions    map[string]domain.EnvConflictDecision
	FilledValues map[string]string
	// Prune drops every orphan (the non-interactive --prune); PruneKeys drops only
	// the named orphans; SkipKeys omits an addition the user chose not to add
	// (per-key choices from the interactive wizard).
	Prune     bool
	PruneKeys map[string]bool
	SkipKeys  map[string]bool
}

type MainEnvValueRepairsParams struct {
	MainPath string
	Files    []domain.EnvFile
	Stamps   []domain.EnvOwnedEntry
}

type MissingTargetsParams struct {
	WorktreePath string
	MainPath     string
	// ParentPath is the parent's worktree, empty when it has none.
	ParentPath string
	Strategy   domain.EnvStrategy
	Files      []domain.EnvFile
}

type OwnedRestoreParams struct {
	MainPath           string
	WorktreePath       string
	ParentWorktreePath string
	Strategy           domain.EnvStrategy
	Files              []domain.EnvFile
	Keys               domain.EnvOwnedKeys
}

type SyncEnvParams struct {
	Branch             string
	MainPath           string
	WorktreePath       string
	ParentWorktreePath string
	ParentBranch       string
	Files              []domain.EnvFile
	Strategy           domain.EnvStrategy
	Mode               domain.EnvMode
	Ports              EnvPortsParams
	Reserved           []string
	Prune              bool
	Check              bool
	// OnConflict is the conflict decision applied to every conflict (keep — the safe
	// default — or overwrite).
	OnConflict domain.EnvConflictDecision
}

type WritePortKeysParams struct {
	ProjectDir string
	Writes     []domain.PortKeyWrite
}