config

type BlockTypeConfig struct {
	// RequiredFields lists field names that must be present in block.Data.
	RequiredFields []string `yaml:"required_fields" json:"required_fields"`
	// OptionalFields lists additional allowed fields for the block type.
	OptionalFields []string `yaml:"optional_fields,omitempty" json:"optional_fields,omitempty"`
	// Fields defines typed field definitions with constraints.
	// When set, provides type checking, enum validation, and required enforcement.
	Fields map[string]FieldDef `yaml:"fields,omitempty" json:"fields,omitempty"`
}

type Config struct {
	// ProjectName is the name of the game design project.
	ProjectName string `yaml:"project_name" json:"project_name"`

	// NodesPath is the directory path where node YAML files are stored.
	// Defaults to ".deco/nodes".
	NodesPath string `yaml:"nodes_path" json:"nodes_path"`

	// HistoryPath is the file path for the append-only audit log.
	// Defaults to ".deco/history.jsonl".
	HistoryPath string `yaml:"history_path" json:"history_path"`

	// Version is the config file format version.
	Version int `yaml:"version" json:"version"`

	// RequiredApprovals is the number of approvals needed for a node to be approved.
	// Defaults to 1.
	RequiredApprovals int `yaml:"required_approvals" json:"required_approvals"`

	// CustomBlockTypes defines additional block types beyond the built-in ones.
	// Keys are type names, values define validation rules.
	CustomBlockTypes map[string]BlockTypeConfig `yaml:"custom_block_types,omitempty" json:"custom_block_types,omitempty"`

	// SchemaRules defines per-kind validation rules for nodes.
	// Keys are kind names (e.g., "character", "quest"), values define required fields.
	SchemaRules map[string]SchemaRuleConfig `yaml:"schema_rules,omitempty" json:"schema_rules,omitempty"`

	// SchemaVersion is a hash of the schema configuration (CustomBlockTypes + SchemaRules).
	// Used to detect when schema changes require migration.
	SchemaVersion string `yaml:"schema_version,omitempty" json:"schema_version,omitempty"`

	// Custom allows projects to add arbitrary configuration fields.
	Custom map[string]interface{} `yaml:"custom,omitempty" json:"custom,omitempty"`
}

type FieldDef struct {
	Type     string          `yaml:"type" json:"type"`                     // string, number, list, bool
	Required bool            `yaml:"required" json:"required"`             // whether the field must be present
	Enum     []string        `yaml:"enum,omitempty" json:"enum,omitempty"` // allowed values (for string fields)
	Refs     []RefConstraint `yaml:"refs,omitempty" json:"refs,omitempty"` // cross-reference constraints (OR logic)
}

type RefConstraint struct {
	BlockType string `yaml:"block_type" json:"block_type"` // the referenced block type
	Field     string `yaml:"field" json:"field"`           // the field name to match against
}

type Repository interface {
	// Load reads the project configuration from storage.
	// Returns the config or an error if not found or invalid.
	Load() (Config, error)

	// Save writes the project configuration to storage.
	Save(config Config) error
}

type SchemaRuleConfig struct {
	// RequiredFields lists field names that must be present in the node's custom data.
	RequiredFields []string `yaml:"required_fields" json:"required_fields"`
}

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