types

type Config struct {
	LLM        LLMConfig        `yaml:"llm"`
	Extraction ExtractionConfig `yaml:"extraction"`
	UI         UIConfig         `yaml:"ui"`
	Watch      WatchConfig      `yaml:"watch"`
	Daemon     DaemonConfig     `yaml:"daemon"`
	Obsidian   ObsidianConfig   `yaml:"obsidian"`
}

type DaemonConfig struct {
	PIDFile    string `yaml:"pid_file"`
	LogFile    string `yaml:"log_file"`
	LogLevel   string `yaml:"log_level"`
	StatusFile string `yaml:"status_file"`
}

type DaemonSourceStatus struct {
	Connected  bool  `json:"connected"`
	EventCount int64 `json:"event_count"`
}

type DaemonStatus struct {
	PID       int                           `json:"pid"`
	Sources   map[string]DaemonSourceStatus `json:"sources"` // name -> status
	UpdatedAt string                        `json:"updated_at"`
}

type Edge struct {
	Source     string                 `json:"source"`
	Target     string                 `json:"target"`
	Relation   string                 `json:"relation"`        // calls, imports, uses, describes, etc.
	Confidence string                 `json:"confidence"`      // EXTRACTED, INFERRED, AMBIGUOUS
	Score      float64                `json:"score,omitempty"` // 0.0-1.0
	SourceFile string                 `json:"source_file,omitempty"`
	Metadata   map[string]interface{} `json:"metadata,omitempty"`
}

type EdgeType string

type ExtractionConfig struct {
	CodeLanguages []string `yaml:"code_languages"`
	IncludeDocs   bool     `yaml:"include_docs"`
	IncludeImages bool     `yaml:"include_images"`
	ChunkSize     int      `yaml:"chunk_size"` // tokens
	CacheDir      string   `yaml:"cache_dir"`
}

type ExtractionProgress struct {
	TotalFiles      int
	ProcessedFiles  int
	TotalChunks     int
	ProcessedChunks int
	CurrentFile     string
	CurrentChunk    int
	StartTime       time.Time
	LastUpdateTime  time.Time
}

type ExtractionResult struct {
	Nodes []Node `json:"nodes"`
	Edges []Edge `json:"edges"`
}

type ExtractorConfig struct {
	Enabled   bool   `yaml:"enabled"`
	Workers   int    `yaml:"workers"`
	WriteBack bool   `yaml:"write_back"`
	Provider  string `yaml:"provider"`
	Model     string `yaml:"model"`
}

type Graph struct {
	Nodes       []Node                 `json:"nodes"`
	Edges       []Edge                 `json:"edges"`
	Communities map[int][]string       `json:"communities"`
	Metadata    map[string]interface{} `json:"metadata"`
	ExtractedAt time.Time              `json:"extracted_at"`
}

type LLMConfig struct {
	Provider       string        `yaml:"provider"` // local, anthropic, openai
	Model          string        `yaml:"model"`
	Endpoint       string        `yaml:"endpoint"` // for local providers
	APIKey         string        `yaml:"api_key"`  // for remote providers
	Timeout        time.Duration `yaml:"timeout"`
	MaxChunkTokens int           `yaml:"max_chunk_tokens"`
}

type LLMProvider interface {
	// ExtractGraph sends text to the LLM and requests structured graph extraction
	ExtractGraph(ctx context.Context, text string, schema string) (*ExtractionResult, error)

	// Health checks if the LLM provider is accessible
	Health(ctx context.Context) error

	// Name returns the provider name for logging
	Name() string
}

type Node struct {
	ID             string                 `json:"id"`
	Label          string                 `json:"label"`
	NodeType       string                 `json:"type"` // function, class, concept, file, etc.
	SourceFile     string                 `json:"source_file,omitempty"`
	SourceLocation string                 `json:"source_location,omitempty"` // L42:C5
	Community      int                    `json:"community,omitempty"`
	Degree         int                    `json:"degree,omitempty"`
	Description    string                 `json:"description,omitempty"`
	Metadata       map[string]interface{} `json:"metadata,omitempty"`
	// Source identifies where this node came from (codebase, memory, webhook).
	// Nodes from the same extraction share the same Source.
	Source *Source `json:"source,omitempty"`
}

type NodeType string

type ObsReference struct {
	// Type is one of: "file", "observation", "concept", "function"
	Type string `json:"type"`
	// Target is the referenced artifact (path, ID, name, etc.)
	Target string `json:"target"`
}

type ObservationNode struct {
	// ID is the Vela node ID — "ancora:obs:<ancoraID>"
	ID       string
	NodeType NodeType
	// AncoraID is the original Ancora observation primary key.
	AncoraID int64
	Title    string
	Content  string
	// ObsType is the Ancora observation category: "decision", "bugfix", etc.
	ObsType    string
	Workspace  string
	References []ObsReference
	CreatedAt  time.Time
	UpdatedAt  time.Time
	// Source identifies this node as memory-derived (set by the patcher/extractor).
	Source *Source
}

type ObsidianConfig struct {
	AutoSync bool   `yaml:"auto_sync"`
	VaultDir string `yaml:"vault_dir"` // e.g. "vela-out"
}

type ProgressUpdate struct {
	Progress         ExtractionProgress
	Error            error
	IsComplete       bool
	EstimatedSeconds int
}

type ReconcilerConfig struct {
	DebounceMs   int `yaml:"debounce_ms"`
	MaxBatchSize int `yaml:"max_batch_size"`
}

type Source struct {
	// Type discriminates the source category.
	Type SourceType `json:"type"`
	// Name is the project/repo name (e.g., "vela", "glim", "ancora").
	Name string `json:"name"`
	// Path is the local filesystem path (codebase only).
	Path string `json:"path,omitempty"`
	// Remote is the git remote URL if detected (codebase only).
	Remote string `json:"remote,omitempty"`
}

type SourceType string

type UIConfig struct {
	Theme        string `yaml:"theme"`
	ShowProgress bool   `yaml:"show_progress"`
	EnableColors bool   `yaml:"enable_colors"`
}

type WatchConfig struct {
	Enabled    bool                `yaml:"enabled"`
	Sources    []WatchSourceConfig `yaml:"sources"`
	Reconciler ReconcilerConfig    `yaml:"reconciler"`
	Extractor  ExtractorConfig     `yaml:"extractor"`
}

type WatchSourceConfig struct {
	Name   string `yaml:"name"`
	Type   string `yaml:"type"`   // "syfra" | "webhook"
	Socket string `yaml:"socket"` // path for syfra sources
}