@gmickel/gno 1.4.1 → 1.5.0

package/src/serve/public/pages/GraphView.tsx

@@ -51,6 +51,26 @@ interface GraphNode {
   collection: string;
   relPath: string;
   degree: number;
+  communityId?: string;
+}
+
+interface GraphReportNode {
+  id: string;
+  uri: string;
+  title: string | null;
+  collection: string;
+  relPath: string;
+  degree: number;
+  communityId?: string;
+}
+
+interface GraphCommunity {
+  id: string;
+  label: string;
+  size: number;
+  edgeCount: number;
+  density: number;
+  topNodes: GraphReportNode[];
 }
 
 interface GraphLink {
@@ -58,6 +78,17 @@ interface GraphLink {
   target: string;
   type: "wiki" | "markdown" | "similar";
   weight: number;
+  confidence: "explicit" | "inferred" | "ambiguous" | "similarity";
+  audit: {
+    resolution:
+      | "exact-title"
+      | "exact-path"
+      | "path-fallback"
+      | "ambiguous-fallback"
+      | "similarity";
+    matchCount?: number;
+    score?: number;
+  };
 }
 
 interface GraphMeta {
@@ -78,9 +109,49 @@ interface GraphMeta {
   warnings: string[];
 }
 
+interface GraphReport {
+  hubs: GraphReportNode[];
+  bridgeCandidates: GraphReportNode[];
+  isolated: {
+    total: number;
+    examples: GraphReportNode[];
+  };
+  unresolvedLinks: {
+    total: number;
+    byType: {
+      wiki: number;
+      markdown: number;
+    };
+  };
+  edgeTypes: {
+    wiki: number;
+    markdown: number;
+    similar: number;
+  };
+  edgeConfidence: {
+    explicit: number;
+    inferred: number;
+    ambiguous: number;
+    similarity: number;
+  };
+  audit: {
+    inferredEdges: number;
+    ambiguousEdges: number;
+    similarityEdges: number;
+  };
+  communities: {
+    total: number;
+    algorithm: "deterministic-label-propagation";
+    skipped: boolean;
+    assignments: Record<string, string>;
+    top: GraphCommunity[];
+  };
+}
+
 interface GraphResponse {
   nodes: GraphNode[];
   links: GraphLink[];
+  report: GraphReport;
   meta: GraphMeta;
 }
 
@@ -111,6 +182,8 @@ const COLORS = {
   edgeWiki: "rgba(77, 184, 168, 0.4)", // Teal threads
   edgeMarkdown: "rgba(77, 184, 168, 0.25)", // Fainter teal
   edgeSimilar: "rgba(212, 160, 83, 0.3)", // Gold similarity
+  edgeInferred: "rgba(124, 158, 178, 0.35)",
+  edgeAmbiguous: "rgba(245, 215, 142, 0.55)",
 
   // Background
   canvas: "#050505", // Deep black - observatory darkness
@@ -136,6 +209,22 @@ function getCollectionColor(collection: string): string {
   return palette[Math.abs(hash) % palette.length]!;
 }
 
+function getCommunityColor(communityId: string | undefined): string | null {
+  if (!communityId) return null;
+  const palette = [
+    "#4db8a8",
+    "#d4a053",
+    "#6ba3d6",
+    "#a8c686",
+    "#c9a7c7",
+    "#e2a76f",
+    "#f5d78e",
+    "#7c9eb2",
+  ];
+  const index = Math.max(0, Number.parseInt(communityId.slice(1), 10) - 1);
+  return palette[index % palette.length] ?? null;
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Loading & Empty States
 // ─────────────────────────────────────────────────────────────────────────────
@@ -240,6 +329,7 @@ export default function GraphView({ navigate }: PageProps) {
   // Filter state
   const [selectedCollection, setSelectedCollection] = useState<string>("_all");
   const [includeSimilar, setIncludeSimilar] = useState(false);
+  const [selectedCommunity, setSelectedCommunity] = useState<string>("_all");
 
   // UI state
   const [showTruncationBanner, setShowTruncationBanner] = useState(true);
@@ -289,6 +379,7 @@ export default function GraphView({ navigate }: PageProps) {
     setLoading(true);
     setError(null);
     setShowTruncationBanner(true);
+    setSelectedCommunity("_all");
     clearZoomTimeouts();
 
     const params = new URLSearchParams();
@@ -369,24 +460,47 @@ export default function GraphView({ navigate }: PageProps) {
   const forceGraphData = useMemo(() => {
     if (!graphData) return { nodes: [], links: [] };
 
+    const visibleNodeIds = new Set(
+      graphData.nodes
+        .filter(
+          (node) =>
+            selectedCommunity === "_all" ||
+            node.communityId === selectedCommunity
+        )
+        .map((node) => node.id)
+    );
+
     return {
-      nodes: graphData.nodes.map((n) => ({
-        ...n,
-        // Add computed properties for rendering
-        color: getCollectionColor(n.collection),
-        size: Math.max(4, Math.min(20, 4 + Math.sqrt(n.degree) * 2)),
-      })),
-      links: graphData.links.map((l) => ({
-        ...l,
-        color:
-          l.type === "similar"
-            ? COLORS.edgeSimilar
-            : l.type === "wiki"
-              ? COLORS.edgeWiki
-              : COLORS.edgeMarkdown,
-      })),
+      nodes: graphData.nodes
+        .filter((node) => visibleNodeIds.has(node.id))
+        .map((n) => ({
+          ...n,
+          // Add computed properties for rendering
+          color:
+            getCommunityColor(n.communityId) ??
+            getCollectionColor(n.collection),
+          size: Math.max(4, Math.min(20, 4 + Math.sqrt(n.degree) * 2)),
+        })),
+      links: graphData.links
+        .filter(
+          (link) =>
+            visibleNodeIds.has(link.source) && visibleNodeIds.has(link.target)
+        )
+        .map((l) => ({
+          ...l,
+          color:
+            l.confidence === "ambiguous"
+              ? COLORS.edgeAmbiguous
+              : l.confidence === "inferred"
+                ? COLORS.edgeInferred
+                : l.type === "similar"
+                  ? COLORS.edgeSimilar
+                  : l.type === "wiki"
+                    ? COLORS.edgeWiki
+                    : COLORS.edgeMarkdown,
+        })),
     };
-  }, [graphData]);
+  }, [graphData, selectedCommunity]);
 
   // Node canvas rendering for custom aesthetics
   // biome-ignore lint: dynamic import typing
@@ -494,6 +608,27 @@ export default function GraphView({ navigate }: PageProps) {
             <span className="hidden sm:inline">Dashboard</span>
           </Button>
 
+          {graphData &&
+            !graphData.report.communities.skipped &&
+            graphData.report.communities.top.length > 0 && (
+              <Select
+                onValueChange={setSelectedCommunity}
+                value={selectedCommunity}
+              >
+                <SelectTrigger className="h-8 w-[170px] border-border/50 bg-background/50 text-xs">
+                  <SelectValue placeholder="All communities" />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="_all">All communities</SelectItem>
+                  {graphData.report.communities.top.map((community) => (
+                    <SelectItem key={community.id} value={community.id}>
+                      {community.id} · {community.size} docs
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            )}
+
           <div className="h-4 w-px bg-border/50" />
 
           <h1 className="font-serif text-lg text-[#4db8a8]">Knowledge Graph</h1>
@@ -578,6 +713,36 @@ export default function GraphView({ navigate }: PageProps) {
                 {graphData.links.length.toLocaleString()}
               </span>{" "}
               edges
+              <span className="text-border">•</span>
+              <span className="text-[#f5d78e]">
+                {graphData.report.hubs[0]?.degree ?? 0}
+              </span>{" "}
+              top degree
+              <span className="text-border">•</span>
+              <span className="text-[#d4a053]">
+                {graphData.report.unresolvedLinks.total.toLocaleString()}
+              </span>{" "}
+              unresolved
+              <span className="text-border">•</span>
+              <span className="text-[#4db8a8]">
+                {graphData.report.isolated.total.toLocaleString()}
+              </span>{" "}
+              isolated
+              <span className="text-border">•</span>
+              <span className="text-[#7c9eb2]">
+                {graphData.report.audit.inferredEdges.toLocaleString()}
+              </span>{" "}
+              inferred
+              <span className="text-border">•</span>
+              <span className="text-[#f5d78e]">
+                {graphData.report.audit.ambiguousEdges.toLocaleString()}
+              </span>{" "}
+              ambiguous
+              <span className="text-border">•</span>
+              <span className="text-[#6ba3d6]">
+                {graphData.report.communities.total.toLocaleString()}
+              </span>{" "}
+              communities
             </div>
           )}
 
@@ -611,6 +776,48 @@ export default function GraphView({ navigate }: PageProps) {
         />
       )}
 
+      {graphData &&
+        !loading &&
+        !graphData.report.communities.skipped &&
+        graphData.report.communities.top.length > 0 && (
+          <div className="absolute right-4 bottom-4 z-20 hidden max-w-xs rounded-lg border border-border/30 bg-[#0f1115]/85 p-3 shadow-lg backdrop-blur-md md:block">
+            <p className="mb-2 font-mono text-[#4db8a8] text-[10px] uppercase tracking-[0.12em]">
+              Communities
+            </p>
+            <div className="space-y-1.5">
+              {graphData.report.communities.top.slice(0, 6).map((community) => (
+                <button
+                  className={cn(
+                    "flex w-full items-center gap-2 rounded px-1.5 py-1 text-left text-xs transition-colors hover:bg-white/5",
+                    selectedCommunity === community.id && "bg-white/10"
+                  )}
+                  key={community.id}
+                  onClick={() =>
+                    setSelectedCommunity((current) =>
+                      current === community.id ? "_all" : community.id
+                    )
+                  }
+                  type="button"
+                >
+                  <span
+                    className="size-2.5 shrink-0 rounded-full"
+                    style={{
+                      backgroundColor:
+                        getCommunityColor(community.id) ?? COLORS.nodeDefault,
+                    }}
+                  />
+                  <span className="min-w-0 flex-1 truncate text-muted-foreground">
+                    {community.label}
+                  </span>
+                  <span className="font-mono text-[#d4a053]">
+                    {community.size}
+                  </span>
+                </button>
+              ))}
+            </div>
+          </div>
+        )}
+
       {/* Graph canvas */}
       <div className="h-full pt-12">
         {loading ? (
@@ -718,6 +925,20 @@ export default function GraphView({ navigate }: PageProps) {
               <span className="text-muted-foreground">Similarity</span>
             </div>
           )}
+          <div className="flex items-center gap-2">
+            <span
+              className="size-2 rounded-full"
+              style={{ backgroundColor: COLORS.edgeInferred }}
+            />
+            <span className="text-muted-foreground">Inferred</span>
+          </div>
+          <div className="flex items-center gap-2">
+            <span
+              className="size-2 rounded-full"
+              style={{ backgroundColor: COLORS.edgeAmbiguous }}
+            />
+            <span className="text-muted-foreground">Ambiguous</span>
+          </div>
         </div>
       </div>
     </div>

package/src/serve/public/pages/Search.tsx

@@ -388,6 +388,7 @@ export default function Search({ navigate }: PageProps) {
       if (!useBm25) {
         body.noExpand = depthPolicy.noExpand;
         body.noRerank = depthPolicy.noRerank;
+        body.noGraph = thoroughness === "fast";
         if (queryModes.length > 0) {
           body.queryModes = queryModes;
         }

package/src/serve/routes/api.ts

@@ -172,6 +172,7 @@ export interface QueryRequestBody {
   queryModes?: QueryModeInput[];
   noExpand?: boolean;
   noRerank?: boolean;
+  noGraph?: boolean;
   /** Comma-separated tags - filter to docs having ALL (AND) */
   tagsAll?: string;
   /** Comma-separated tags - filter to docs having ANY (OR) */
@@ -3310,6 +3311,7 @@ export async function handleQuery(
       queryModes: normalizedQueryModes,
       noExpand: body.noExpand,
       noRerank: body.noRerank,
+      noGraph: body.noGraph,
       tagsAll,
       tagsAny,
       since: body.since,