Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

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.py
index 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.py
index 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: str
project_name: str
total_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 = 0
max_depth: int
truncated: bool = False
nodes: 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__.py
index 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.py
index 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: int
max_depth: int # deepest level present in this (possibly pruned) map
truncated: 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 = 0
diff --git a/packages/ui/src/zoom/types.ts b/packages/ui/src/zoom/types.ts
index 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.tsx
index 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
<ZoomMapKey
verbs={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.tsx
index 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 }: ZoomMapKeyProp
dependency 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 a
diff --git a/tests/unit/server/services/test_zoom_builder.py b/tests/unit/server/services/test_zoom_builder.py
index 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 == 1
assert 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.nodes
def test_assemble_zoom_map_health_rolls_up():