telemetry

type CommitCondensedSignal struct {
	// Agent is the session-owning agent's registry key (e.g. "claude-code"),
	// matching the agent property on skill and command events.
	Agent string
	// UsedSearch reports whether the session invoked `entire search`. Nil means
	// the question was not answerable for this agent's transcript format, and
	// the property is then OMITTED from the payload rather than sent as false —
	// so a consumer filtering on `used_search = false` excludes unknowns instead
	// of silently counting them as "did not search". UsedSearchSource always
	// says which case this is.
	UsedSearch *bool
	// UsedSearchSource records how UsedSearch was determined: "unsupported",
	// "none", "command", or "subagent". Always present.
	UsedSearchSource string
	// PriorAIHistory reports whether any committed file was touched by a
	// recent AI checkpoint commit before this one. Nil means the git-log probe
	// could not run (git unavailable, cancelled ctx, shallow-clone failure) and
	// the property is then OMITTED from the payload rather than sent as false —
	// same rationale as UsedSearch: a fabricated "no prior history" deflates
	// the very miss rate this event exists to measure. A commit that landed no
	// files is a measured false, not an omission.
	PriorAIHistory *bool
	// FilesCommitted is the number of files this checkpoint touched.
	FilesCommitted int
}

type EventPayload struct {
	Event      string         `json:"event"`
	DistinctID string         `json:"distinct_id"`
	Properties map[string]any `json:"properties"`
	Timestamp  time.Time      `json:"timestamp"`
}

type SearchOutcome struct {
	// Command is the invoked cobra command path ("entire search" or
	// "entire checkpoint search").
	Command string
	// Mode is SearchModeCheckpoint or SearchModeCode.
	Mode string
	// ErrorClass is the coarse failure class (SearchErrClass*); empty means
	// the search succeeded.
	ErrorClass string
	// ResultCount is the number of results returned; only meaningful on
	// success (zero results is a distinct signal from failure) and omitted
	// from the payload on failure.
	ResultCount int
	// CoverageIncomplete reports that a successful response warned results
	// may be missing (failed regions, skipped repos, truncated index) —
	// without it a degraded success is indistinguishable from a genuine
	// zero-or-low-result search. Omitted from the payload on failure.
	CoverageIncomplete bool
	// DurationMS is the wall-clock duration of the search request.
	DurationMS int64
}

type SkillInvocation struct {
	// Skill is the invoked skill's name (e.g. "entire"). Names outside the
	// official allowlist are reported as "custom".
	Skill string
	// Agent is the agent that surfaced the signal (e.g. "claude-code").
	Agent string
	// Signal is the detection signal (e.g. "prompt_slash_command",
	// "skill_tool_use").
	Signal string
	// EventType is the skill event type ("prompt_invocation" or
	// "tool_invocation").
	EventType string
}