core

type Adapter any

type Authenticator interface {
	Login(ctx context.Context) error
}

type Browser interface {
	Lister
	Describer
}

type Builder interface {
	Build(ctx context.Context, in ...string) error // create or first-time apply
}

type Configurable interface {
	ConfigPtr() any
}

type Configurer interface {
	Configure(ctx context.Context) error // idempotent environment setup
}

type Contextual interface {
	SetContext(path string) // idempotent environment setup
}

type Creater interface {
	Create(ctx context.Context, in ...string) error // create or first-time apply
}

type Deleter interface {
	Delete(ctx context.Context, in ...string) error // remove everything
}

type DepRef struct {
	Adapter string   `json:"adapter"`        // required
	Name    string   `json:"name,omitempty"` // fallback on config name
	Args    []string `json:"args,omitempty"` // extra CLI-style args

}

type Depender interface {
	AddDependency(name string, adapter Adapter)
}

type Describer interface {
	Describe(ctx context.Context, name string) (string, error)
}

type Downloader interface {
	Download(ctx context.Context, in ...string) error
}

type Executor interface {
	Run(ctx context.Context, name string, args ...string) error
	Output(ctx context.Context, name string, args ...string) ([]byte, error)
}

type FileSystem interface {
	WalkDir(root string, fn fs.WalkDirFunc) error
	ReadFile(name string) ([]byte, error)
}

type Filter interface {
	Filter(ctx context.Context, filter string) ([]string, error)
}

type FilterOf[T any] interface {
	Filter(ctx context.Context, filter string) ([]T, error)
}

type Hydrater interface {
	Hydrate(ctx context.Context) error
}

type ItemConfigurable interface {
	ItemConfigPtr(name string) any
}

type Lifecycle interface {
	Creater
	Updater
	Deleter
}

type Lister interface {
	List(ctx context.Context) ([]string, error)
}

type ListerOf[T any] interface {
	List(ctx context.Context) ([]T, error)
}

type LogLevel int

type Logger interface {
	Debug(v ...any)
	Debugf(format string, args ...any)
	Info(v ...any)
	Infof(format string, args ...any)
	Warn(v ...any)
	Warnf(format string, args ...any)
	Error(v ...any)
	Errorf(format string, args ...any)
}

type MetaHeader struct {
	Name         string            `json:"name"` // fallback on filename
	APIVersion   string            `json:"api_version"`
	Adapter      string            `json:"adapter,omitempty"`
	Dependencies map[string]DepRef `json:"dependencies"`
	RawSpec      json.RawMessage   `json:"spec"`    // adapter-specific payload
	Context      string            `json:"context"` // project path (rel or abs)
}

type Pruner interface {
	// PruneAll(ctx context.Context) error
	Prune(ctx context.Context, filter string) error
}

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

type Reloader interface {
	Reload(ctx context.Context, in ...string) error // reload / rollout replace
}

type Runner interface {
	Starter
	Stopper
}

type SearchMap struct {
	Short map[string][]string // basename (no .json) -> []absolute paths
	Full  map[string]string   // relative/key (no .json) -> absolute path
	// contains filtered or unexported fields
}

type Starter interface {
	Start(ctx context.Context, in ...string) error // scale >0 / run
}

type Stopper interface {
	Stop(ctx context.Context, in ...string) error // scale 0 / halt
}

type Transferer interface {
	Uploader
	Downloader
}

type Updater interface {
	Update(ctx context.Context, in ...string) error // idempotent patch / rebuild
}

type Uploader interface {
	Upload(ctx context.Context, in ...string) error
}

type ZeroFactory func() Adapter