Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
feat(kg): say how many files the map is not showing (#1847)
Raghav Chamadiyaf96ac60f4807
diff --git a/packages/server/src/repowise/server/routers/c4.py b/packages/server/src/repowise/server/routers/c4.pyindex d66142186..3b006744c 100644--- a/packages/server/src/repowise/server/routers/c4.py+++ b/packages/server/src/repowise/server/routers/c4.py@@ -275,6 +275,7 @@ def _zoom_response(zoom: ZoomMap) -> ZoomMapResponse:root_id=zoom.root_id,project_name=zoom.project_name,total_files=zoom.total_files,+ unclaimed_files=zoom.unclaimed_files,max_depth=zoom.max_depth,truncated=zoom.truncated,nodes=[diff --git a/packages/server/src/repowise/server/schemas/zoom.py b/packages/server/src/repowise/server/schemas/zoom.pyindex e3060cf1c..534a9fc7e 100644--- a/packages/server/src/repowise/server/schemas/zoom.py+++ b/packages/server/src/repowise/server/schemas/zoom.py@@ -61,6 +61,10 @@ class ZoomMapResponse(BaseModel):root_id: strproject_name: strtotal_files: int+ # Files in the repository view that curation put in no layer, so they are on+ # no tree. Additive and defaulted: an older consumer reading ``total_files``+ # gets the same number it always did.+ unclaimed_files: int = 0max_depth: inttruncated: bool = Falsenodes: list[ZoomNodeResponse]diff --git a/packages/server/src/repowise/server/services/zoom_builder/__init__.py b/packages/server/src/repowise/server/services/zoom_builder/__init__.pyindex 45e904976..a10d49319 100644--- a/packages/server/src/repowise/server/services/zoom_builder/__init__.py+++ b/packages/server/src/repowise/server/services/zoom_builder/__init__.py@@ -155,6 +155,8 @@ def assemble_zoom_map(# about but that curation assigned to no layer is not in the tree, so# counting file_stats would over-report). Taken before depth/focus pruning.total_files = sum(1 for n in nodes.values() if n.kind == "file")+ # ...and the rest of that denominator, so the map can say how much it omits.+ unclaimed_files = max(len(file_stats) - total_files, 0)root_id, nodes, relations, truncated = _prune(root_id, nodes, relations, max_depth=max_depth, focus=focus@@ -169,6 +171,7 @@ def assemble_zoom_map(total_files=total_files,max_depth=present_depth,truncated=truncated,+ unclaimed_files=unclaimed_files,)diff --git a/packages/server/src/repowise/server/services/zoom_builder/models.py b/packages/server/src/repowise/server/services/zoom_builder/models.pyindex cc463ee2b..59a0d72e8 100644--- a/packages/server/src/repowise/server/services/zoom_builder/models.py+++ b/packages/server/src/repowise/server/services/zoom_builder/models.py@@ -97,3 +97,7 @@ class ZoomMap:total_files: intmax_depth: int # deepest level present in this (possibly pruned) maptruncated: bool = False # True when depth/focus pruning dropped deeper nodes+ # Files the view knows about that curation assigned to no layer, so they are+ # in no tree at all. ``total_files`` stays the count actually placed; this is+ # the rest of the denominator, so a map can say what it is not showing.+ unclaimed_files: int = 0diff --git a/packages/ui/src/zoom/types.ts b/packages/ui/src/zoom/types.tsindex 564b86ca6..3c74b125f 100644--- a/packages/ui/src/zoom/types.ts+++ b/packages/ui/src/zoom/types.ts@@ -64,6 +64,9 @@ export interface ZoomMap {root_id: string;project_name: string;total_files: number;+ /** Files curation placed in no layer, so they are on no tree. Optional: an+ * older server does not send it. */+ unclaimed_files?: number;max_depth: number;truncated: boolean;nodes: ZoomNode[];diff --git a/packages/web/src/app/repos/[id]/knowledge-graph/page.tsx b/packages/web/src/app/repos/[id]/knowledge-graph/page.tsxindex fa01bfa05..91329b035 100644--- a/packages/web/src/app/repos/[id]/knowledge-graph/page.tsx+++ b/packages/web/src/app/repos/[id]/knowledge-graph/page.tsx@@ -166,6 +166,8 @@ export default function KnowledgeGraphPage({ params }: { params: Promise<{ id: s<ZoomMapKeyverbs={verbs}+ totalFiles={zoomMap.total_files}+ unclaimedFiles={zoomMap.unclaimed_files ?? 0}selected={relationVerbs}onSelectedChange={setRelationVerbs}/>diff --git a/packages/web/src/components/zoom/zoom-map-key.tsx b/packages/web/src/components/zoom/zoom-map-key.tsxindex 784fbea26..6082dcfe7 100644--- a/packages/web/src/components/zoom/zoom-map-key.tsx+++ b/packages/web/src/components/zoom/zoom-map-key.tsx@@ -35,6 +35,11 @@ import { HEALTH_BAND_LABEL } from "@repowise-dev/types/health";interface ZoomMapKeyProps {/** Every verb present in the loaded map, descending by count. */verbs: VerbCount[];+ /** Files placed in the tree, and files curation left in no layer. The second+ * is the map's missing denominator: without it, a map short one file in+ * seven reads as complete. */+ totalFiles: number;+ unclaimedFiles: number;/** Null = every relation draws; otherwise only these verbs do. */selected: ReadonlySet<string> | null;onSelectedChange: (verbs: ReadonlySet<string> | null) => void;@@ -44,7 +49,13 @@ function Dot({ className }: { className: string }) {return <span aria-hidden className={`inline-block h-2 w-2 shrink-0 rounded-full ${className}`} />;}-export function ZoomMapKey({ verbs, selected, onSelectedChange }: ZoomMapKeyProps) {+export function ZoomMapKey({+ verbs,+ totalFiles,+ unclaimedFiles,+ selected,+ onSelectedChange,+}: ZoomMapKeyProps) {const filtered = selected !== null;return (@@ -65,6 +76,15 @@ export function ZoomMapKey({ verbs, selected, onSelectedChange }: ZoomMapKeyPropdependency covers.</>)}+ {unclaimedFiles > 0 && (+ /* Silence when nothing is missing: "0 not shown" is noise. */+ <>+ {" "}+ {unclaimedFiles.toLocaleString()} of{" "}+ {(totalFiles + unclaimedFiles).toLocaleString()} files are not on the map; they+ belong to no layer.+ </>+ )}</p>{verbs.length > 1 && (/* Counts sit on the chips so you can tell whether one is worth adiff --git a/tests/unit/server/services/test_zoom_builder.py b/tests/unit/server/services/test_zoom_builder.pyindex 52e02de0e..e1e0e45a3 100644--- a/tests/unit/server/services/test_zoom_builder.py+++ b/tests/unit/server/services/test_zoom_builder.py@@ -2,6 +2,8 @@from __future__ import annotations+from dataclasses import replace+from repowise.server.services.c4_builder.models import (ArchEdge,ArchitectureView,@@ -537,6 +539,23 @@ def test_assemble_zoom_map_full():main = zoom.nodes[file_id("pkg/main.py")]assert main.is_entry_point and main.sibling_rank == 1assert not zoom.truncated+ # every file the view knows about landed in a layer, so nothing is hidden+ assert zoom.unclaimed_files == 0+++def test_assemble_zoom_map_counts_files_no_layer_claimed():+ # A file the view knows about but that curation assigned to no layer is on+ # no tree at all, so total_files cannot see it. Report it separately rather+ # than letting an incomplete map read as complete.+ view = _view()+ orphan = _node("pkg/core/orphan.py", pagerank_percentile=5.0)+ view = replace(view, nodes=[*view.nodes, orphan], total_files=4)++ zoom = assemble_zoom_map(view)++ assert zoom.total_files == 3+ assert zoom.unclaimed_files == 1+ assert file_id("pkg/core/orphan.py") not in zoom.nodesdef test_assemble_zoom_map_health_rolls_up():