observability

type AnalysisMetrics struct {
	// contains filtered or unexported fields
}

type AnalysisStats struct {
	Commits         int64
	Chunks          int
	ChunkDurations  []time.Duration
	BlobCacheHits   int64
	BlobCacheMisses int64
	DiffCacheHits   int64
	DiffCacheMisses int64
}

type AppMode string

type Config struct {
	// ServiceName is the OTel resource service name.
	ServiceName string

	// ServiceVersion is the semantic version of the running binary.
	ServiceVersion string

	// Environment is the deployment environment (e.g. "production", "staging", "dev").
	Environment string

	// Mode identifies how the binary was launched.
	Mode AppMode

	// OTLPEndpoint is the OTLP gRPC collector address (e.g. "localhost:4317").
	// Empty disables export; providers become no-op.
	OTLPEndpoint string

	// OTLPHeaders are additional gRPC metadata headers for the OTLP exporter.
	OTLPHeaders map[string]string

	// OTLPInsecure disables TLS for the OTLP gRPC connection.
	OTLPInsecure bool

	// DebugTrace forces 100% trace sampling when true.
	DebugTrace bool

	// SampleRatio is the trace sampling ratio (0.0 to 1.0) when DebugTrace is false.
	// Zero uses the OTel SDK default (parent-based with always-on root).
	SampleRatio float64

	// LogLevel controls the minimum slog severity.
	LogLevel slog.Level

	// TraceVerbose enables hot-path spans (per-commit, per-file, per-git-op).
	// When false (default), only structural pipeline spans are recorded.
	TraceVerbose bool

	// LogJSON enables JSON-formatted log output.
	LogJSON bool

	// ShutdownTimeoutSec is the maximum seconds to wait for flush on shutdown.
	ShutdownTimeoutSec int
}

type DiagnosticsServer struct {
	// contains filtered or unexported fields
}

type HeapSnapshot struct {
	HeapInuse   int64
	HeapAlloc   int64
	HeapObjects int64 // Live heap objects (detect accumulation).
	StackInuse  int64 // Stack memory (goroutine stacks).
	NextGC      int64 // Target heap size for next GC cycle.
	Sys         int64 // Total bytes obtained from the OS (Go runtime).
	RSS         int64 // Resident set size (Go + native C memory).
	NumGC       uint32
	Goroutines  int // Number of goroutines.
	TakenAtNS   int64
}

type Providers struct {
	// Tracer is the named tracer for creating spans.
	Tracer trace.Tracer

	// Meter is the named meter for creating instruments.
	Meter metric.Meter

	// Logger is the context-aware structured logger.
	Logger *slog.Logger

	// Shutdown flushes all pending telemetry and releases resources.
	// Must be called before process exit.
	Shutdown func(ctx context.Context) error
}

type REDMetrics struct {
	// contains filtered or unexported fields
}

type ReadyCheck func(ctx context.Context) error

type SchedulerMetrics struct {
	// contains filtered or unexported fields
}

type SmapsRollup struct {
	Rss          int64
	Pss          int64
	Anonymous    int64
	FileBacked   int64 // Computed: Rss - Anonymous.
	SharedClean  int64
	SharedDirty  int64
	PrivateClean int64
	PrivateDirty int64
}

type TracingHandler struct {
	// contains filtered or unexported fields
}