Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

feat: add kindBoost to RelevanceScorer for symbol-aware relevance scoring

riley022728ef2fde6f7f
diff --git a/memory-layer/src/main/scala/ix/memory/context/RelevanceScorer.scala b/memory-layer/src/main/scala/ix/memory/context/RelevanceScorer.scala
index ec163acb..e938abd9 100644
--- a/memory-layer/src/main/scala/ix/memory/context/RelevanceScorer.scala
+++ b/memory-layer/src/main/scala/ix/memory/context/RelevanceScorer.scala
@@ -8,13 +8,14 @@ object RelevanceScorer {
seedNodeIds: Set[NodeId],
expandedEdges: Vector[GraphEdge]
): Vector[ScoredClaim] =
- scoreWithTerms(claims, seedNodeIds, expandedEdges, Vector.empty)
+ scoreWithTerms(claims, seedNodeIds, expandedEdges, Vector.empty, Map.empty)
def scoreWithTerms(
claims: Vector[ScoredClaim],
seedNodeIds: Set[NodeId],
expandedEdges: Vector[GraphEdge],
- queryTerms: Vector[String]
+ queryTerms: Vector[String],
+ nodeKindMap: Map[NodeId, NodeKind] = Map.empty
): Vector[ScoredClaim] = {
val oneHopIds = expandedEdges
.flatMap(e => Vector(e.src, e.dst))
@@ -33,7 +34,16 @@ object RelevanceScorer {
val pathLower = sc.claim.provenance.sourceUri.toLowerCase
val pathBoost = if (termsLower.exists(t => pathLower.contains(t))) 1.1 else 1.0
- val relevance = math.min(1.0, hopRelevance * exactBoost * pathBoost)
+ val kindBoost = nodeKindMap.get(sc.claim.entityId) match {
+ case Some(NodeKind.Method) | Some(NodeKind.Function) => 1.3
+ case Some(NodeKind.Class) | Some(NodeKind.Trait)
+ | Some(NodeKind.Object) | Some(NodeKind.Interface) => 1.3
+ case Some(NodeKind.Module) => 1.2
+ case Some(NodeKind.File) => 0.6
+ case _ => 1.0
+ }
+
+ val relevance = math.min(1.0, hopRelevance * exactBoost * pathBoost * kindBoost)
sc.copy(relevance = relevance, finalScore = relevance * sc.confidence.score)
}
}
diff --git a/memory-layer/src/test/scala/ix/memory/context/RelevanceScorerSpec.scala b/memory-layer/src/test/scala/ix/memory/context/RelevanceScorerSpec.scala
index d08c44be..d28a7e81 100644
--- a/memory-layer/src/test/scala/ix/memory/context/RelevanceScorerSpec.scala
+++ b/memory-layer/src/test/scala/ix/memory/context/RelevanceScorerSpec.scala
@@ -77,4 +77,49 @@ class RelevanceScorerSpec extends AnyFlatSpec with Matchers {
result(1).relevance shouldBe 0.7
result(2).relevance shouldBe 0.4
}
+
+ it should "boost symbol node claims with kindBoost 1.3x" in {
+ val seedId = NodeId(UUID.randomUUID())
+ val kindMap = Map(seedId -> NodeKind.Function)
+ val claims = Vector(makeClaim(seedId))
+ val result = RelevanceScorer.scoreWithTerms(claims, Set(seedId), Vector.empty, Vector.empty, kindMap)
+ // hopRelevance=1.0 * kindBoost=1.3 → clamped to 1.0
+ result.head.relevance shouldBe 1.0
+ }
+
+ it should "penalize File node claims with kindBoost 0.6x" in {
+ val seedId = NodeId(UUID.randomUUID())
+ val kindMap = Map(seedId -> NodeKind.File)
+ val claims = Vector(makeClaim(seedId))
+ val result = RelevanceScorer.scoreWithTerms(claims, Set(seedId), Vector.empty, Vector.empty, kindMap)
+ // hopRelevance=1.0 * kindBoost=0.6 = 0.6
+ result.head.relevance shouldBe 0.6
+ result.head.finalScore shouldBe (0.6 * defaultBreakdown.score +- 0.001)
+ }
+
+ it should "rank Method claims above File claims for same seed" in {
+ val methodId = NodeId(UUID.randomUUID())
+ val fileId = NodeId(UUID.randomUUID())
+ val kindMap = Map(methodId -> NodeKind.Method, fileId -> NodeKind.File)
+ val claims = Vector(makeClaim(fileId), makeClaim(methodId))
+ val result = RelevanceScorer.scoreWithTerms(
+ claims, Set(methodId, fileId), Vector.empty, Vector.empty, kindMap
+ ).sortBy(-_.finalScore)
+ result.head.claim.entityId shouldBe methodId
+ }
+
+ it should "apply neutral 1.0x kindBoost for Config nodes" in {
+ val seedId = NodeId(UUID.randomUUID())
+ val kindMap = Map(seedId -> NodeKind.Config)
+ val claims = Vector(makeClaim(seedId))
+ val result = RelevanceScorer.scoreWithTerms(claims, Set(seedId), Vector.empty, Vector.empty, kindMap)
+ result.head.relevance shouldBe 1.0
+ }
+
+ it should "use default kindBoost 1.0 when nodeKindMap is empty" in {
+ val seedId = NodeId(UUID.randomUUID())
+ val claims = Vector(makeClaim(seedId))
+ val result = RelevanceScorer.scoreWithTerms(claims, Set(seedId), Vector.empty, Vector.empty, Map.empty)
+ result.head.relevance shouldBe 1.0
+ }
}