queries

package
v0.62.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 9, 2026 License: MIT Imports: 9 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions 

func AddManualLink(ctx context.Context, db *sql.DB, fromName, toName, rel string) error

AddManualLink creates an explicit dependency edge fromName -> toName with the given relationship, marked source='manual' so it is exported to links.jsonl and survives re-extraction. Entity names are resolved to their canonical IDs. Returns an error if either entity is unknown.

func AliasEntities added in v0.53.1 

func AliasEntities(ctx context.Context, db *sql.DB, targetID string, aliases []ResolvedEntity) error

AliasEntities collapses one or more alias entities into a target canonical entity. It merges all relationships and session mentions in a single transaction and records the mapping in the registry.

func AutoAliasDuplicates added in v0.55.0 

func AutoAliasDuplicates(ctx context.Context, db *sql.DB) (int, error)

AutoAliasDuplicates merges entities whose names are identical after normalization. Only exact normalized matches are merged — near matches ("ollama" vs "ollamaextractor") remain suggestions, never auto-merges. The canonical entity is the one with the highest mention_count; variant names stay in the entity_aliases registry so future extractions resolve to the canonical. Returns the number of entities merged away.

func DismissAliasPair added in v0.58.0 

func DismissAliasPair(ctx context.Context, db *sql.DB, a, b, actor string) error

DismissAliasPair records that a suggested pair was reviewed and rejected, so it is never suggested again.

func DismissLinkPair added in v0.62.0 

func DismissLinkPair(ctx context.Context, db *sql.DB, a, b, actor string) error

DismissLinkPair records that a suggested relationship was reviewed and rejected, so it is never suggested again.

func UnaliasEntity added in v0.53.1 

func UnaliasEntity(ctx context.Context, db *sql.DB, aliasName string) error

UnaliasEntity removes a mapping from the registry.

Types

type AliasSuggestion added in v0.53.1 

type AliasSuggestion struct {
	EntityA        string  `json:"entity_a"`
	EntityB        string  `json:"entity_b"`
	Similarity     float64 `json:"session_overlap"`
	NameSimilarity float64 `json:"name_similarity"`
	Score          float64 `json:"score"`
}

func GetAliasSuggestions added in v0.53.1 

func GetAliasSuggestions(ctx context.Context, db *sql.DB, threshold float64, limit int) ([]AliasSuggestion, error)

It uses Jaccard similarity: intersection / union of sessions. GetAliasSuggestions returns entity pairs that are likely the same thing. Candidates need BOTH high session co-occurrence (Jaccard >= threshold) AND name similarity: co-occurrence alone conflates "related" with "identical" (a command and the file it lives in overlap 100%), and single-session pairs are pure noise (1/1 = perfect overlap from one observation) — hence the >= 2 sessions floor. Pairs recorded in alias_dismissals are never returned. limit <= 0 returns all matches; results are ranked by combined score.

type CatchupDelta 

type CatchupDelta struct {
	Since        time.Time
	Sessions     []SearchResult
	ClosedIssues []types.Issue
	StateChanges []types.BranchState
}

func GetCatchupDelta 

func GetCatchupDelta(ctx context.Context, db *sql.DB, since time.Time) (*CatchupDelta, error)

type CooccurrenceNode 

type CooccurrenceNode struct {
	Name  string
	Count int
}

func GetRelatedEntitiesByCooccurrence 

func GetRelatedEntitiesByCooccurrence(ctx context.Context, db *sql.DB, entityID string, limit int) ([]CooccurrenceNode, error)

GetRelatedEntitiesByCooccurrence finds entities that frequently appear in the same sessions

type EntityGraph 

type EntityGraph struct {
	Nodes []EntityNode
}

func GetEntityGraphExact 

func GetEntityGraphExact(ctx context.Context, db *sql.DB, entityName string, depth int, relType string) (*EntityGraph, error)

func GetEntityImpactExact added in v0.53.1 

func GetEntityImpactExact(ctx context.Context, db *sql.DB, entityName string, depth int, relType string) (*EntityGraph, error)

type EntityNode 

type EntityNode struct {
	ID           string
	Name         string
	Relationship string
	Depth        int
	Path         string
}

type FeatureGroup added in v0.55.0 

type FeatureGroup struct {
	Key          string              `json:"key"`
	Kind         string              `json:"kind"` // branch | entity | general
	Narrative    string              `json:"narrative"`
	Sessions     []SearchResult      `json:"sessions"`
	Authors      []string            `json:"authors"`
	Entities     []string            `json:"entities"`
	StateChanges []types.BranchState `json:"state_changes"`
}

FeatureGroup is one "feature arc" of the catchup digest: sessions sharing a work branch, or (for trunk work) a dominant entity.

func GroupCatchupDelta added in v0.55.0 

func GroupCatchupDelta(ctx context.Context, db *sql.DB, delta *CatchupDelta) ([]FeatureGroup, []types.BranchState)

