spec

type Category string

type ConfigSpec struct {
	// Version is the spec version (semver)
	Version string `json:"version"`

	// NodeVersion is the luxd version this spec was generated from
	NodeVersion string `json:"node_version"`

	// GeneratedAt is when this spec was generated (RFC3339)
	GeneratedAt string `json:"generated_at"`

	// Flags contains all flag specifications
	Flags []FlagSpec `json:"flags"`

	// Categories lists all categories with descriptions
	Categories map[Category]string `json:"categories"`
}

type Constraints struct {
	// Min is the minimum value (for numeric types)
	Min interface{} `json:"min,omitempty"`

	// Max is the maximum value (for numeric types)
	Max interface{} `json:"max,omitempty"`

	// Enum lists allowed values (for string types)
	Enum []string `json:"enum,omitempty"`

	// Pattern is a regex pattern (for string types)
	Pattern string `json:"pattern,omitempty"`

	// RequiredWith lists flags that must also be set
	RequiredWith []string `json:"required_with,omitempty"`

	// ConflictsWith lists flags that cannot be set together
	ConflictsWith []string `json:"conflicts_with,omitempty"`
}

type FlagSpec struct {
	// Key is the flag name (e.g., "network-id", "log-level")
	Key string `json:"key"`

	// Type is the flag's data type
	Type FlagType `json:"type"`

	// Default is the default value (nil if no default)
	Default interface{} `json:"default,omitempty"`

	// Description is the human-readable documentation
	Description string `json:"description"`

	// Category groups related flags for organization
	Category Category `json:"category"`

	// Deprecated indicates if this flag is deprecated
	Deprecated bool `json:"deprecated,omitempty"`

	// DeprecatedMessage explains what to use instead
	DeprecatedMessage string `json:"deprecated_message,omitempty"`

	// ReplacedBy is the key of the replacement flag (if deprecated)
	ReplacedBy string `json:"replaced_by,omitempty"`

	// Required indicates if this flag must be explicitly set
	Required bool `json:"required,omitempty"`

	// Sensitive indicates if the value should be masked in logs
	Sensitive bool `json:"sensitive,omitempty"`

	// Constraints contains validation rules
	Constraints *Constraints `json:"constraints,omitempty"`

	// Since indicates when this flag was introduced (version string)
	Since string `json:"since,omitempty"`
}

type FlagType string