config

type Anthropic struct {
	APIKey    string `yaml:"api_key"`
	BaseURL   string `yaml:"base_url"`
	ChatModel string `yaml:"chat_model"`
}

type Briefing struct {
	// ConstraintMaxFull is how many top-ranked constraints render as full
	// "- name: description" bullets in the Constraints section; the rest
	// collapse into one compact "+N more, equally binding" line that still
	// names every one. 0 disables the tiering (every constraint renders full,
	// the legacy behavior).
	ConstraintMaxFull int `yaml:"constraint_max_full" json:"constraintMaxFull"`
	// ConventionMaxFull is how many top-ranked conventions render as full
	// bullets in the budget-competing Conventions section; the rest stay
	// behind the section's count line ("recall kind=convention"). Starred
	// conventions always render full past the cap. 0 disables the tiering
	// (every convention renders full), matching ConstraintMaxFull semantics.
	ConventionMaxFull int `yaml:"convention_max_full" json:"conventionMaxFull"`
	// MemoryMaxAgeDays drops memory-index lines not updated within this many
	// days. 0 = no recency filter. Constraints and stages are exempt.
	MemoryMaxAgeDays int `yaml:"memory_max_age_days" json:"memoryMaxAgeDays"`
	// MemoryMaxItems caps the memory-index line count before budget packing.
	// 0 = budget-only (no cap).
	MemoryMaxItems int `yaml:"memory_max_items" json:"memoryMaxItems"`
	// FindingsCount is how many recent findings to inject. 0 hides the section.
	FindingsCount int `yaml:"findings_count" json:"findingsCount"`
	// FindingsMaxAgeDays drops findings older than this many days. 0 = no filter.
	FindingsMaxAgeDays int `yaml:"findings_max_age_days" json:"findingsMaxAgeDays"`
	// ReadyTasksShown is how many ready-task titles the ready line names.
	// 0 hides the line entirely.
	ReadyTasksShown int `yaml:"ready_tasks_shown" json:"readyTasksShown"`
	// PendingPlanMaxDays is how far back captured-but-unapproved Claude Code
	// plans earn "awaiting approval" lines. 0 = no age cutoff.
	PendingPlanMaxDays int `yaml:"pending_plan_max_days" json:"pendingPlanMaxDays"`
	// StageUnknownMaxAgeDays is the grace window (days since last update) a
	// stage memory stays pinned when its Status header is missing or not a live
	// gate (open/in_progress/blocked). Past it the stage leaves the briefing --
	// recall still finds it. 0 = pin forever (the historical behavior).
	StageUnknownMaxAgeDays int `yaml:"stage_unknown_max_age_days" json:"stageUnknownMaxAgeDays"`
	// HardCapMultiplier times budgets.max_briefing_tokens is the absolute
	// truncation ceiling. 0 falls back to 2.
	HardCapMultiplier int `yaml:"hard_cap_multiplier" json:"hardCapMultiplier"`
	// IncludeParentMemories folds a shared parent project's active memories
	// into a child project's briefing (the historical automatic behavior).
	IncludeParentMemories bool `yaml:"include_parent_memories" json:"includeParentMemories"`
	// SiblingFindingsCount is how many recent findings from family-member
	// projects to inject. 0 hides the section.
	SiblingFindingsCount int `yaml:"sibling_findings_count" json:"siblingFindingsCount"`
	// IncludeSiblingMemories folds family-member projects' active memories
	// (constraints and stages excluded) into the briefing as a low-priority
	// "Sibling memories" section. Off by default to avoid crowding.
	IncludeSiblingMemories bool `yaml:"include_sibling_memories" json:"includeSiblingMemories"`
	// UtilityWeight is utility's share of the briefing memory-index sort key:
	// (1-w)*recency + w*utility, both half-life-decayed to [0,1). 0 = pure
	// recency (the legacy order); constraints, stages, and favorites are pinned
	// regardless. Applies only where utility ranking is active (UtilityMode).
	UtilityWeight float64 `yaml:"utility_weight" json:"utilityWeight"`
	// UtilityMode gates the briefing's utility re-ordering: "auto" (default)
	// activates per project once the gardener's readiness latch trips, "on"
	// activates everywhere immediately, "off" disables it everywhere. The
	// bounded recall/prompt-recall boosts are not gated by this.
	UtilityMode string `yaml:"utility_mode" json:"utilityMode"`
}

