Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
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.scalaindex 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.toLowerCaseval 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.scalaindex 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.7result(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+ }}