log

type Config struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// UsageError is returned when the resource name argument is missing.
	UsageError string
	// Flags is the provider's flag set (param adds --max-value-length; the
	// --number/--since/--until usage strings differ between providers).
	Flags []cli.Flag
	// NewPresenter builds the provider Presenter bound to the fetch request.
	NewPresenter func(ctx context.Context, req Request) (Presenter, error)
}

type Options struct {
	ShowPatch      bool
	ParseJSON      bool
	Reverse        bool
	NoPager        bool
	Oneline        bool
	Output         output.Format
	MaxValueLength int
}

type Presenter interface {
	// Fetch loads the version history via the provider usecase.
	Fetch(ctx context.Context) error
	// Len returns the number of versions loaded.
	Len() int
	// RenderJSON writes the provider-specific JSON array for all versions.
	RenderJSON(stdout io.Writer) error
	// RenderOneline writes the compact one-line form for version i.
	RenderOneline(stdout io.Writer, i, maxValueLength int)
	// RenderHeader writes the "Version ..." line and Date line for version i.
	RenderHeader(stdout io.Writer, i int)
	// RenderValue writes the value preview for version i (default, non-patch mode).
	// Providers without a default value preview (e.g. secrets) make this a no-op.
	RenderValue(stdout io.Writer, i, maxValueLength int)
	// RenderPatch writes the diff between version i and its neighbor (patch mode).
	RenderPatch(stdout, stderr io.Writer, i int, parseJSON, reverse bool)
}

type Request struct {
	Name       string
	MaxResults int32
	Since      *time.Time
	Until      *time.Time
	Reverse    bool
}

type Runner struct {
	Presenter Presenter
	Options   Options
	Stdout    io.Writer
	Stderr    io.Writer
}