constellation

type BusEvent struct {
	BusID     string // Bus identifier (e.g., "bus_chat_cog-discord-100000000000000001")
	Seq       int    // Sequence number within the bus
	Timestamp string // RFC3339Nano timestamp
	From      string // Sender (e.g., "http:user", "kernel:cogos")
	Type      string // Event type ("chat.request" or "chat.response")
	Content   string // Message content
	Hash      string // Content-addressed hash of the CogBlock
	Origin    string // Origin platform (e.g., "discord", "http", "claude-code")
	Agent     string // Agent name (optional)
	UserID    string // User identifier (optional)
	UserName  string // User display name (optional)
}

type Cogdoc struct {
	ID               string
	Path             string
	Type             string
	Title            string
	Created          string
	Updated          string
	Sector           string
	Status           string
	Salience         string
	Confidence       string
	Ingested         string
	Tags             []string
	Refs             []Reference
	Content          string
	FrontmatterBytes int // Size of YAML frontmatter in bytes
}

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

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

type EmbedConfig struct {
	Enabled        bool   `yaml:"enabled"`
	ServerSocket   string `yaml:"server_socket"`
	ServerHTTP     string `yaml:"server_http"`
	DimsFull       int    `yaml:"dims_full"`
	DimsCompressed int    `yaml:"dims_compressed"`
	TimeoutMs      int    `yaml:"timeout_ms"`
}

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

type EmbedResult struct {
	Embedding768 []float32
	Embedding128 []float32
}

type EmbedStatus struct {
	TotalDocs  int      // Total documents in constellation
	Embedded   int      // Documents with embeddings
	Stale      int      // Documents where content changed since embedding
	Missing    int      // Documents without any embedding
	StalePaths []string // Paths of stale documents (for diagnostics)
}

type Node struct {
	ID      string
	URI     string
	Type    string
	Title   string
	Path    string
	Content string
	Sector  string
	Status  string
	Rank    float64 // BM25 rank for FTS queries
}

type NodeWithScore struct {
	Node                Node
	BM25Score           float64
	SubstanceScore      float64
	EmbeddingSimilarity float64 // Cosine similarity between query and doc embeddings
	ProbeScore          float64 // Trained probe relevance probability (Phase E)
	CombinedScore       float64
	IsLeaf              bool
	Embedding128        []float32 // Cached 128-dim embedding (avoids re-query for probe scoring)
}

type Reference struct {
	URI string
	Rel string
}

type SubstanceFilterConfig struct {
	MinSubstanceRatio float64 // Minimum substance ratio to include (0.0-1.0)
	PreferLeafNodes   bool    // Boost high-substance, low-ref documents
	LeafThreshold     float64 // Substance ratio to consider a "leaf node"
	LeafMaxRefs       int     // Max refs for a document to be a "leaf node"
	BM25Weight        float64 // Weight for BM25 relevance (0.0-1.0)
	SubstanceWeight   float64 // Weight for substance ratio (0.0-1.0)
}

type SubstanceMetrics struct {
	Path             string  // Document path (empty for aggregates)
	Sector           string  // Sector name
	Type             string  // Document type
	DocCount         int     // Number of documents (for aggregates)
	FrontmatterBytes int     // Total frontmatter bytes
	ContentBytes     int     // Total content bytes
	SubstanceRatio   float64 // Content / (Content + Frontmatter)
	RefCount         int     // Number of outgoing references
	RefDensity       float64 // Refs per KB of content
}