types

type BuildRequest struct {
	RepoRoot  string       `json:"repo_root"`
	Languages []string     `json:"languages,omitempty"`
	Drivers   []string     `json:"drivers,omitempty"`
	Patchers  []string     `json:"patchers,omitempty"`
	Stages    []BuildStage `json:"stages,omitempty"`
}

type BuildStage string

type CanonicalKey struct {
	Layer Layer  `json:"layer"`
	Kind  string `json:"kind"`
	Key   string `json:"key"`
}

type Confidence string

type Config struct {
	LLM        LLMConfig        `yaml:"-"`
	Embedding  EmbeddingConfig  `yaml:"-"`
	Extraction ExtractionConfig `yaml:"extraction"`
	UI         UIConfig         `yaml:"ui"`
	Watch      WatchConfig      `yaml:"-"`
	Daemon     DaemonConfig     `yaml:"-"`
	Obsidian   ObsidianConfig   `yaml:"obsidian"`
	Graph      GraphConfig      `yaml:"graph"`
}

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"`
	LastGraphFlush string                        `json:"last_graph_flush,omitempty"` // RFC3339 timestamp of last graph.json write
}

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 EmbeddingConfig struct {
	Provider      string        `yaml:"provider"` // ollama
	Model         string        `yaml:"model"`
	Endpoint      string        `yaml:"endpoint"`
	Timeout       time.Duration `yaml:"timeout"`
	VectorBackend string        `yaml:"vector_backend"`  // sqlite-cosine, sqlite-vec
	SQLiteVecPath string        `yaml:"sqlite_vec_path"` // optional extension path
}

type Evidence struct {
	// Layer is the architectural layer the evidence came from.
	Layer Layer `json:"layer"`

	// Type is the evidence category, e.g. "openapi", "proto", "import",
	// "call", "observation", "embedding".
	Type string `json:"type"`

	// SourceArtifact identifies the file, observation ID, or declared artifact
	// that produced the evidence.
	SourceArtifact string `json:"source_artifact,omitempty"`

	// Confidence ranks this evidence against competing signals.
	Confidence Confidence `json:"confidence"`

	// Verification tracks binding health for memory references; empty for
	// non-memory evidence.
	Verification VerificationState `json:"verification,omitempty"`

	// Score is an optional numeric weight in [0, 1] used by rankers. Absence
	// means "no numeric preference".
	Score float64 `json:"score,omitempty"`
}

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 Fact struct {
	Repo       string                 `json:"repo,omitempty"`
	Language   string                 `json:"language,omitempty"`
	Kind       FactKind               `json:"kind"`
	From       string                 `json:"from"`
	To         string                 `json:"to,omitempty"`
	Attributes map[string]interface{} `json:"attributes,omitempty"`
	Provenance []Provenance           `json:"provenance,omitempty"`
}

type FactKind string

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 GraphConfig struct {
	AutoPersist   bool          `yaml:"auto_persist"`
	FlushInterval time.Duration `yaml:"flush_interval"`
}

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 Layer string

type Manifest struct {
	Version              int            `json:"version"`
	RepoRoot             string         `json:"repo_root,omitempty"`
	GeneratedAt          time.Time      `json:"generated_at"`
	ExtractorFingerprint string         `json:"extractor_fingerprint"`
	BuildMode            string         `json:"build_mode,omitempty"`
	Files                []ManifestFile `json:"files,omitempty"`
}

type ManifestFile struct {
	Path       string    `json:"path"`
	SHA256     string    `json:"sha256"`
	Size       int64     `json:"size,omitempty"`
	ModTimeUTC time.Time `json:"mod_time_utc,omitempty"`
	Language   string    `json:"language,omitempty"`
	Status     string    `json:"status,omitempty"`
}

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
	Visibility   string
	Organization string
	TopicKey     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. "~/Documents/vela"
}

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

type Provenance struct {
	Stage       string     `json:"stage,omitempty"`
	Driver      string     `json:"driver,omitempty"`
	Source      string     `json:"source,omitempty"`
	Confidence  Confidence `json:"confidence,omitempty"`
	Artifact    string     `json:"artifact,omitempty"`
	Explanation string     `json:"explanation,omitempty"`
}

type QueryKind string

type QueryRequest struct {
	Kind              QueryKind `json:"kind"`
	Subject           string    `json:"subject,omitempty"`
	Target            string    `json:"target,omitempty"`
	Limit             int       `json:"limit,omitempty"`
	IncludeProvenance bool      `json:"include_provenance,omitempty"`
}

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

type RoutingMetadata struct {
	// Repos are the repo canonical keys this routing entry suggests.
	Repos []string `json:"repos,omitempty"`

	// Services names declared services involved in the route (contract layer
	// entities, referenced by canonical key).
	Services []string `json:"services,omitempty"`

	// Domains are coarse subject tags such as "billing" or "auth".
	Domains []string `json:"domains,omitempty"`

	// Packages are language-level package names (Go modules, npm packages).
	Packages []string `json:"packages,omitempty"`

	// Dependencies expresses declared dependencies between repos/services.
	Dependencies []string `json:"dependencies,omitempty"`
}

type Source struct {
	// Type discriminates the source category.
	Type SourceType `json:"type"`
	// ID is the stable repo/source identity used for node namespacing.
	ID string `json:"id,omitempty"`
	// Name is the project/repo name (e.g., "vela", "glim", "ancora").
	Name string `json:"name"`
	// Organization is the git remote owner/org when available.
	Organization string `json:"organization,omitempty"`
	// 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 VerificationState string

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
}