Release dec 2025 (#15)

* Resolves issue #13

- Switched model to bge-small-en-v1.5
- Added lazy re-embedding
- Added model version tracking per vector
- Added conversion of vectors to the new model

* Add lfs support to the workflow.

* Implements importance scoring with decay + voting #6

* Resolves issue #5 by marking observations as superseeded and scheduled for deletion

* Implement pattern detection #7

* Improve injections and observations accuracy

- Session start: Recent observations for project context (recency-based)
- User prompt: Semantically relevant observations (similarity-based with threshold)

* Added two stage retrieval with bi and cross encoder #8

* Implement query expansion and reformulation #9

* Knowledge graph and relationships ( resolves #4 )

- File Overlap Detection: Detects relationships when observations modify/read the same files
- Concept Overlap Detection: Detects relationships based on shared semantic concepts
- Type Progression Detection: Infers relationships from natural observation type progressions (e.g., discovery → bugfix = "fixes")
- Temporal Proximity Detection: Detects relationships between observations in the same session within 5 minutes
- Narrative Mention Detection: Detects explicit relationship language in narratives (e.g., "fixes", "depends on", "supersedes")

* Add visualisation of the relations to the dashboard.

* fixup! Add visualisation of the relations to the dashboard.

* Update documentation with new settings and screenshots.

internal/vector/sqlitevec/helpers.go

@@ -19,9 +19,32 @@ type Document struct {
 
 // QueryResult represents a search result from vector search.
 type QueryResult struct {
-	ID       string
-	Distance float64
-	Metadata map[string]any
+	ID         string
+	Distance   float64
+	Similarity float64 // 1.0 = identical, 0.0 = opposite (derived from distance)
+	Metadata   map[string]any
+}
+
+// DistanceToSimilarity converts sqlite-vec cosine distance to similarity score.
+// Cosine distance: 0 = identical, 2 = opposite
+// Similarity: 1.0 = identical, 0.0 = opposite
+func DistanceToSimilarity(distance float64) float64 {
+	return 1.0 - (distance / 2.0)
+}
+
+// FilterByThreshold filters results to only include those above the similarity threshold.
+// If maxResults > 0, also caps the number of results.
+func FilterByThreshold(results []QueryResult, threshold float64, maxResults int) []QueryResult {
+	var filtered []QueryResult
+	for _, r := range results {
+		if r.Similarity >= threshold {
+			filtered = append(filtered, r)
+			if maxResults > 0 && len(filtered) >= maxResults {
+				break
+			}
+		}
+	}
+	return filtered
 }
 
 // ExtractedIDs contains SQLite IDs extracted from query results, grouped by document type.