semantic

type Fact interface {
	GetID() string
	GetType() FactType
	GetSources() []Source
	GetTags() []string
	GetMetadata() FactMetadata
	// contains filtered or unexported methods
}

type FactMetadata struct {
	CreatedAt    time.Time
	ValidatedAt  time.Time
	LastAccessed time.Time
	AccessCount  int
	AccessScore  float64
	Constraints  map[string]string
}

type FactType string

type GraphEdge struct {
	Subject   string
	Predicate string
	Object    string
}

type GraphNode struct {
	Entity string
	Facts  []Fact
}

type GraphQuery struct {
	StartEntity string
	Predicates  []string
	MaxDepth    int
	MaxResults  int
}

type GraphResult struct {
	Nodes []GraphNode
	Edges []GraphEdge
}

type Memory interface {
	Write(ctx context.Context, entity, attribute, value string) error
	Read(ctx context.Context, entity, attribute string) (string, error)
	Search(ctx context.Context, attribute, value string) ([]string, error)
	Delete(ctx context.Context, entity, attribute string) error
}

type Relationship struct {
	ID        string
	Subject   string
	Predicate string
	Object    string
	Metadata  RelationshipMetadata
}

type RelationshipMetadata struct {
	CreatedAt time.Time
}

type SearchQuery struct {
	Type        *FactType
	Entity      *string
	Attribute   *string
	Value       *string
	Tag         *string
	Source      *string
	Statement   *string
	Constraints map[string]string
	Limit       int
	Offset      int
	SortBy      SortField
	SortOrder   SortOrder
}

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

type ServiceOption func(*Service)

type SortField string

type SortOrder string

type Source struct {
	URI         string
	RetrievedAt time.Time
}

type StatementFact struct {
	ID        string
	Statement string
	Sources   []Source
	Tags      []string
	Metadata  FactMetadata
}

type Store interface {
	WriteTriple(ctx context.Context, fact TripleFact) error
	WriteStatement(ctx context.Context, fact StatementFact) error
	WriteTriples(ctx context.Context, facts []TripleFact) error
	WriteStatements(ctx context.Context, facts []StatementFact) error

	ReadFact(ctx context.Context, id string) (Fact, error)
	ReadTriple(ctx context.Context, id string) (TripleFact, error)
	ReadStatement(ctx context.Context, id string) (StatementFact, error)

	Search(ctx context.Context, query SearchQuery) ([]Fact, error)

	DeleteFact(ctx context.Context, id string) error
	DeleteByEntityAttribute(ctx context.Context, entity, attribute string) error

	WriteRelationship(ctx context.Context, rel Relationship) error
	ReadRelationships(ctx context.Context, subject string) ([]Relationship, error)
	DeleteRelationship(ctx context.Context, id string) error
	TraverseGraph(ctx context.Context, query GraphQuery) (GraphResult, error)

	Close() error
}

type TripleFact struct {
	ID        string
	Entity    string
	Attribute string
	Value     string
	Sources   []Source
	Tags      []string
	Metadata  FactMetadata
}