logging

type Logger interface {
	Debug(msg string, fields ...zapcore.Field)
	Info(msg string, fields ...zapcore.Field)
	Warn(msg string, fields ...zapcore.Field)
	Error(msg string, fields ...zapcore.Field)
	Github(msg string) // Prints only when running in GitHub Actions
	With(fields ...zapcore.Field) Logger

	// Scope returns a Logger with a path prefix for StartStep calls.
	// Scopes can be nested: logger.Scope("A").Scope("B").StartStep("C")
	// produces path ["A", "B", "C"] in the workflow tracking UI.
	Scope(name string) Logger

	// StartStep starts a trackable progress step.
	// The step appears as "pending" until Succeed/Fail/Skip is called.
	// Path is formed by: [scope prefix...] + msg
	StartStep(msg string) Step
}

type OnWarningLogged func(err error)

type Step interface {
	Succeed()
	Fail()
	Skip()
}

type StepStatus string

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

type ZapLogger struct {
	*zap.Logger
	// contains filtered or unexported fields
}