scout

type AdoptionCommandStats struct {
	Command string `json:"command"`
	Total   int    `json:"total"`
	Success int    `json:"success"`
	Failure int    `json:"failure"`
}

type AdoptionMilestoneStatus struct {
	Name     string `json:"name"`
	Achieved bool   `json:"achieved"`
}

type AdoptionReport struct {
	SchemaID           string                       `json:"schema_id"`
	SchemaVersion      string                       `json:"schema_version"`
	CreatedAt          time.Time                    `json:"created_at"`
	ProducerVersion    string                       `json:"producer_version"`
	Source             string                       `json:"source"`
	TotalEvents        int                          `json:"total_events"`
	SuccessEvents      int                          `json:"success_events"`
	FailedEvents       int                          `json:"failed_events"`
	FirstEventAt       time.Time                    `json:"first_event_at,omitempty"`
	LastEventAt        time.Time                    `json:"last_event_at,omitempty"`
	Commands           []AdoptionCommandStats       `json:"commands"`
	Milestones         []AdoptionMilestoneStatus    `json:"milestones"`
	ActivationTimingMS map[string]int64             `json:"activation_timing_ms,omitempty"`
	ActivationMedians  map[string]int64             `json:"activation_medians_ms,omitempty"`
	SkillWorkflows     []AdoptionSkillWorkflowStats `json:"skill_workflows,omitempty"`
	ActivationComplete bool                         `json:"activation_complete"`
	Blockers           []string                     `json:"blockers,omitempty"`
}

type AdoptionSkillWorkflowStats struct {
	Workflow              string  `json:"workflow"`
	Total                 int     `json:"total"`
	Success               int     `json:"success"`
	Failure               int     `json:"failure"`
	SuccessRate           float64 `json:"success_rate"`
	MedianRuntimeMS       int64   `json:"median_runtime_ms"`
	MostCommonFailureCode int     `json:"most_common_failure_code,omitempty"`
}

type CoverageReport struct {
	SnapshotID             string   `json:"snapshot_id"`
	DiscoveredTools        int      `json:"discovered_tools"`
	GatedTools             int      `json:"gated_tools"`
	HighRiskUngatedTools   int      `json:"high_risk_ungated_tools"`
	CoveragePercent        float64  `json:"coverage_percent"`
	PolicyDigests          []string `json:"policy_digests,omitempty"`
	DiscoveredToolNames    []string `json:"discovered_tool_names,omitempty"`
	GatedToolNames         []string `json:"gated_tool_names,omitempty"`
	HighRiskUngatedToolIDs []string `json:"high_risk_ungated_tool_ids,omitempty"`
}

type DefaultProvider struct {
	Options SnapshotOptions
}

type DiffChange struct {
	ID              string `json:"id"`
	Kind            string `json:"kind"`
	Name            string `json:"name"`
	BeforeLocator   string `json:"before_locator"`
	AfterLocator    string `json:"after_locator"`
	BeforeRiskLevel string `json:"before_risk_level,omitempty"`
	AfterRiskLevel  string `json:"after_risk_level,omitempty"`
}

type DiffItem struct {
	ID        string `json:"id"`
	Kind      string `json:"kind"`
	Name      string `json:"name"`
	Locator   string `json:"locator"`
	RiskLevel string `json:"risk_level,omitempty"`
}

type InventoryProvider interface {
	Snapshot(context.Context, SnapshotRequest) (schemascout.InventorySnapshot, error)
}

type SignalInput struct {
	RunpackPaths []string
	TracePaths   []string
	RegressPaths []string
}

type SignalOptions struct {
	ProducerVersion string
	Now             time.Time
}

type SnapshotDiff struct {
	LeftSnapshotID  string       `json:"left_snapshot_id"`
	RightSnapshotID string       `json:"right_snapshot_id"`
	Added           []DiffItem   `json:"added,omitempty"`
	Removed         []DiffItem   `json:"removed,omitempty"`
	Changed         []DiffChange `json:"changed,omitempty"`
	AddedCount      int          `json:"added_count"`
	RemovedCount    int          `json:"removed_count"`
	ChangedCount    int          `json:"changed_count"`
}

type SnapshotOptions struct {
	ProducerVersion string
	Now             time.Time
}

type SnapshotRequest struct {
	Roots   []string
	Include []string
	Exclude []string
}

type TopAction struct {
	Rank           int      `json:"rank"`
	Score          int      `json:"score"`
	ToolClass      string   `json:"tool_class"`
	BlastRadius    int      `json:"blast_radius"`
	RunID          string   `json:"run_id"`
	IntentID       string   `json:"intent_id,omitempty"`
	IntentDigest   string   `json:"intent_digest,omitempty"`
	TraceID        string   `json:"trace_id,omitempty"`
	ToolName       string   `json:"tool_name"`
	Verdict        string   `json:"verdict,omitempty"`
	ReasonCodes    []string `json:"reason_codes,omitempty"`
	SourceType     string   `json:"source_type"`
	SourceArtifact string   `json:"source_artifact"`
}

type TopActionsInput struct {
	RunpackPaths []string
	TracePaths   []string
	Limit        int
}

type TopActionsOptions struct {
	ProducerVersion string
	Now             time.Time
}

type TopActionsReport struct {
	SchemaID        string      `json:"schema_id"`
	SchemaVersion   string      `json:"schema_version"`
	CreatedAt       time.Time   `json:"created_at"`
	ProducerVersion string      `json:"producer_version"`
	RunCount        int         `json:"run_count"`
	TraceCount      int         `json:"trace_count"`
	ActionCount     int         `json:"action_count"`
	TopActions      []TopAction `json:"top_actions"`
}