config

type Config struct {
	Server      ServerConfig       `yaml:"server"`
	Storage     StorageConfig      `yaml:"storage"`
	Embedder    EmbedderConfig     `yaml:"embedder"`
	VectorIndex VectorIndexConfig  `yaml:"vector_index"`
	Memory      MemoryConfig       `yaml:"memory"`
	Tenant      TenantSchemaConfig `yaml:"tenant"`
}

type DecayConfig struct {
	NodeLambda            float64 `yaml:"node_lambda"`
	EdgeStructuralLambda  float64 `yaml:"edge_structural_lambda"`
	EdgeCoRetrievalLambda float64 `yaml:"edge_coretrieval_lambda"`
	EdgeCoTraversalLambda float64 `yaml:"edge_cotraversal_lambda"`
}

type EmbedderConfig struct {
	Backend string             `yaml:"backend"`
	Gemini  GeminiConfig       `yaml:"gemini"`
	Fake    FakeEmbedderConfig `yaml:"fake"`
}

type FakeEmbedderConfig struct {
	Dim int `yaml:"dim"`
}

type GeminiConfig struct {
	Model       string `yaml:"model"`
	APIKey      string `yaml:"api_key"`
	Dim         int    `yaml:"dim"`
	Concurrency int    `yaml:"concurrency"`
}

type MemoryConfig struct {
	ChunkWindowSize       int           `yaml:"chunk_window_size"`
	ChunkStride           int           `yaml:"chunk_stride"`
	RetrievalK            int           `yaml:"retrieval_k"`
	RetrievalHops         int           `yaml:"retrieval_hops"`
	RetrievalOversample   int           `yaml:"retrieval_oversample"`
	StructuralRecentN     int           `yaml:"structural_recent_n"`
	StructuralRecentDelta time.Duration `yaml:"structural_recent_delta"`

	// RefractoryPeriod blocks repeated explicit Reinforce/Demote/Mark
	// bumps on the same node within the window. Implicit Recall
	// co-retrieval bumps are NOT throttled. Set to 0 to disable.
	RefractoryPeriod time.Duration `yaml:"refractory_period"`

	// LogDampening scales positive Reinforce/Mark deltas by
	// (1 - weight/WeightCap), so saturation is asymptotic instead of a
	// hard wall. Demote is unaffected.
	LogDampening bool `yaml:"log_dampening"`

	// MarkMaxNodes caps the number of recent nodes a single Mark call
	// will walk.
	MarkMaxNodes int `yaml:"mark_max_nodes"`

	Scoring   ScoringConfig   `yaml:"scoring"`
	Decay     DecayConfig     `yaml:"decay"`
	Reinforce ReinforceConfig `yaml:"reinforce"`
	Prune     PruneConfig     `yaml:"prune"`
	WeightCap float64         `yaml:"weight_cap"`
}

type Neo4jStorageConfig struct {
	URI            string        `yaml:"uri"`
	User           string        `yaml:"user"`
	Password       string        `yaml:"password"` // ${ENV_VAR} expansion supported
	Database       string        `yaml:"database"`
	ConnectTimeout time.Duration `yaml:"connect_timeout"`
}

type PruneConfig struct {
	EdgeFloor float64 `yaml:"edge_floor"`
	NodeFloor float64 `yaml:"node_floor"`
}

type ReinforceConfig struct {
	NodeDelta                    float64 `yaml:"node_delta"`
	EdgeCoRetrievalBase          float64 `yaml:"edge_coretrieval_base"`
	EdgeCoTraversalMultiplier    float64 `yaml:"edge_cotraversal_multiplier"`
	EdgeStructuralWeight         float64 `yaml:"edge_structural_weight"`
	EdgeStructuralTemporalWeight float64 `yaml:"edge_structural_temporal_weight"`
}

type ScoringConfig struct {
	SimAlpha   float64 `yaml:"sim_alpha"`
	WeightBeta float64 `yaml:"weight_beta"`
}

type ServerConfig struct {
	Transports map[string]TransportConfig `yaml:"transports"`
}

type StorageConfig struct {
	Backend string             `yaml:"backend"`
	Neo4j   Neo4jStorageConfig `yaml:"neo4j"`
}

type TenantKeyConfig struct {
	Description string   `yaml:"description"`
	Pattern     string   `yaml:"pattern"`
	Enum        []string `yaml:"enum"`
	Required    bool     `yaml:"required"`
}

type TenantSchemaConfig struct {
	Description string                     `yaml:"description"`
	Keys        map[string]TenantKeyConfig `yaml:"keys"`
	OneOf       [][]string                 `yaml:"one_of"`
}

type TransportConfig struct {
	Enabled bool   `yaml:"enabled"`
	Addr    string `yaml:"addr"`
}

type VectorIndexConfig struct {
	// FlatScanThreshold is the per-tenant size below which Recall uses
	// a Cypher flat scan instead of the native vector index. Neo4j's
	// vector index has no exposed HNSW knobs; tuning it requires DDL
	// on the index itself (see DESIGN.md §13.1).
	FlatScanThreshold int `yaml:"flat_scan_threshold"`
}