config

type Config struct {
	LogLevel  string
	LogFormat string
	Offline   bool
	NoCache   bool
	Jobs      int
	// Repositories are the known skill repositories an unscoped `find` searches
	// (FR-038). Configured in a config file (TOML array) or via
	// GSKILL_REPOSITORIES (comma-separated).
	Repositories []string
	// StoreLockTimeout bounds how long a contended project mutate lock is
	// waited on before failing. (The key name predates spec 022 and is kept
	// unchanged so existing configs keep working.)
	StoreLockTimeout time.Duration
}

type Sources struct {
	// Defaults seeds the lowest layer. When nil, DefaultMap is used.
	Defaults map[string]any
	// UserFile and ProjectFile are optional TOML config paths. A missing file
	// is skipped without error, which is right for a path this package
	// discovered on the caller's behalf — absence is the normal case.
	//
	// RequireUserFile reverses that for UserFile alone: a path the *user*
	// named (gskill --config) is a statement of intent, so a missing one is an
	// error rather than a silent no-op (spec 026 FR-003). ProjectFile has no
	// equivalent because nothing names it explicitly.
	UserFile        string
	RequireUserFile bool
	ProjectFile     string
	// ProjectMap is the project layer supplied in memory rather than as a
	// file: skills.toml holds project configuration inside its [config] table
	// alongside skill declarations, so the manifest hands over just that
	// sub-table (spec 023 FR-002). It shares the project layer's precedence
	// slot with ProjectFile — above the user file, below environment and flags.
	ProjectMap map[string]any
	// Environ is a list of "KEY=VALUE" entries (as from os.Environ); only
	// GSKILL_-prefixed entries are consulted. When nil, the process environment
	// is used.
	Environ []string
	// Flags is the highest-precedence layer of explicitly set flag values.
	Flags map[string]any
}