hooks

type ActiveProfile struct {
	Name   string `json:"name"`
	Order  int    `json:"order"`
	Reason string `json:"reason"`
}

type ApplyOptions struct {
	RepoPath     string
	ConfigPath   string
	WBExecutable string
	// ProjectsRoot is persisted in every shim so hooks keep the same checkout
	// policy when WB was invoked with a non-default --projects-root.
	ProjectsRoot string
	// WBHome is persisted in every shim so hooks preserve an explicit WB_HOME
	// and do not recreate mixed-home state after a later shell invocation.
	WBHome string
	// WBHomeAllowsLegacy marks a shim installed from the normal default layout.
	// Such a shim pins its default write home but must still guard legacy linked
	// worktrees until migration completes.
	WBHomeAllowsLegacy bool
	Repair             bool
	Force              bool
	Now                func() time.Time
	// contains filtered or unexported fields
}

type ApplyResult struct {
	Report  CheckReport
	Actions []string
}

type BlockMetrics struct {
	ID                string `json:"id"`
	Profile           string `json:"profile"`
	Hook              string `json:"hook"`
	Runs              int    `json:"runs"`
	Failures          int    `json:"failures"`
	TotalDurationMS   int64  `json:"total_duration_ms"`
	AverageDurationMS int64  `json:"average_duration_ms"`
}

type BlockRunResult struct {
	ID       string
	Profile  string
	ExitCode int
	Duration time.Duration
}

type CachedGHPRLookup struct {
	RepoRoot  string
	RepoSlug  string
	CachePath string
	TTL       time.Duration
	Timeout   time.Duration
	Now       func() time.Time
	RunGH     runGHFunc
}

type CheckReport struct {
	RepoRoot       string          `json:"repo_root"`
	ManagedPath    string          `json:"managed_path"`
	ConfigPaths    []string        `json:"config_paths,omitempty"`
	Hooks          []string        `json:"hooks"`
	ProfilesAuto   bool            `json:"profiles_auto"`
	ActiveProfiles []ActiveProfile `json:"active_profiles,omitempty"`
	// ExcludedProfiles makes explicit policy exceptions auditable even though
	// they intentionally contribute no hook blocks. In particular, disabling
	// the default worktree admission guard must never look like an ordinary
	// healthy installation with no explanation.
	ExcludedProfiles []string            `json:"excluded_profiles,omitempty"`
	HookBlocks       map[string][]string `json:"hook_blocks,omitempty"`
	MetricsPath      string              `json:"metrics_path,omitempty"`
	Findings         []Finding           `json:"findings,omitempty"`
}

type Classification struct {
	Tier   pushTier
	Reason string
}

type DailyMetrics struct {
	Date              string `json:"date"`
	Commits           int    `json:"commits"`
	PushAttempts      int    `json:"push_attempts"`
	CommitChecks      int    `json:"commit_checks"`
	HookFailures      int    `json:"hook_failures"`
	HookRuns          int    `json:"hook_runs"`
	TotalDurationMS   int64  `json:"total_duration_ms"`
	AverageDurationMS int64  `json:"average_duration_ms"`
}

type Event struct {
	SchemaVersion int               `json:"schema_version"`
	Timestamp     time.Time         `json:"timestamp"`
	Repository    string            `json:"repository"`
	Hook          string            `json:"hook"`
	Profile       string            `json:"profile,omitempty"`
	Block         string            `json:"block,omitempty"`
	Action        string            `json:"action"`
	Outcome       string            `json:"outcome"`
	DurationMS    int64             `json:"duration_ms"`
	Commit        string            `json:"commit,omitempty"`
	Branch        string            `json:"branch,omitempty"`
	OS            string            `json:"os"`
	Arch          string            `json:"arch"`
	Labels        map[string]string `json:"labels,omitempty"`
}

type ExecutionLayout struct {
	Root               string
	CacheRoot          string
	GoPath             string
	GoCache            string
	GoModCache         string
	GoTmpDir           string
	XDGCacheHome       string
	ReportRoot         string
	PendingMetricsRoot string
}

type Finding struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	Path    string `json:"path,omitempty"`
}

type HookBlock struct {
	ID      string
	Profile string
	Hook    ResolvedHook
}

type HookConfig struct {
	Template string `yaml:"template" json:"template,omitempty"`
	Disabled bool   `yaml:"disabled" json:"disabled,omitempty"`
}

type MetricsConfig struct {
	Enabled *bool             `yaml:"enabled" json:"enabled,omitempty"`
	Path    string            `yaml:"path" json:"path,omitempty"`
	Labels  map[string]string `yaml:"labels" json:"labels,omitempty"`
}

type MetricsPolicy struct {
	Enabled bool
	Path    string
	Labels  map[string]string
}

type MetricsSummary struct {
	From              string         `json:"from"`
	Through           string         `json:"through"`
	RepositoryFilter  string         `json:"repository_filter,omitempty"`
	Commits           int            `json:"commits"`
	PushAttempts      int            `json:"push_attempts"`
	CommitChecks      int            `json:"commit_checks"`
	HookFailures      int            `json:"hook_failures"`
	HookRuns          int            `json:"hook_runs"`
	AverageDurationMS int64          `json:"average_duration_ms"`
	Days              []DailyMetrics `json:"days"`
	Blocks            []BlockMetrics `json:"blocks,omitempty"`
}

type PRLookup interface {
	OpenPullRequest(branch string) (open bool, known bool)
}

type PendingMetricsReceipt struct {
	SchemaVersion int       `json:"schema_version"`
	RecordedAt    time.Time `json:"recorded_at"`
	TargetPath    string    `json:"target_path"`
	AppendError   string    `json:"append_error"`
	Events        []Event   `json:"events"`
}

type Policy struct {
	RepoRoot           string
	ConfigPaths        []string
	Hooks              map[string]ResolvedHook
	ProfilesAuto       bool
	ProfileSelections  map[string]bool
	ProfileDefinitions map[string]ProfileDefinition
	ActiveProfiles     []ActiveProfile
	Metrics            MetricsPolicy
	ExplicitPath       string
}

type ProfileDefinition struct {
	Name       string
	Order      int
	Detection  ProfileDetection
	Hooks      map[string]ResolvedHook
	ConfigPath string
}

type ProfileDefinitionConfig struct {
	Order  *int                  `yaml:"order"`
	Detect *ProfileDetection     `yaml:"detect"`
	Hooks  map[string]HookConfig `yaml:"hooks"`
}

type ProfileDetection struct {
	AnyFiles []string `yaml:"any_files" json:"any_files,omitempty"`
	AllFiles []string `yaml:"all_files" json:"all_files,omitempty"`
}

type ProfilesConfig struct {
	Auto        *bool                              `yaml:"auto"`
	Include     []string                           `yaml:"include"`
	Exclude     []string                           `yaml:"exclude"`
	Definitions map[string]ProfileDefinitionConfig `yaml:"definitions"`
}

type RefUpdate struct {
	LocalRef  string
	LocalSHA  string
	RemoteRef string
	RemoteSHA string
}

type ResolvedHook struct {
	Name       string
	Template   string
	Builtin    bool
	Disabled   bool
	ConfigPath string
}

type RunOptions struct {
	RepoPath     string
	ConfigPath   string
	Hook         string
	Args         []string
	Stdin        io.Reader
	Stdout       io.Writer
	Stderr       io.Writer
	Now          func() time.Time
	WBExecutable string
	ProjectsRoot string
}

type RunResult struct {
	ExitCode     int
	Duration     time.Duration
	Blocks       []BlockRunResult
	MetricsError error
}