type BriefingPreset struct {
	// Key is the stable identifier ("lean", "balanced", "rich").
	Key string
	// Label is the owner-facing name.
	Label string
	// Intent is one line saying who the preset is for.
	Intent string
	// Briefing is the full recipe.
	Briefing Briefing
}

type Budgets struct {
	MaxBriefingTokens  int `yaml:"max_briefing_tokens"`
	RecallBudgetTokens int `yaml:"recall_budget_tokens"`
	// ToolEventMaxChars caps each captured field (tool-call args value, result,
	// hook prompt, session findings) of an Interactions transport event at this
	// many runes. 0 = unlimited (the default): content is stored in full, and the
	// tool-event retention prune -- not truncation -- is the growth control.
	ToolEventMaxChars int `yaml:"tool_event_max_chars"`
}

type Capture struct {
	// AllowedPorts are the only destination ports capture_url may dial, enforced
	// on the initial URL and on every redirect hop. Empty is deliberately NOT
	// "any port": an unset key, an explicit `allowed_ports: []`, or an empty env
	// override all fall back to the 80/443 default, so the SSRF port guard cannot
	// be switched off by omission. Ports outside 1-65535 are rejected by Validate.
	AllowedPorts []int `yaml:"allowed_ports"`
}

type Config struct {
	// Addr is the HTTP bind address (host:port). Defaults to 127.0.0.1:8081.
	Addr string `yaml:"addr"`
	// DataDir holds the SQLite database and markdown trees. A leading ~ expands.
	DataDir string `yaml:"data_dir"`
	// Role is this install's part in a deployment: RoleServer (the default) runs
	// the daemon here; RoleClient runs none and dials AdvertisedURL instead.
	// Read it through IsClient, never by comparing this string.
	Role string `yaml:"role"`
	// AdvertisedURL is the base URL clients dial (yaml key `server_url`). Empty
	// means "derive it from Addr", which is what a loopback install wants. Set
	// it when the bind address is not the address clients use -- a wildcard
	// bind, a LAN name, a TLS listener. Read it through ServerURL, which applies
	// that derivation; this field is the raw configured value.
	AdvertisedURL string `yaml:"server_url"`
	// AllowedHosts are EXTRA Host-header values the daemon answers to, beyond
	// the loopback names, the concrete bind host, and ServerHost. Naming even
	// one turns the Host allowlist on for a wildcard bind (see hostGuard).
	AllowedHosts []string `yaml:"allowed_hosts"`
	// TLS makes the listener HTTPS and tells the CLI which root CA to trust.
	TLS TLS `yaml:"tls"`

	MCP         MCP         `yaml:"mcp"`
	Budgets     Budgets     `yaml:"budgets"`
	Briefing    Briefing    `yaml:"briefing"`
	Features    Features    `yaml:"features"`
	Console     Console     `yaml:"console"`
	Search      Search      `yaml:"search"`
	LLM         LLM         `yaml:"llm"`
	Gardener    Gardener    `yaml:"gardener"`
	Capture     Capture     `yaml:"capture"`
	PlanCapture PlanCapture `yaml:"plan_capture"`
	// contains filtered or unexported fields
}

type Console struct {
	// Level is how much of the console the owner sees: "basic" (the fewest
	// screens and knobs -- the default for a fresh installation), "standard"
	// (adds the coordination screens: tasks, plans, projects, the fleet view),
	// or "advanced" (every screen and knob, including the analytics and the
	// raw transport). Hidden screens stay reachable by URL; nothing is locked.
	// Empty means the default. An installation upgraded with sessions already
	// recorded is seeded "advanced" by a one-time store migration, so an
	// upgrade never hides a screen someone was using.
	Level string `yaml:"level" json:"level"`
}

type Features struct {
	// Research enables research labs and trials: the Labs and Trials console
	// screens, the trials search scope, and the lab_open, trial_record, and
	// trial_query MCP tools.
	Research bool `yaml:"research" json:"research"`
	// Momentum enables the gentle momentum surfaces woven into existing
	// screens: the plan finish-line card on Overview and its briefing
	// emphasis, the activity calendar with capture streaks, knowledge payoff
	// moments, and project maturity stages.
	Momentum bool `yaml:"momentum" json:"momentum"`
	// Gamification enables the arcade layer of the Now screen: the day tape,
	// the personal-records rail, the hot-streak pulse, and the celebration
	// moments.
	Gamification bool `yaml:"gamification" json:"gamification"`
}

