hooks

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

type AgentConfig struct {
	// AutoTags declares that this repository's own CI already tags it (see
	// lesson l3-check-existing-tags-before-tagging-a-lower-version-with-newer-code-hides-the-fix
	// and lesson l11-find-out-whether-the-repo-auto-tags-before-you-hand-tag-it),
	// so a hand-pushed `git tag`/`git push --tags` is refused. A pointer so an
	// explicit `false` at the repository can override a `true` global policy.
	AutoTags *bool `yaml:"autoTags" json:"autoTags,omitempty"`
}

type AgentPolicy struct {
	AutoTags bool
}

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"`
	// Ref is the REMOTE ref a push targeted. It is what a stream push must be
	// attributed to: the checked-out branch is not necessarily the pushed
	// one, so keying on Branch reported zero stream pushes after real ones.
	Ref string `json:"ref,omitempty"`
	// Tier is the classification the push hook acted on: 0 skip, 1 lint,
	// 2 lint and test. It is recorded so the saving is measured from what
	// actually ran rather than inferred from a branch name.
	Tier   *int              `json:"tier,omitempty"`
	OS     string            `json:"os"`
	Arch   string            `json:"arch"`
	Labels map[string]string `json:"labels,omitempty"`
}

type ExecutionLayout struct {
	Root               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
	Agent              AgentPolicy
	ExplicitPath       string
}

type ProfileCost struct {
	Runs              int   `json:"runs"`
	Failures          int   `json:"failures"`
	TotalDurationMS   int64 `json:"total_duration_ms"`
	AverageDurationMS int64 `json:"average_duration_ms"`
	// MaxDurationMS is the measured budget: the slowest observed run.
	MaxDurationMS int64 `json:"max_duration_ms"`
}

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 ProfileDelta struct {
	From             string `json:"from"`
	Through          string `json:"through"`
	RepositoryFilter string `json:"repository_filter,omitempty"`
	// Commit is the pre-commit profile: formatting and static checks over the
	// files changed in that commit, never a test suite.
	Commit ProfileCost `json:"commit"`
	// StreamPush is every pre-push on a `stream/<name>` branch. These run no
	// local verification: CI on the stream pull request is the gate.
	StreamPush ProfileCost `json:"stream_push"`
	// OtherPush is every pre-push elsewhere, which runs the current full
	// profile unchanged.
	OtherPush ProfileCost `json:"other_push"`
	// SavedRuns is the number of stream-branch pushes that ran no local
	// verification.
	SavedRuns int `json:"saved_runs"`
	// SavedDurationMS is SavedRuns priced at the measured average cost of a
	// non-stream push. It is an estimate *derived from measurement*, and the
	// basis is reported alongside it so a reader can check the arithmetic.
	SavedDurationMS int64 `json:"saved_duration_ms"`
	// SavedBasisMS is the average non-stream push duration the estimate used.
	SavedBasisMS int64 `json:"saved_basis_ms"`
	// Blocks are the per-profile block costs, so a slow profile can be named
	// rather than guessed at.
	Blocks []BlockMetrics `json:"blocks,omitempty"`
	// Unmeasured names what this window could not price, so a zero saving is
	// never readable as "the stream profile saved nothing".
	Unmeasured []string `json:"unmeasured,omitempty"`
}

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
}