Documentation
¶
Overview ¶
Package graph - builder implementation for P3-C001.
Package graph provides knowledge graph construction for P3-C001.
Index ¶
- Constants
- type GraphBuilder
- func (b *GraphBuilder) Build(ctx context.Context, userID int32) (*KnowledgeGraph, error)
- func (b *GraphBuilder) GetFilteredGraph(ctx context.Context, userID int32, filter GraphFilter) (*KnowledgeGraph, error)
- func (b *GraphBuilder) GetGraph(ctx context.Context, userID int32) (*KnowledgeGraph, error)
- type GraphConfig
- type GraphEdge
- type GraphFilter
- type GraphNode
- type GraphStats
- type KnowledgeGraph
Constants ¶
const ( EdgeTypeLink = "link" // explicit user-created link EdgeTypeTagCo = "tag_co" // tag co-occurrence EdgeTypeSemantic = "semantic" // semantic similarity )
EdgeType constants.
const ( NodeTypeMemo = "memo" NodeTypeTag = "tag" )
NodeType constants.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type GraphBuilder ¶
type GraphBuilder struct {
// contains filtered or unexported fields
}
GraphBuilder builds knowledge graphs from memos.
func NewGraphBuilder ¶
func NewGraphBuilder(s *store.Store, embedding ai.EmbeddingService, model string) *GraphBuilder
NewGraphBuilder creates a new GraphBuilder.
func NewGraphBuilderWithConfig ¶
func NewGraphBuilderWithConfig(s *store.Store, embedding ai.EmbeddingService, model string, config GraphConfig) *GraphBuilder
NewGraphBuilderWithConfig creates a builder with custom config.
func (*GraphBuilder) Build ¶
func (b *GraphBuilder) Build(ctx context.Context, userID int32) (*KnowledgeGraph, error)
Build constructs the knowledge graph for a user.
func (*GraphBuilder) GetFilteredGraph ¶
func (b *GraphBuilder) GetFilteredGraph(ctx context.Context, userID int32, filter GraphFilter) (*KnowledgeGraph, error)
GetFilteredGraph returns a filtered view of the graph.
func (*GraphBuilder) GetGraph ¶
func (b *GraphBuilder) GetGraph(ctx context.Context, userID int32) (*KnowledgeGraph, error)
GetGraph retrieves a cached graph or builds a new one.
type GraphConfig ¶
type GraphConfig struct {
// MinTagSimilarity is the minimum Jaccard similarity between tag sets to create an edge.
MinTagSimilarity float64
// MinSemanticSimilarity is the minimum similarity score for semantic edges.
MinSemanticSimilarity float64
// MaxSemanticEdgesPerNode limits semantic edges per node.
MaxSemanticEdgesPerNode int
// EnableCommunityDetection enables Louvain community detection.
EnableCommunityDetection bool
// EnablePageRank enables PageRank importance calculation.
EnablePageRank bool
}
GraphConfig contains configuration for graph building.
func DefaultConfig ¶
func DefaultConfig() GraphConfig
DefaultConfig returns default graph configuration.
type GraphEdge ¶
type GraphEdge struct {
Source string `json:"source"`
Target string `json:"target"`
Type string `json:"type"` // "link", "tag_co", "semantic"
Weight float64 `json:"weight"` // 0-1, higher = stronger connection
}
GraphEdge represents an edge in the knowledge graph.
type GraphFilter ¶
type GraphFilter struct {
StartDate *time.Time
EndDate *time.Time
Tags []string
Clusters []int
MinImportance float64
}
GraphFilter contains filter criteria for graph visualization.
type GraphNode ¶
type GraphNode struct {
CreatedAt time.Time `json:"created_at"`
ID string `json:"id"`
Label string `json:"label"`
Type string `json:"type"`
Tags []string `json:"tags,omitempty"`
Importance float64 `json:"importance"`
Cluster int `json:"cluster"`
X float64 `json:"x,omitempty"`
Y float64 `json:"y,omitempty"`
}
GraphNode represents a node in the knowledge graph.
type GraphStats ¶
type GraphStats struct {
NodeCount int `json:"node_count"`
EdgeCount int `json:"edge_count"`
ClusterCount int `json:"cluster_count"`
LinkEdges int `json:"link_edges"`
TagEdges int `json:"tag_edges"`
SemanticEdges int `json:"semantic_edges"`
}
GraphStats contains graph statistics.
type KnowledgeGraph ¶
type KnowledgeGraph struct {
Nodes []GraphNode `json:"nodes"`
Edges []GraphEdge `json:"edges"`
Stats GraphStats `json:"stats"`
BuildMs int64 `json:"build_ms"` // build latency
}
KnowledgeGraph represents the complete graph structure.
func ApplyFilter ¶
func ApplyFilter(graph *KnowledgeGraph, filter GraphFilter) *KnowledgeGraph
ApplyFilter filters the graph based on criteria.
Source Files