type Gardener struct {
	Enabled bool `yaml:"enabled"`
	// IntervalMinutes is the ticker period between full gardener passes.
	IntervalMinutes int `yaml:"interval_minutes"`
	// DedupThreshold is the cosine-similarity floor at/above which two active
	// memories are proposed for a merge.
	DedupThreshold float64 `yaml:"dedup_threshold"`
	// StalenessDays is the no-activity age (no update, injection, or read) beyond
	// which an active memory is proposed for archiving.
	StalenessDays int `yaml:"staleness_days"`
	// DigestDays is the trailing window of completed sessions rolled into a
	// monthly digest proposal.
	DigestDays int `yaml:"digest_days"`
	// ToolEventRetentionDays is the age beyond which transport-level Interactions
	// events (tool.call, hook.prompt) are pruned by the gardener. 0 disables the
	// prune; domain events are never pruned regardless.
	ToolEventRetentionDays int `yaml:"tool_event_retention_days"`
	// StalePlanDays is the age beyond which a captured, never-approved Claude
	// Code plan (plan-status draft/presented) is proposed for abandonment.
	// 0 disables the pass.
	StalePlanDays int `yaml:"stale_plan_days"`
	// StaleStageDays is the age (days since last update) beyond which a stage
	// memory that is not a live gate -- Status done, missing, or unrecognized --
	// is proposed for archiving. Live gates (open/in_progress/blocked) are never
	// proposed regardless of age. 0 disables the pass.
	StaleStageDays int `yaml:"stale_stage_days"`
	// SessionIdleMinutes is the no-activity age beyond which an active session
	// is considered dead: the gardener reaper expires it and the console stops
	// counting it as live. It is the single liveness threshold shared by both,
	// so the reaper cutoff and the console "live" window never drift.
	// Must be positive. The fully resolved config already supplies 45 when the
	// key is absent, so zero is an explicit invalid value rather than a second,
	// silent spelling of the default.
	SessionIdleMinutes int `yaml:"session_idle_minutes"`
}

type LLM struct {
	Provider  string    `yaml:"provider"`
	OpenAI    OpenAI    `yaml:"openai"`
	Ollama    Ollama    `yaml:"ollama"`
	Anthropic Anthropic `yaml:"anthropic"`
}

type MCP struct {
	APIKey string `yaml:"api_key"`
}

type Ollama struct {
	BaseURL        string `yaml:"base_url"`
	ChatModel      string `yaml:"chat_model"`
	EmbeddingModel string `yaml:"embedding_model"`
	EmbeddingDims  int    `yaml:"embedding_dims"`
}

type OpenAI struct {
	APIKey         string `yaml:"api_key"`
	BaseURL        string `yaml:"base_url"`
	ChatModel      string `yaml:"chat_model"`
	EmbeddingModel string `yaml:"embedding_model"`
	// EmbeddingDims is the model's native dimensionality; 0 = auto-detect from
	// the first embedding response.
	EmbeddingDims int `yaml:"embedding_dims"`
}

type PlanCapture struct {
	// Enabled turns the plan-capture hook endpoints into no-ops when false.
	Enabled bool `yaml:"enabled"`
	// AutoTask creates a tracking task ("Implement plan: ...") when a plan is
	// approved, composing it into the plan via plan_slug.
	AutoTask bool `yaml:"auto_task"`
	// InjectRelated returns related prior plans/memories as additionalContext on
	// a session's first captured plan iteration.
	InjectRelated bool `yaml:"inject_related"`
}

type Search struct {
	// SemanticFloor is the minimum cosine similarity a semantic-only hit needs
	// to appear in search results; hits the lexical leg also matched are exempt.
	// Without it the cosine leg is pure nearest-neighbor -- there is always a
	// "nearest" item, so any query fills the page. 0 disables the floor. Useful
	// values depend on the embedding model; the default suits OpenAI
	// text-embedding-3-*.
	SemanticFloor float64 `yaml:"semantic_floor"`
}

type TLS struct {
	// CertFile is the PEM certificate chain the daemon serves. A leading ~ expands.
	CertFile string `yaml:"cert_file"`
	// KeyFile is the PEM private key for CertFile. A leading ~ expands.
	KeyFile string `yaml:"key_file"`
	// CAFile is an extra root CA the seam CLI trusts when dialing an https
	// server_url. A leading ~ expands.
	CAFile string `yaml:"ca_file"`
}