GroupCatchupDelta organizes the delta's sessions into feature arcs. Branch is the primary arc key; trunk sessions are grouped by their most shared entity; leftovers form a "General" group. State changes matching an arc's key or entities attach to it; the rest are returned separately.

type LinkSuggestion added in v0.62.0 

type LinkSuggestion struct {
	EntityA    string  `json:"entity_a"`
	EntityB    string  `json:"entity_b"`
	CoSessions int     `json:"co_sessions"`
	Overlap    float64 `json:"session_overlap"`
}

LinkSuggestion is a pair of entities that co-occur strongly in devlog sessions but have NO explicit dependency edge — a candidate for the agent to promote into a real relationship (BeadsLog-58r).

func GetLinkSuggestions added in v0.62.0 

func GetLinkSuggestions(ctx context.Context, db *sql.DB, minCo, limit int) ([]LinkSuggestion, error)

GetLinkSuggestions returns entity pairs with high session co-occurrence and no explicit entity_deps edge in either direction. Dismissed pairs and noise endpoints are excluded; ranked by shared-session count. minCo is the minimum shared sessions; limit <= 0 returns all. 

type ManualLink struct {
	FromName     string `json:"from"`
	ToName       string `json:"to"`
	Relationship string `json:"relationship"`
}

ManualLink is one exported manual edge, keyed by entity NAME so it survives DB reconstruction and travels between clones (links.jsonl). 

func GetManualLinks(ctx context.Context, db *sql.DB) ([]ManualLink, error)

GetManualLinks returns all manual edges by name, for export to links.jsonl.

type PathStep 

type PathStep struct {
	EntityName   string
	SessionID    string
	SessionTitle string
}

func GetPathBetweenEntities 

func GetPathBetweenEntities(ctx context.Context, db *sql.DB, startID, endID string) ([]PathStep, error)

GetPathBetweenEntities finds the shortest path between two entities via devlog sessions

type ProximityWarning 

type ProximityWarning struct {
	State        types.LifecycleState
	ScopeType    types.ScopeType
	ScopeRef     string
	ShortReason  string
	FullReasonID string
}

func CheckProximityWarnings 

func CheckProximityWarnings(ctx context.Context, db *sql.DB, scopeType types.ScopeType, scopeRef string) ([]ProximityWarning, error)

CheckProximityWarnings checks if the given scope overlaps with any paused or abandoned states

type ResolvedEntity 

type ResolvedEntity struct {
	ID   string
	Name string
}

func ResolveEntities 

func ResolveEntities(ctx context.Context, db *sql.DB, term string, limit int) ([]ResolvedEntity, error)

ResolveEntities finds entities matching the term using Hybrid FTS + LIKE logic. This ensures consistent behavior between "Search" and "Graph/Impact" commands.

type SearchOptions 

type SearchOptions struct {
	Query         string
	Author        string
	CurrentBranch string
	Limit         int
	Strict        bool // If true, only BM25 on sessions, no expansion
	TextOnly      bool // If true, only BM25, no entity lookup
	Preview       bool // If true, show first 3 lines instead of snippet
	Explain       bool // If true, show score breakdown
}

type SearchResponse 

type SearchResponse struct {
	Results         []SearchResult
	RelatedEntities []string
	Strategy        string // e.g. "exact", "hybrid", "fallback"
}

func HybridSearch 

func HybridSearch(ctx context.Context, db *sql.DB, opts SearchOptions) (SearchResponse, error)

type SearchResult 

type SearchResult struct {
	ID        string  `json:"id"`
	Title     string  `json:"title"`
	Date      string  `json:"date"`
	Narrative string  `json:"narrative"` // Snippet or Preview
	Score     float64 `json:"score"`
	Reason    string  `json:"reason"` // e.g. "text match", "entity:Modal"

	// Explanation fields (for --explain)
	BM25         float64 `json:"bm25"`
	PhraseBonus  float64 `json:"phrase_bonus"`
	NearBonus    float64 `json:"near_bonus"`
	EntityBonus  float64 `json:"entity_bonus"`
	RecencyBonus float64 `json:"recency_bonus"`

	IsLowConfidence bool `json:"is_low_confidence"`

	// Lifecycle fields
	LifecycleStatus types.LifecycleState `json:"lifecycle_status"`
	StatusReason    string               `json:"status_reason"`
	IsValidated     bool                 `json:"is_validated"`
	Branch          string               `json:"branch"`
	Author          string               `json:"author"`
	AuthorEmail     string               `json:"author_email"`
	Agent           string               `json:"agent"`
}

type Suggestion 

type Suggestion struct {
	Name     string
	Distance int    // -1 if not applicable
	Type     string // "exact", "typo", "fuzzy"
}

func SuggestEntities 

func SuggestEntities(ctx context.Context, db *sql.DB, term string) ([]Suggestion, error)

SuggestEntities finds potential entity matches for a term that yielded no results. It uses fuzzy matching and Levenshtein distance for typo correction.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.