schema

type CoreTypeDefinition struct {
	// Templates lists template IDs from the schema-level templates map that this core type can use.
	Templates []string `yaml:"templates,omitempty"`
	// DefaultTemplate selects the template ID from Templates that is applied by default.
	DefaultTemplate string `yaml:"default_template,omitempty"`
}

type FieldDefinition struct {
	Type     FieldType   `yaml:"type"`
	Required bool        `yaml:"required,omitempty"`
	Default  interface{} `yaml:"default,omitempty"`
	Values   []string    `yaml:"values,omitempty"` // For enum types
	Target   string      `yaml:"target,omitempty"` // For ref types
	// Description provides optional context for humans/agents about this field.
	Description string   `yaml:"description,omitempty"`
	Min         *float64 `yaml:"min,omitempty"`        // For number types
	Max         *float64 `yaml:"max,omitempty"`        // For number types
	Derived     string   `yaml:"derived,omitempty"`    // How to compute value
	Positional  bool     `yaml:"positional,omitempty"` // For traits: positional argument
}

type FieldType string

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

type LoadResult struct {
	Schema   *Schema
	Warnings []SchemaWarning
}

type Schema struct {
	Version   int                            `yaml:"version,omitempty"` // Schema format version
	Types     map[string]*TypeDefinition     `yaml:"types"`
	Core      map[string]*CoreTypeDefinition `yaml:"core,omitempty"`
	Traits    map[string]*TraitDefinition    `yaml:"traits"`
	Templates map[string]*TemplateDefinition `yaml:"templates,omitempty"`
}

type SchemaWarning struct {
	Message string
}

type TemplateDefinition struct {
	// File is the template file path under directories.template (e.g., "templates/interview/technical.md").
	File string `yaml:"file"`
	// Description provides optional context for humans/agents.
	Description string `yaml:"description,omitempty"`
}

type TraitDefinition struct {
	// Type is the value type (date, enum, string, boolean, etc.)
	// If empty or "boolean", the trait is a marker with no value.
	Type FieldType `yaml:"type,omitempty"`

	// Values lists valid values for enum types.
	Values []string `yaml:"values,omitempty"`

	// Default is the default value if none provided.
	Default interface{} `yaml:"default,omitempty"`
}

type TypeDefinition struct {
	Fields      map[string]*FieldDefinition `yaml:"fields"`
	DefaultPath string                      `yaml:"default_path,omitempty"`
	// Description provides optional context for humans/agents about this type's purpose.
	Description string `yaml:"description,omitempty"`
	// NameField specifies which field serves as the display name for this type.
	// When set, the title argument to `rvn new` will auto-populate this field.
	// The field must be a string type. If the field doesn't exist, it will be
	// auto-created as a required string field.
	NameField string `yaml:"name_field,omitempty"`
	// Template is a path to a template file (e.g., "templates/meeting.md").
	// Deprecated: use Schema.Templates + TypeDefinition.Templates + DefaultTemplate.
	Template string `yaml:"template,omitempty"`
	// Templates lists template IDs from the schema-level templates map that this type can use.
	Templates []string `yaml:"templates,omitempty"`
	// DefaultTemplate selects the template ID from Templates that is applied by default.
	// If empty, object creation proceeds without a template unless explicitly selected.
	DefaultTemplate string `yaml:"default_template,omitempty"`
}

type ValidationError struct {
	Field   string
	Message string
}